VSCode配置非pip安装Python模块后自动补全失效问题求助

核心问题原因 #

导入模块不报错是因为运行时Python路径已包含对应目录，但VSCode Python静态分析引擎默认未开启C扩展模块的类型扫描，且你当前的路径配置存在冗余冲突。

缺失的配置项 #

在用户settings.json中补充以下配置：

// 固定使用Pylance作为语言分析引擎
"python.languageServer": "Pylance",
// 开启自动搜索路径
"python.analysis.autoSearchPaths": true,
// 允许使用库代码做类型推断（C扩展模块补全必开）
"python.analysis.useLibraryCodeForTypes": true,
// 精简extraPaths配置，不需要逐个加Mod下的子目录
"python.analysis.extraPaths": [
    "/home/mac/freecad-build",
    "/home/mac/freecad-build/lib",
    "/home/mac/freecad-build/Mod"
],
"python.autoComplete.extraPaths": [
    "/home/mac/freecad-build",
    "/home/mac/freecad-build/lib",
    "/home/mac/freecad-build/Mod"
]

生效操作 #

1. 保存配置后按Ctrl+Shift+P唤出命令面板，选择「开发人员：重新加载窗口」
2. 等待VSCode左下角的Python模块索引进度完成后，再测试Part.的自动补全

可选兜底方案 #

如果上述配置仍不生效，可手动为FreeCAD模块生成类型存根文件：

1. 安装mypy：pip install mypy
2. 为对应模块生成存根，以Part模块为例：

stubgen -p Part -o /home/mac/freecad-build/Mod/Part

生成的__init__.pyi存根文件会被Pylance优先识别，补全即可100%生效。

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