module 'cv2' has no attribute 'HoughlinesP'

### OpenCV 中 `HoughLinesP` 属性调用错误分析

当遇到 `AttributeError: module 'cv2' has no attribute 'HoughLinesP'` 错误时，通常是因为 OpenCV 安装存在问题或版本不兼容。

#### 可能原因及解决方案

1. **OpenCV 版本冲突**
如果系统中存在多个不同版本的 OpenCV 库，则可能导致此类属性找不到的情况。建议先清理环境中的旧版库文件再重新安装最新稳定版[^1]。

2. **拼写错误**
注意到错误提示提到的是 `'HoughlinesP'` 而不是标准形式 `'HoughLinesP'`（注意大小写的区别）。Python 是区分大小写的编程语言，在调用 API 函数名时应严格遵循官方文档定义的形式[^4]。

3. **缺少必要的组件**
对于某些高级功能模块如视频跟踪器创建接口等可能依赖额外贡献包(`opencv-contrib-python`)的支持。虽然目前看来这个问题并不适用于 `HoughLinesP` 方法本身，但如果确实是从 contrib 扩展部分引入的功能则需确认已正确安装相应扩展包[^2]。

4. **安装源问题**
使用国内镜像站点加速下载可能会导致获取不到完整的软件分发包从而引发上述异常现象。可以尝试切换至 PyPI 默认仓库或其他可靠第三方镜像来执行更新操作。

import cv2

# 示例代码片段展示如何正确使用 HoughLinesP 函数
def detect_lines(image_path):
    img = cv2.imread(image_path, 0)
    edges = cv2.Canny(img, 50, 150)

    lines = cv2.HoughLinesP(edges, rho=1, theta=np.pi / 180, threshold=100,
                            minLineLength=100, maxLineGap=10)

    if lines is not None:
        for line in lines:
            x1, y1, x2, y2 = line[0]
            cv2.line(img, (x1, y1), (x2, y2), (0, 255, 0), 2)

    return img


if __name__ == "__main__":
    result_image = detect_lines('example.jpg')
    cv2.imshow("Detected Lines", result_image)
    cv2.waitKey(0)
    cv2.destroyAllWindows()