装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免费学习笔记（深入）”；
- 确保
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"]，点“运行测试”就静默失败。别等跑完才翻终端。
