首先安装vscode的python、Pylance等扩展,然后配置Python解释器路径,启用Pylance语言服务器,设置Black格式化和isort导入排序,最后配置launch.json实现调试功能,完成专业级开发环境搭建。

Python 开发环境配置是使用 VSCode 高效编写 Python 代码的关键一步。正确设置后,你可以获得智能提示、语法检查、调试支持和代码格式化等功能。
安装必要的扩展
打开 VSCode,进入扩展市场(快捷键 Ctrl+Shift+X),搜索并安装以下核心扩展:
- Python(由 microsoft 提供)——提供语言支持、调试器、虚拟环境识别、测试探索器等
- Pylance——增强型语言服务器,提升补全、类型检查和跳转定义的速度与准确性
- Python Docstring Generator——自动生成符合规范的文档字符串
- Black Formatter 或 autopep8——用于自动格式化代码以符合 PEP8 规范
- isort——自动整理 import 语句顺序
配置解释器路径
确保 VSCode 使用正确的 Python 解释器:
- 按下 Ctrl+Shift+P 打开命令面板
- 输入 Python: select Interpreter
- 从列表中选择你希望使用的 Python 版本(如系统 Python、venv、conda 环境等)
如果你使用虚拟环境(推荐),确保该环境已激活且解释器路径指向 venv/bin/python(linux/macOS)或 venvScriptspython.exe(windows)。
启用 Pylance 并配置语言服务器
在设置中启用 Pylance 作为默认语言服务器:
- 打开设置(Ctrl+,)
- 搜索 python language server
- 确认已选择 Pylance(通常安装后会自动启用)
你也可以在 settings.json 中手动添加:
"python.languageServer": "Pylance"
配置代码格式化工具(如 Black)
让代码风格保持一致:
立即学习“Python免费学习笔记(深入)”;
- 安装 black:
pip install black - 在 VSCode 设置中启用保存时自动格式化
- 在
settings.json中添加:
"editor.formatOnSave": true, "python.formatting.provider": "black"
也可选择 autopep8 或 yapf,但 Black 因其“无需配置”特性更受欢迎。
启用 isort 自动整理导入
- 安装 isort:
pip install isort - 在设置中配置:
"python.sortImports.path": "isort", "editor.codeActionsOnSave": { "source.organizeImports": true }
这样每次保存文件时,import 语句都会被自动排序整理。
调试配置
VSCode 内置强大调试功能:
- 点击侧边栏“运行和调试”图标
- 创建
.vscode/launch.json - 添加一个 Python 启动配置,例如:
{ "name": "Python: 当前文件", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" }
之后即可设断点、逐行调试、查看变量值。 基本上就这些。配置完成后,你的 VSCode 就具备了专业级 Python 开发能力。


