VSCode中Python第三方库无提示，主因是Pylance未启用或python.defaultInterpreter路径错误；需确认解释器正确、库已安装于该环境、包结构合规（含__init__.py）、类型存根（如types-requests）已安装。

Python语言服务器没启动或配置错 VSCode里第三方库没提示，大概率不是代码问题，而是python.defaultInterpreter指向的解释器没被语言服务器识别到，或者根本没启用Pylance。Pylance是当前最主流的Python语言支持扩展，它依赖解释器环境里的包信息生成补全和跳转。

• 确保已安装 Pylance 扩展（非 Python 官方扩展本身提供完整智能提示）
• 检查右下角状态栏是否显示了正确的 Python 解释器路径，点击它能重新选择；如果显示“Select interpreter”，说明还没选
• 在设置里搜 python.defaultInterpreterPath，确认值是类似 /usr/bin/python3 或 C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe 这种真实可执行路径，而不是空或错误路径
• 如果用虚拟环境，必须选中该环境下的 python 可执行文件，不是系统全局的

第三方库没装在当前解释器环境下 提示不出来，往往是因为你当前选中的 Python 解释器里压根没装那个库。比如你在终端用 pip install requests，但 VSCode 用的是另一个 venv，那 requests 就不会出现在提示列表里。

• 在 VSCode 内置终端（Ctrl+`）里运行 which python（macOS/Linux）或 where python（Windows），确认和右下角显示的一致
• 然后运行 python -m pip list | grep requests（Linux/macOS）或 python -m pip list | findstr requests（Windows），看有没有输出
• 如果没装，直接在同一个终端里运行 python -m pip install requests，别用系统 pip
• 注意：不要在 VSCode 外部终端用 pip install 后就以为完事——得确保 pip 和 python 是同一套环境

__init__.py 缺失或包结构不被识别 有些第三方库（尤其是自己写的或从 Git 直接 clone 的）如果缺少 __init__.py，或者目录没被当成源码根目录，Pylance 就无法索引模块。

• 检查库所在目录是否包含 <strong>init</strong>.py（哪怕为空文件），特别是子模块层级
• 如果库是本地开发中的包，建议在 VSCode 工作区根目录下添加 pyproject.toml 或 setup.py，并确保它被 Pylance 识别为可导入源
• 可临时加一条 "python.extraPaths" 配置，把库路径加进去，例如：["./my_local_package"]，写在工作区 .vscode/settings.json 里
• 不推荐长期用 extraPaths，容易污染提示范围，优先走标准安装（pip install -e .）

类型存根缺失导致提示不全 像 requests、numpy 这些老牌库本身没带类型注解，Pylance 要靠社区维护的 types-xxx 包来补全。没有它们，参数名、返回值类型、方法签名都会变弱甚至消失。

• 运行 python -m pip install types-requests types-urllib3（按需补充，常见有 types-requests、types-PyYAML、types-click）
• 查看 types-* 包是否与目标库版本匹配，比如 requests==2.31.0 应配 types-requests>=2.31.0.0，不匹配可能导致提示错乱或报红
• 如果用了 pyright 替代 Pylance，行为类似，但配置项名不同，注意别混用

Pylance 的提示质量高度依赖环境一致性，而不是编辑器设置本身。很多人调了一堆 python.analysis.* 参数却忽略了解释器和包的实际归属，结果越调越模糊。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载