VSCode中如何消除Pylance提示的cv2模块成员未知的检查错误？

环境信息 #

• OS: WSL 2 Ubuntu 20.04.6 LTS
• VSCode版本: 1.85.2
• Pylance版本: v2023.12.1
• Python版本: 3.10.13
• opencv-python版本: 4.6.0.66

当前settings.json配置 #

{
    "terminal.integrated.defaultProfile.windows": "Ubuntu (WSL)",
    "workbench.colorTheme": "Monokai Pro",
    "editor.mouseWheelZoom": true,
    "python.analysis.autoImportCompletions": true,
    "flake8.args":[
        "--ignore=W293,W292,W291",
    ],
    "pylint.args":[
        "--extension-pkg-whitelist=cv2",
        "--generated-members=numpy.*, torch.*, cv2.*,  cv.*",
        "--disable=C0114,C0115,C0116"
    ],
    "python.analysis.typeCheckingMode": "basic",  // Pylance
    "python.analysis.fixAll": [],
    "editor.fontSize": 16,
    "workbench.preferredDarkColorTheme": "Monokai",
    "workbench.preferredHighContrastColorTheme": "Monokai",
    "files.autoSave": "afterDelay",
    "[python]": {
        "editor.formatOnType": true,
        "editor.defaultFormatter": "ms-python.autopep8"
    },
    "editor.rulers": [
        79
    ],
    "git.ignoreLimitWarning": true,
    "remote.SSH.remotePlatform": {
        "192.168.60.229": "linux",
        "192.168.60.230": "linux"
    },
    "githubPullRequests.pullBranch": "never",
    "vim.useCtrlKeys": false,
    "workbench.tree.indent": 4,
    "workbench.iconTheme": "vscode-icons",
    "isort.check": true,
    "window.zoomLevel": -1,
    "remote.autoForwardPortsSource": "hybrid",
    "workbench.editorAssociations": {
        "*.md": "default"
    },
    "markdown-preview-enhanced.previewTheme": "atom-dark.css",
    "git.openRepositoryInParentFolders": "never"
}

问题描述 #

已安装Pylance、pylint和flake8扩展，并在配置中添加了cv2相关设置，但仍出现检查错误提示：'cvtColor' is not a known member of module 'cv2'

解决方法 #

针对Pylance的调整 #

该错误主要由Pylance的类型检查机制导致，可通过以下方式修复：

1. 指定opencv-python的安装路径：
   在终端执行pip show opencv-python获取Location字段，将该路径下的cv2目录添加到python.analysis.extraPaths中，示例：

   "python.analysis.extraPaths": [
       "/home/your_username/.local/lib/python3.10/site-packages/cv2"
   ]
   

2. 忽略未知成员类型错误：
   若不想降低类型检查级别，可添加规则忽略cv2相关的未知成员错误：

   "python.analysis.ignore": [
       "reportUnknownMemberType"
   ]
   

3. 临时调整类型检查模式：
   可将python.analysis.typeCheckingMode改为off（不推荐长期使用，会丢失类型检查的优势）

针对Pylint的验证 #

虽然错误提示更偏向Pylance，但可确认Pylint配置是否正确：

1. 修正--generated-members中的多余空格，将cv2.*, cv.*改为cv2.*, cv.*
2. 可尝试将--extension-pkg-whitelist=cv2替换为--unsafe-load-any-extension=y，强制加载cv2扩展模块

通用排查步骤 #

• 重启VSCode，确保配置修改生效
• 确认左下角状态栏显示的Python解释器为安装了opencv-python的3.10.13环境
• 执行命令面板中的Python: Clear Cache and Reload Window，清除缓存并重新加载窗口

内容的提问来源于stack exchange，提问作者Weber Huang