VS Code 成为顺手的 Python 开发环境需装对扩展、设好解释器、配好运行调试逻辑并个性化调整：安装 Python、Pylance、Python Docstring Generator 等关键扩展；手动选择正确解释器路径；配置 launch.json 实现一键运行与断点调试；通过 settings.json 启用自动格式化、实时 linting 并优化编辑体验。
要让 VS Code 成为顺手的 Python 开发环境，核心是装对扩展、设好解释器、配好运行和调试逻辑，再加一点个性化调整。不复杂，但容易忽略细节。
安装关键扩展
只装这几个就够了，避免冗余干扰：
- Python（官方扩展，必装，提供语法高亮、智能补全、Pylint/Flake8 集成、调试支持）
- Pylance（微软出品，增强类型推断和快速跳转，比默认语言服务器更准更快）
- Python Docstring Generator（按 Ctrl+Shift+2 自动生成 Google/NumPy 风格 docstring）
- 可选：Code Runner（适合快速执行单文件脚本，但正式项目建议用终端或调试器）
正确配置 Python 解释器
VS Code 不会自动识别你系统里的 Python，必须手动指定，否则补全、调试、包导入都会出问题：
- 按下 Ctrl+Shift+P，输入 Python: Select Interpreter
- 从列表中选你实际用的环境：虚拟环境（如
./venv或./.venv）、conda 环境，或系统 Python - 确认右下角状态栏显示了正确的路径（例如
./venv/bin/python或python3.11） - 如果没列出你的环境，先在终端激活它，再重试；或点击“Enter path”手动指定
python可执行文件位置
设置运行与调试体验
别总靠终端敲 python xxx.py，VS Code 可以一键运行和断点调试：
立即学习“Python免费学习笔记（深入）”；
- 打开 Python 文件，点右上角 ▶️ 按钮（或 Ctrl+F5），它会自动创建
.vscode/launch.json并配置默认调试器 - 推荐在
launch.json中加这两项，提升实用性： -
"console": "integratedTerminal"—— 输出直接显示在 VS Code 内置终端，方便交互 -
"justMyCode": true—— 调试时跳过标准库和第三方包，专注自己的代码 - 想运行带参数的脚本？在
launch.json里加"args": ["--verbose", "config.yaml"]
优化编辑体验的小细节
让写代码更顺，不是靠花哨功能，而是减少打断：
- 在
settings.json里加这几行： -
"python.defaultInterpreterPath": "./venv/bin/python"（避免每次打开都重新选） -
"editor.formatOnSave": true+"python.formatting.provider": "black"（保存即格式化，需提前pip install black） -
"python.linting.enabled": true+"python.linting.pylintEnabled": true（实时报错提示，需pip install pylint） - 禁用不必要的自动补全干扰：关掉
"editor.suggest.showWords": false，防止从文档里捞出无关词 - 用 Ctrl+Click 跳转定义，Alt+Click 多光标编辑，效率翻倍
基本上就这些。不需要堆插件，也不用改几十项设置。关键是解释器选对、调试能跑、代码格式干净、错误看得见——其他都是锦上添花。
