必须同时安装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() 这类调用永远不出提示。
- 按
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 占用飙升，补全响应变秒级。
立即学习“Python免费学习笔记（深入）”；
- 在设置中搜索
autoSearchPaths，设为false - 紧接着配
python.analysis.extraPaths，只写你真正在写的模块路径，如["src", "tests"]（注意：必须是工作区根目录下的相对路径，不能带./） - 大型项目建议直接建
pyrightconfig.json，用"include"显式声明分析范围，比 settings.json 更可靠
最容易被忽略的是：Pylance 首次索引需要时间，str. 后等 1–2 秒才出提示属正常；但如果你改了 extraPaths 或增删了包，得手动执行命令面板里的 Developer: Restart Language Server，否则改动不生效。
