VS Code写Python的底线配置是Python、Pylance和Python Test Explorer三插件:仅装Python插件会导致类型推导缺失、跳转失败、测试无法识别;Pylance需启用并配置解释器路径,Test Explorer需配合pytest.ini等配置文件才能正常扫描运行测试。

VS Code 要能写 Python,只装一个 Python 插件就够跑起来,但想少踩坑、不卡壳、调试不抓瞎,必须补上 Pylance 和 Python Test Explorer —— 这三个是真实开发中每天都会用到的底线配置。
为什么只装 Python 插件会卡在“找不到模块”或“跳转失败”
微软官方的 Python 插件本身不带类型推导引擎,它依赖外部语言服务器。没装 Pylance 时,import numpy 后按 Ctrl+点击进不去源码,df.head() 没提示,甚至 print(type(x)) 的类型都标红报错。这不是代码问题,是语言服务没就位。
实操建议:
- 先装
Python(必须),再装Pylance(强烈推荐),两者安装顺序无所谓,但Pylance必须启用才能激活语义补全 - 如果已装
Python却没提示,检查右下角状态栏是否显示 “Pylance” —— 不显示就说明没生效,重启 VS Code 或手动启用插件 - Windows 用户若用 conda 环境,
Pylance默认可能读不到site-packages,需在设置里加一行:"python.defaultInterpreterPath": "./env/python.exe"
Python Test Explorer 解决“写完单元测试却不会运行”的问题
新手常以为写个 test_xxx.py 文件,右键“Run Test”就能跑通,结果弹出 “No test framework detected”。这是因为 VS Code 默认不识别 pytest/unittest 目录结构和配置,需要插件显式支持。
立即学习“Python免费学习笔记(深入)”;
实操建议:
- 装完
Python Test Explorer后,必须在项目根目录放一个pytest.ini或pyproject.toml(哪怕内容为空),否则插件扫描不到测试文件 - 如果测试文件在
tests/子目录下,需在设置里指定:"python.testing.pytestArgs": ["tests"] - 不要同时启用
unittest和pytest两个框架,冲突会导致测试面板空白
中文界面、格式化、Git 集成这些要不要装
它们不是 Python 运行的必要条件,但直接影响日常效率:
-
Chinese (Simplified):纯个人偏好,不影响任何功能,装了重启即生效 -
autopep8或black:格式化工具,建议二选一,避免和 VS Code 内置的python.formatting.provider冲突;例如选black就得配:"python.formatting.provider": "black" -
GitLens:不是必须,但看 commit 历史、比对修改行时比原生 Git 面板直观太多,尤其多人协作时
真正容易被忽略的是:所有插件安装后,**必须重启 VS Code 或重载窗口(Ctrl+Shift+P → “Developer: Reload Window”)**,否则部分插件(尤其是 Pylance)的语法高亮和跳转会延迟几分钟才加载,新手常误以为“装了没用”。


















