首页 > 脚本专栏 > python > VS Code配置Python开发环境

在VS Code中配置Python开发环境全攻略

2026-08-20 09:28:10 作者：看风起长林

VS Code本身是一个轻量级的代码编辑器,但通过丰富的插件系统,它能变成几乎任何编程语言的IDE,在Python开发领域,VS Code是PyCharm最强劲的竞争对手,所以本文给大家介绍了在VS Code中配置Python开发环境全攻略,需要的朋友可以参考下

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

今天要介绍的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开发环境的资料请关注脚本之家其它相关文章！