装8个插件需按序配置:先设python.defaultinterpreterpath指定venv/conda路径,再启用pylance类型检查,ruff格式化需关闭format子功能,turbo console log一键打印变量,python test explorer须配pytest参数。

装这8个插件,Python新手开箱即写、调试、跑测试、查文档全链路不卡壳——但必须按顺序配,否则python.defaultInterpreterPath错位、Pylance类型提示失效、Ruff格式化被黑覆盖,全是隐形坑。
怎么让VS Code自动认出你的venv或conda环境
VS Code不会“猜”你用哪个Python解释器,它只看python.defaultInterpreterPath配置。不手动指定,它可能默认用系统Python,导致import torch报错、pip list看不到你装的包。
- 打开命令面板(
Ctrl+Shift+P),输入Python: Select Interpreter,选中你虚拟环境里的python可执行文件(如./venv/bin/python或~/miniconda3/envs/myenv/bin/python) - 确认后检查状态栏右下角是否显示对应路径;没显示?说明没生效,重开窗口再试
- 如果团队协作,把解释器路径写进项目根目录的
.vscode/settings.json里:"python.defaultInterpreterPath": "./venv/bin/python"
避免每人手动选
为什么Pylance比Python插件自带语言服务更准
官方Python插件默认启用Pylance,但它能独立配置——关掉它,typing.List[str]推断就变弱,pd.DataFrame点不出列名,第三方库签名基本“失明”。
- 在设置里搜
python.typeChecking.enabled,勾选开启严格类型检查 - 配合
pyrightconfig.json或pyproject.toml加[tool.pyright]段,可指定include路径和stubPath提升numpy/torch等库支持 - 禁用
python.languageServer设为Pylance(不是Default),否则可能回退到旧版分析器
Ruff格式化一保存就乱套?三个关键开关要对齐
Ruff快是真快,但和Black风格冲突时,editor.formatOnSave会把你刚写的空行、括号换行全抹掉,尤其当你习惯PEP 8宽松约定时。
- 确保
python.formatting.provider设为ruff,而不是black或autopep8 - 在
pyproject.toml里明确关闭Ruff的格式化子功能:[tool.ruff] format = false
——别信“Ruff能兼顾lint+format”,它俩开关是分开的 - 想保留空行或引号风格?加
[tool.ruff.format]段,设quote-style = "double"或skip-magic-trailing-comma = true
调试时print满天飞?Turbo Console Log怎么不污染代码
手敲print(f"var={var}")容易漏删、拼错变量名,而Turbo Console Log一键插入后,删起来也得手动——除非你配对了快捷键。
- 选中变量名(比如
df),按Ctrl+Alt+L(Windows)→ 自动生成print("df:", df) - 想批量清除?用
Ctrl+Shift+P→Turbo Console Log: Remove all console logs - 注意:它不识别f-string或表达式(如
len(lst)),只对纯变量名可靠;复杂表达式建议用Debug Console直接求值
最常被跳过的其实是Python Test Explorer的配置:不装pytest或没在settings.json里写"python.testing.pytestArgs": ["--tb=short"],点“运行测试”就静默失败。别等跑完才翻终端。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











