我要评论一、开篇：轻量级但强大到离谱的编辑器
今天要介绍的vs code（visual studio code），走的是一条完全不同的路线。
vs code本身是一个轻量级的代码编辑器，但通过丰富的插件系统，它能变成几乎任何编程语言的ide。在python开发领域，vs code是pycharm最强劲的竞争对手。
它有什么优势？免费开源、启动飞快、插件丰富、一个月不关也不卡。如果你需要在python、javascript、go、rust等多种语言间切换，或者电脑配置不是特别高，vs code会是绝佳选择。
二、vs code和pycharm对比
在安装之前，我们先搞清楚两个工具各自的定位：
| 维度 | vs code | pycharm |
|---|---|---|
| 定位 | 代码编辑器（通过插件变ide） | 专业ide |
| 价格 | 完全免费 | 社区版免费/专业版收费 |
| 启动速度 | 快（2-3秒） | 较慢（10-30秒） |
| 内存占用 | 较低（200-500mb） | 较高（500mb-1.5gb） |
| python支持 | 通过插件，好 | 内置深度支持，最好 |
| 多语言支持 | 极强（插件生态） | 专注python |
| git集成 | 很好 | 极好 |
| 数据库工具 | 需单独插件 | 专业版内置 |
| 重构能力 | 一般 | 强 |
我的建议：
- 纯python开发、追求开箱即用 → pycharm
- 多语言开发、电脑配置不高 → vs code
- 两个都装也行，它们不冲突。很多开发者是pycharm做主力，vs code做辅助
三、下载安装vs code
3.1 官方下载
唯一下载地址：https://code.visualstudio.com/
网站会自动匹配你的操作系统。点击那个大大的蓝色下载按钮就行。
文件大小约80-100mb，比pycharm轻多了。
3.2 windows安装
① 双击exe文件，一路next。
② 在"选择附加任务"页面，有几个选项建议勾选：
☑ 将"通过code打开"操作添加到windows资源管理器文件上下文菜单 ☑ 将"通过code打开"操作添加到windows资源管理器目录上下文菜单 ☑ 将code注册为受支持的文件类型的编辑器 ☑ 添加到path（重启后生效）
勾上"添加到path"之后，你就能在命令行中使用 code 命令了。
③ 点击安装，完成后启动vs code。
3.3 mac安装
① 双击下载的 .zip 文件解压，得到 visual studio code.app
② 将它拖入"应用程序"文件夹
③ 双击启动
或者用homebrew：
brew install --cask visual-studio-code
3.4 安装中文语言包
vs code原生支持多语言。进入后：
① 按 ctrl + shift + p（mac：cmd + shift + p），打开命令面板
② 输入 display language
③ 选择 “configure display language”
④ 选择 “中文(简体)”
⑤ 点击"安装"并重启
或者直接在左侧活动栏点"扩展"图标（或按 ctrl + shift + x），搜索 chinese，安装 “chinese (simplified) language pack”。
四、配置python开发环境
4.1 安装python扩展
这是最关键的一步。vs code的python能力全靠扩展提供。
① 点击左侧活动栏的"扩展"图标（或按 ctrl + shift + x）
② 在搜索框中输入 python
③ 找到微软官方发布的python扩展（发布者是microsoft，安装量上亿的那个），点击"安装"
这个扩展实际上是一个扩展包，安装后自动包含：
- pylance：快速强大的python语言服务器（代码补全、类型检查）
- python debugger：python调试器
- python：核心python支持
等待安装完成（可能需要几十秒下载），安装好后左侧活动栏会多一个python图标。
4.2 选择python解释器
安装完python扩展后，你需要告诉vs code用哪个python：
① 按 ctrl + shift + p，输入 python: select interpreter
② 在列表中选择你已安装的python版本：
python 3.12.1 64-bit ('python312': pip) ← 系统python
python 3.12.1 64-bit ('myproject': venv) ← 虚拟环境中的python
python 3.11.7 64-bit ← 另一版本
③ 选择后，vs code会在当前工作区使用这个解释器。选择结果会保存到 .vscode/settings.json 中。
如果你有多个项目，每个项目可以独立选择不同的python解释器。
4.3 创建并运行python文件
① 打开一个文件夹作为工作区：文件 → 打开文件夹
② 在文件资源管理器中（左侧第一个图标），右键 → “新建文件” → 输入 hello.py
③ 写一段测试代码：
import sys
def greet(name):
print(f"你好，{name}！")
print(f"当前使用的python版本：{sys.version}")
print(f"python安装路径：{sys.executable}")
if __name__ == '__main__':
greet("vs code用户")④ 点击右上角的"运行"按钮▶（三角形），或按 ctrl + f5。
底部会弹出"终端"面板，显示运行结果。
当你在终端中看到"你好，vs code用户！"的输出，说明python环境在vs code中配置成功了。
4.4 运行按钮在哪里
vs code提供多种运行python脚本的方式：
| 方式 | 操作 |
|---|---|
| 运行按钮 | 编辑区右上角的▶按钮 |
| 右键运行 | 编辑区右键 → “在终端中运行python文件” |
| 快捷键 | ctrl + f5（运行）或 f5（调试运行） |
| 选中执行 | 选中代码 → 右键 → “在python终端中运行选定内容” |
"在python终端中运行选定内容"是一个非常棒的功能——你可以只运行选中的几行代码，而不需要运行整个文件。这在调试和实验代码时特别有用。
五、必装的python辅助扩展
除了微软官方的python扩展包，以下扩展能让你的开发体验更上一层楼：
5.1 autopep8 - 自动格式化
安装 autopep8 扩展，它根据pep 8（python官方代码风格指南）自动格式化你的代码。
先通过pip安装autopep8工具：
pip install autopep8
然后在vs code的扩展市场搜索并安装 autopep8，或者直接在vs code设置中指定格式化工具：
文件 → 首选项 → 设置，搜索 python formatting，设置：
python > formatting: provider → autopep8
配置好后，右键 → “格式化文档”（或 shift + alt + f）即可自动格式化当前文件。
5.2 black - 更严格的格式化器
black号称"不妥协的代码格式化器"——它不给用户提供格式化选项，所有人都用统一的格式。如果你不想纠结于格式细节，black是最省心的选择。
pip install black
在vs code中搜索并安装 black formatter 扩展，然后设置为默认格式化器。
5.3 isort - 导入排序
自动整理导入语句的顺序（标准库→第三方库→本地模块）：
pip install isort
在vs code设置中搜索 isort 并启用。
5.4 flake8 / pylint - 代码检查
安装一个代码检查工具，帮你找出潜在的bug和风格问题：
pip install flake8 # 或者 pip install pylint
vs code的python扩展会自动检测并启用它们。代码中的问题会在编辑区以波浪线标出。
5.5 jupyter扩展
如果你想在vs code中运行jupyter notebook（.ipynb文件），需要安装jupyter扩展：
搜索并安装 jupyter（发布者microsoft）。
安装后，你可以直接在vs code中创建、编辑和运行 .ipynb 文件，体验比网页版jupyter还要好。
5.6 thunder client - api测试工具
如果你做web开发或爬虫，经常需要测试http接口。thunder client是vs code内置的轻量级api测试工具，类似postman，但完全在vs code内运行，非常方便。
六、vs code的核心python设置
6.1 settings.json配置
按 ctrl + shift + p，输入 open user settings (json)，打开用户级配置文件：
{
// ========== python专属设置 ==========
// 默认的python解释器路径
"python.defaultinterpreterpath": "d:\\python312\\python.exe",
// 格式化设置
"editor.formatonsave": true, // 保存时自动格式化
"editor.formatonpaste": false,
"[python]": {
"editor.formatonsave": true,
"editor.defaultformatter": "ms-python.autopep8",
"editor.tabsize": 4, // python用4空格缩进
"editor.insertspaces": true, // tab转为空格
"editor.rulers": [79, 100] // 参考行宽线
},
// python特定设置
"python.languageserver": "pylance",
"python.analysis.typecheckingmode": "basic", // 类型检查级别
"python.analysis.autoimportcompletions": true, // 自动导入补全
"python.terminal.activateenvironment": true, // 终端自动激活虚拟环境
// ========== 通用编辑器设置 ==========
"editor.fontsize": 14,
"editor.fontfamily": "'cascadia code', 'jetbrains mono', consolas, monospace",
"editor.fontligatures": true, // 连字效果(→变成箭头等)
"editor.renderwhitespace": "boundary", // 显示空格边界
"editor.minimap.enabled": true, // 代码缩略图
"editor.bracketpaircolorization.enabled": true, // 彩色括号匹配
"editor.guides.bracketpairs": true, // 括号对参考线
// 文件设置
"files.autosave": "afterdelay", // 自动保存
"files.autosavedelay": 1000, // 1秒后自动保存
"files.exclude": {
"**/__pycache__": true,
"**/*.pyc": true,
"**/.pytest_cache": true,
"**/.mypy_cache": true
},
// 终端设置
"terminal.integrated.defaultprofile.windows": "powershell",
"terminal.integrated.fontsize": 13
}6.2 工作区设置 vs 用户设置
- 用户设置（user settings）：对所有vs code窗口生效，存于
%appdata%\code\user\settings.json - 工作区设置（workspace settings）：只对当前打开的项目文件夹生效，存于
.vscode/settings.json
建议把通用设置放在用户设置中，把项目特有的设置（如python解释器路径、特定格式化规则）放在工作区设置中。
七、调试器配置
7.1 什么是调试器
调试器是你写代码时最强大的排错工具。它可以让你在代码的任意位置"暂停"，查看当时所有变量的值，然后一行一行地逐步执行代码，观察数据如何变化。
vs code内置了强大的python调试器，配置简单。
7.2 快速调试
最简单的调试方式：
① 在编辑区点击代码行号左边，会出现一个红点（断点breakpoint）：
name = "小明"
age = 25
# ↓ 在这行设置断点（点击行号左侧）
greeting = f"{name}今年{age}岁" # ← 红点
print(greeting)
② 按 f5（而不是 ctrl + f5），启动调试模式。
③ 程序会运行到断点处暂停。此时你可以：
- 查看左侧面板中所有变量的当前值
- 把鼠标悬停在代码中的变量上，查看其值
- 按
f10单步执行（执行当前行，跳到下一行） - 按
f11进入函数内部调试 - 按
f5继续运行到下一个断点
7.3 launch.json配置
对于复杂项目，你可能需要一个调试配置文件。在左侧活动栏点击"运行和调试"图标（或按 ctrl + shift + d），点击"创建launch.json文件"，选择"python"。
{
"version": "0.2.0",
"configurations": [
{
"name": "python: 当前文件",
"type": "debugpy",
"request": "launch",
"program": "${file}",
"console": "integratedterminal",
"justmycode": true
},
{
"name": "python: main.py",
"type": "debugpy",
"request": "launch",
"program": "${workspacefolder}/main.py",
"console": "integratedterminal",
"args": ["--verbose"],
"env": {
"debug": "true"
}
},
{
"name": "python: flask应用",
"type": "debugpy",
"request": "launch",
"module": "flask",
"env": {
"flask_app": "app.py",
"flask_env": "development"
},
"args": ["run", "--no-debugger", "--no-reload"],
"jinja": true
}
]
}配置好之后，你就可以在"运行和调试"面板中从下拉菜单选择不同的调试配置来启动特定场景的调试。
7.4 调试快捷键速查
| 操作 | 快捷键 | 说明 |
|---|---|---|
| 启动调试 | f5 | 开始调试 |
| 停止调试 | shift + f5 | 终止调试 |
| 单步跳过 | f10 | 执行当前行，不进入函数内部 |
| 单步进入 | f11 | 进入函数内部逐行执行 |
| 单步跳出 | shift + f11 | 跳出当前函数 |
| 继续 | f5 | 继续运行到下一个断点 |
| 切换断点 | f9 | 在当前行设置/取消断点 |
八、vs code集成终端
8.1 终端的基本使用
vs code底部面板中自带一个完整的终端。按 ctrl + ` （反引号键，tab上面那个键）可以快速切换终端面板的显示/隐藏。
# 终端中可以直接运行python python hello.py # 安装包 pip install requests # 创建虚拟环境 python -m venv venv # git操作 git status git commit -m "update"
💡 这个终端在windows上默认使用powershell，在mac/linux上使用系统默认shell。它和你在vs code外面打开的终端完全一样，但优势在于你不必离开编辑器就能操作命令行。
8.2 多终端管理
vs code支持同时打开多个终端标签页：
- 点击终端面板右上角的"+"创建新终端
- 点击终端标签切换到不同终端
- 点击垃圾桶图标关闭终端
一个常见的用法：一个终端跑程序，另一个终端操作git和安装包。
九、git集成
9.1 源代码管理
vs code内置了git图形化界面。点击左侧活动栏的"源代码管理"图标（或按 ctrl + shift + g）。
- 修改过的文件会出现在"更改"列表中
- 点击文件可以查看前后对比（diff视图）
- 输入提交信息后，点击"✓"即可提交
- 点击"…"可以进行推送、拉取等操作
9.2 可视化的diff视图
这是vs code的一大亮点。当你修改了一个文件，vs code会在编辑区左侧的装订线显示：
- 绿色条：新增的代码
- 蓝色条：修改的代码
- 红色三角：删除的代码
点击装订线上的颜色条，可以看到内联的对比视图，非常直观。
十、本篇小结
✅ vs code经过适当的插件配置，完全能成为一流的python开发环境。核心步骤回顾：
- 下载安装vs code：免费轻量，80mb搞定
- 安装python扩展：微软官方出品，必装
- 选择python解释器：
ctrl+shift+p→ python: select interpreter - 必装辅助扩展：autopep8/black、isort、flake8、jupyter
- 配置settings.json：自动格式化、类型检查、文件排除
- 学会调试：
f5启动调试，f10单步执行 - 善用终端：
ctrl + `打开终端面板
vs code和pycharm没有绝对的好坏之分。选一个你看着顺眼的，把它用熟，就足够了。工具永远为效率服务，不要陷入"哪个更好"的无休止争论。
以上就是在vs code中配置python开发环境全攻略的详细内容，更多关于vs code配置python开发环境的资料请关注代码网其它相关文章！
发表评论