Python入门：VS Code配置Python开发环境全攻略

Python入门：VS Code配置Python开发环境全攻略

一、开篇：轻量级但强大到离谱的编辑器

上一篇文章我们讲了PyCharm，它是Python开发的"重型武器"——功能全面但比较吃资源。今天要介绍的VS Code（Visual Studio Code），走的是一条完全不同的路线。

🔧 VS Code本身是一个轻量级的代码编辑器，但通过丰富的插件系统，它能变成几乎任何编程语言的IDE。在Python开发领域，VS Code是PyCharm最强劲的竞争对手。

它有什么优势？免费开源、启动飞快、插件丰富、一个月不关也不卡。如果你需要在Python、JavaScript、Go、Rust等多种语言间切换，或者电脑配置不是特别高，VS Code会是绝佳选择。

二、VS Code和PyCharm对比

在安装之前，我们先搞清楚两个工具各自的定位：

💡 我的建议：

• 纯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：

brewinstall--caskvisual-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

③ 写一段测试代码：

importsysdefgreet(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终端中运行选定内容"是一个非常棒的功能——你可以只运行选中的几行代码，而不需要运行整个文件。这在调试和实验代码时特别有用。

五、必装的Python辅助扩展

除了微软官方的Python扩展包，以下扩展能让你的开发体验更上一层楼：

5.1 autopep8 - 自动格式化

安装autopep8扩展，它根据PEP 8（Python官方代码风格指南）自动格式化你的代码。

先通过pip安装autopep8工具：

pipinstallautopep8

然后在VS Code的扩展市场搜索并安装autopep8，或者直接在VS Code设置中指定格式化工具：

文件 → 首选项 → 设置，搜索python formatting，设置：

Python > Formatting: Provider → autopep8

配置好后，右键 → “格式化文档”（或Shift + Alt + F）即可自动格式化当前文件。

5.2 Black - 更严格的格式化器

Black号称"不妥协的代码格式化器"——它不给用户提供格式化选项，所有人都用统一的格式。如果你不想纠结于格式细节，Black是最省心的选择。

pipinstallblack

在VS Code中搜索并安装Black Formatter扩展，然后设置为默认格式化器。

5.3 isort - 导入排序

自动整理导入语句的顺序（标准库→第三方库→本地模块）：

pipinstallisort

在VS Code设置中搜索isort并启用。

5.4 flake8 / pylint - 代码检查

安装一个代码检查工具，帮你找出潜在的bug和风格问题：

pipinstallflake8# 或者pipinstallpylint

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 调试快捷键速查

八、VS Code集成终端

8.1 终端的基本使用

VS Code底部面板中自带一个完整的终端。按Ctrl + `（反引号键，Tab上面那个键）可以快速切换终端面板的显示/隐藏。

# 终端中可以直接运行Pythonpython hello.py# 安装包pipinstallrequests# 创建虚拟环境python-mvenv venv# Git操作gitstatusgitcommit-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开发环境。核心步骤回顾：

1. 下载安装VS Code：免费轻量，80MB搞定
2. 安装Python扩展：微软官方出品，必装
3. 选择Python解释器：Ctrl+Shift+P→ Python: Select Interpreter
4. 必装辅助扩展：autopep8/Black、isort、flake8、Jupyter
5. 配置settings.json：自动格式化、类型检查、文件排除
6. 学会调试：F5启动调试，F10单步执行
7. 善用终端：Ctrl + `打开终端面板

🔧 VS Code和PyCharm没有绝对的好坏之分。选一个你看着顺眼的，把它用熟，就足够了。工具永远为效率服务，不要陷入"哪个更好"的无休止争论。