必须同时安装Microsoft官方Python和Pylance扩展,正确配置解释器路径、关闭autoSearchPaths并设置extraPaths,重启语言服务器后补全才生效。

装对插件只是第一步,真正让补全“动起来”的关键在后续三步配置:解释器路径、语言服务器切换、排除干扰目录。只装不配,torch. 或 pd. 后大概率没提示。
必须同时安装 Python 和 Pylance 两个扩展
Pylance 不是独立插件,它依赖官方 Python 扩展才能加载。单独装 Python 插件时补全极弱,类型提示几乎为零;只装 Pylance 则根本不会启动。
- 打开扩展面板(
Ctrl+Shift+X),搜索Python,认准发布者是 Microsoft,安装 - 再搜
Pylance,同样选 Microsoft 官方版本,安装 - 卸载任何其他 Python 语言服务器插件(比如单独的
Pyright、旧版Python for VS Code),它们会静默抢占控制权
解释器路径选错 = 补全全失效
python.defaultInterpreterPath 指向哪,Pylance 就只读哪的 site-packages。指向系统 Python 或空虚拟环境,requests.get()、np.array() 这类调用永远不出提示。
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
- 按
Ctrl+Shift+P输入Python: Select Interpreter,从列表里选你项目实际用的环境(如./venv/bin/python或./.venv/Scripts/python.exe) - 确认该环境下已运行
pip install -r requirements.txt,否则 Pylance 看不见你依赖的包 - 设置里检查
python.defaultInterpreterPath的值——必须是绝对路径,不能写成./venv/bin/python
补全卡顿或延迟高?关掉 autoSearchPaths
默认开启的 python.analysis.autoSearchPaths 会让 Pylance 扫描整个父目录树,把 venv/、node_modules/、__pycache__/ 全塞进索引,CPU 占用飙升,补全响应变秒级。
- 在设置中搜索
autoSearchPaths,设为false - 紧接着配
python.analysis.extraPaths,只写你真正在写的模块路径,如["src", "tests"](注意:必须是工作区根目录下的相对路径,不能带./) - 大型项目建议直接建
pyrightconfig.json,用"include"显式声明分析范围,比 settings.json 更可靠
最容易被忽略的是:Pylance 首次索引需要时间,str. 后等 1–2 秒才出提示属正常;但如果你改了 extraPaths 或增删了包,得手动执行命令面板里的 Developer: Restart Language Server,否则改动不生效。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










