VSCode高效开发Python需四步：装Python官方扩展、Pylance等核心插件；手动指定解释器路径；配置launch.json实现一键调试；设置Black自动格式化与保存即整理import。
要让 VSCode 成为趁手的 Python 开发工具，关键不是装一堆插件，而是选对核心扩展、配好解释器、设好调试和格式化规则——这些一步到位，写代码、查错、跑脚本就顺了。
装对扩展：精简但够用
只留这几个真正影响体验的：
- Python 官方扩展（ms-python.python）：提供智能提示、语法检查、调试支持、Jupyter 集成，必装；
- Pylance（ms-python.vscode-pylance）：微软出品，比默认语言服务器快、准，类型推断强，推荐启用；
- Black Formatter 或 autopep8（二选一）：自动格式化代码，配合保存时自动格式化，省去手动调空格缩进的麻烦；
- GitLens（可选但实用）：看谁改了哪行、快速比对历史版本，团队协作或读开源项目时很省心。
指定 Python 解释器：别让 VSCode 自己猜
VSCode 不会自动识别你用的虚拟环境或 conda 环境，必须手动选：
- 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Python: Select Interpreter；
- 从列表里选你项目对应的解释器路径，比如
./venv/bin/python（Linux/macOS）或.\venv\Scripts\python.exe（Windows）； - 选完后，状态栏左下角会显示当前解释器路径，且
python -m pip list装的包就能被正确识别和补全。
调试配置：一个 launch.json 就搞定常见场景
在项目根目录建 .vscode/launch.json，贴入以下基础配置：
立即学习“Python免费学习笔记（深入）”；
从 Git 仓库历史中彻底删除文件
下载
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 当前文件",
"type": "python",
"request": "launch",
"module": "python",
"args": [],
"console": "integratedTerminal",
"justMyCode": true
}
]
}
这样按 F5 就能直接运行当前打开的 .py 文件。需要传参？往 "args" 里加字符串数组，比如 ["--input", "data.txt"]。
代码风格与保存即格式化
在 settings.json（用户或工作区）里加这几行：
"python.defaultInterpreterPath": "./venv/bin/python",
"python.formatting.provider": "black",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": true
}
保存时自动格式化 + 自动整理 import，代码干净、团队风格统一，还不打断思路。
基本上就这些。不复杂但容易忽略——解释器没选对，所有补全都失效；格式化没配好，每次都要手动敲 black；调试没设 launch.json，就只能靠 print 挨个试。把这四块理清楚，VSCode 写 Python 就真能“开箱即用”了。
