VSCode中Pylance无法对本地lib模块提供IntelliSense智能提示

优先尝试配置文件修正 #

之前用的python.autoComplete.extraPaths是旧配置项，现在VSCode Python插件更依赖python.analysis.extraPaths。直接在项目根目录的.vscode/settings.json（没有就新建）里添加：

{
    "python.analysis.extraPaths": [
        "${workspaceFolder}/lib"
    ],
    "python.pythonPath": "${workspaceFolder}/你的虚拟环境路径/python" // 替换成你实际使用的Python解释器路径
}

保存后重启VSCode或执行「Ctrl+Shift+P → 重新加载窗口」，让配置生效。

临时调试方案（代码内加路径） #

如果配置没立刻生效，可在markermaker.py开头添加代码临时补全路径：

import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent / "lib"))

这样编辑器和运行时都能识别lib下的模块，适合快速验证。

长效方案：把lib转为本地可编辑包 #

在lib文件夹下创建setup.py，内容如下：

from setuptools import setup, find_packages

setup(
    name="gw-lib",
    version="0.1",
    packages=find_packages()
)

然后在项目根目录执行命令：

pip install -e .

安装后VSCode会自动识别lib作为正规Python包，智能提示和文档跳转都能正常工作。

必做检查项 #

• 确认VSCode右下角状态栏选中的是项目对应的Python解释器（尤其是虚拟环境）
• 确保lib/__init__.py存在（可以是空文件），Python才会把lib识别为合法包

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