关键在于选对核心工具、配好关键设置:安装python官方扩展并禁用Jedi启用Pylance,配置launch.json启用justMyCode和PYTHONPATH,集成Pylint+Black+isort实现保存即格式化,统一终端环境并支持虚拟环境快速激活。

用 vscode 打造 Python 开发环境,关键不在装多少插件,而在于选对核心工具、配好关键设置、让编辑器真正懂你的代码。
装对扩展:精简但不可少
Python 官方扩展(microsoft 出品)是基础,它自带语言支持、调试器、jupyter 集成和 Pylance 智能补全。别急着装“Python Helper”“AutoDocstring Pro”这类花哨插件——先确保这一个稳定运行。如果用虚拟环境,再加装 Python Environment Manager,它能在状态栏快速切换解释器,比手动配置 python.defaultInterpreterPath 直观得多。
- 禁用默认的 Jedi 补全(在设置里关掉
python.jediEnabled),Pylance 更快更准 - 装了 Code Runner?记得在设置里关掉它的 Python 自动保存,避免和 Pylint/Black 冲突
- 写 Web 或数据项目?REST Client 和 SQLTools 比“万能Python插件包”实用十倍
配置好运行与调试:一次设好,长期省心
VSCode 的 .vscode/launch.json 不必手写。点调试面板右上角齿轮图标 → 选择 “Python File”,它会自动生成带 console: "integratedTerminal" 的模板。重点改两处:
- 加上
"justMyCode": true:调试时跳过库代码,不卡在 requests 或 pandas 里 - 设
"env": {"PYTHONPATH": "${workspaceFolder}"}:避免相对导入报错,尤其多模块项目 - 想直接按 F5 运行当前脚本?在
settings.json加上:"code-runner.runInTerminal": true和"code-runner.preserveFocus": false
代码质量不靠自觉:集成进编辑流程
把 linter、formatter、import 排序变成“保存即生效”,而不是靠人工检查。推荐组合:Pylint(查逻辑错误)+ Black(格式化)+ isort(整理 import)。不用改太多设置,只需三步:
立即学习“Python免费学习笔记(深入)”;
系统介绍 45°C 商城系统,以 Thinkphp5.0 + Uniapp + Layui2.9 + Vue 为技术基石,精心打造出的全新 MINI 商城应用。其功能覆盖全面,无论是 PC 商城、H5 商城,还是公众号商城、微信小程序以及抖音小程序的制作都能完美胜任。采用标准系统结合插件模式开发,用户能够极为便捷地定制专属的个性模块。整个系统,从程序设计到 UI 呈现,都秉持着一贯的小而美理念。程
0 - 终端里
pip install pylint black isort - 在 VSCode 设置里搜 “format on save”,打开它
- 搜 “python.formatting.provider”,选
black;搜 “python.sortImports.args”,填["--profile", "black"]
这样 Ctrl+S 之后,代码自动对齐、引号统一、import 分组排序——不是“看起来整洁”,而是团队协作时真的不会为缩进空格吵架。
终端和工作区:让命令行就在手边
别总切窗口跑命令。VSCode 内置终端默认用系统 shell,但 Python 项目建议固定用 bash(macOS/linux)或 pwsh(windows),避免 cmd 的编码和路径问题。在设置里搜 “terminal integrated default profile”,选对应项。
- 按 Ctrl+Shift+` 呼出终端,它自动 cd 到当前工作区根目录
- 想快速激活虚拟环境?在
.vscode/settings.json加一行:"terminal.integrated.profiles.windows": { "pwsh": { "args": ["-NoExit", "-Command", "& 'venvScriptsActivate.ps1'"] } }(Windows 示例,macOS 类似) - 多个文件夹项目?用
File > Add Folder to Workspace,保存为.code-workspace文件,下次双击就恢复全部配置和终端
基本上就这些。不需要插件满天飞,也不用背几十条快捷键。把解释器选对、保存自动格式、调试不跳库、终端随叫随到——Python 开发的流畅感,就从这几个小动作开始。