当前位置:知识文库 ❯ 图文

VSCode配置Python开发环境

概述

Visual Studio Code（简称VSCode）是微软开发的一款免费、开源的代码编辑器，凭借其轻量、快速、插件丰富等特点，已成为Python开发者最喜爱的编辑器之一。本教程将详细介绍VSCode的安装、Python扩展的配置、解释器设置、调试配置等内容，帮助你打造高效的Python开发环境。

VSCode安装

1. 下载VSCode

访问VSCode官网：https://code.visualstudio.com/

点击下载按钮，选择对应操作系统的安装包。

2. 安装VSCode

Windows

运行下载的安装程序
接受许可协议
选择安装路径
勾选以下选项：
- 创建桌面快捷方式
- 添加到PATH
- 将"通过Code打开"操作添加到文件上下文菜单
点击安装

macOS

打开下载的 .zip 文件
将Visual Studio Code拖拽到Applications文件夹
通过启动台打开VSCode

Linux

代码示例

sudo snap install code --classic

或通过包管理器安装：

代码示例

sudo apt install code

Python扩展安装

VSCode本身只是一个编辑器，通过安装扩展才能提供Python开发功能。

1. 打开扩展面板

使用快捷键打开扩展面板：

操作系统	快捷键
Windows / Linux	`Ctrl + Shift + X`
macOS	`Cmd + Shift + X`

2. 搜索并安装Python扩展

在搜索框中输入"Python"，安装由Microsoft发布的官方Python扩展。

3. 推荐安装的相关扩展

扩展名称	发布者	功能说明
Python	Microsoft	Python语言支持（必装）
Pylance	Microsoft	快速、功能丰富的语言服务器
Python Debugger	Microsoft	Python调试器
Python Indent	Kevin Rose	Python缩进辅助
autoDocstring	Nils Werner	自动生成文档字符串
Ruff	Astral	快速Python代码检查和格式化

配置Python解释器

方法一：通过命令面板

按 Ctrl + Shift + P（macOS: Cmd + Shift + P）打开命令面板
输入"Python: Select Interpreter"
从列表中选择已安装的Python解释器

方法二：通过状态栏

点击VSCode底部状态栏右侧的Python版本号
从弹出的列表中选择解释器

方法三：通过设置

在项目根目录创建 .vscode/settings.json 文件：

代码示例

{
    "python.defaultInterpreterPath": "C:\\Python312\\python.exe"
}

macOS/Linux示例：

代码示例

{
    "python.defaultInterpreterPath": "/usr/bin/python3"
}

常用配置项

通过 Ctrl + ,（macOS: Cmd + ,）打开设置界面，搜索以下配置项：

编辑器配置

代码示例

{
    "editor.fontSize": 14,
    "editor.tabSize": 4,
    "editor.insertSpaces": true,
    "editor.formatOnSave": true,
    "editor.minimap.enabled": false,
    "editor.wordWrap": "on"
}

Python专属配置

代码示例

{
    "python.languageServer": "Pylance",
    "python.analysis.typeCheckingMode": "basic",
    "python.analysis.autoImportCompletions": true,
    "python.formatting.provider": "none",
    "[python]": {
        "editor.formatOnSave": true,
        "editor.defaultFormatter": "charliermarsh.ruff",
        "editor.codeActionsOnSave": {
            "source.fixAll": "explicit",
            "source.organizeImports": "explicit"
        }
    }
}

调试配置

快速调试

打开Python文件
在代码行号左侧点击设置断点（红点）
按 F5 启动调试
选择"Python Debugger" → "Python File"

自定义调试配置

在项目根目录创建 .vscode/launch.json 文件：

代码示例

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        },
        {
            "name": "Python: Flask",
            "type": "debugpy",
            "request": "launch",
            "module": "flask",
            "env": {
                "FLASK_APP": "app.py",
                "FLASK_DEBUG": "1"
            },
            "args": [
                "run",
                "--no-debugger",
                "--no-reload"
            ],
            "jinja": true
        },
        {
            "name": "Python: Django",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": [
                "runserver"
            ],
            "django": true
        }
    ]
}

调试快捷键

快捷键	功能
`F5`	启动调试
`Shift + F5`	停止调试
`Ctrl + Shift + F5`	重启调试
`F9`	切换断点
`F10`	单步跳过
`F11`	单步进入
`Shift + F11`	单步跳出

代码示例

创建一个简单的Python项目来验证VSCode配置：

项目结构

代码示例

my_project/
├── .vscode/
│   ├── settings.json
│   └── launch.json
├── main.py
└── utils.py

utils.py

代码示例

def greet(name: str) -> str:
    return f"Hello, {name}! Welcome to Python development with VSCode."


def add(a: int, b: int) -> int:
    return a + b


def fibonacci(n: int) -> list[int]:
    if n <= 0:
        return []
    elif n == 1:
        return [0]
    
    fib = [0, 1]
    for i in range(2, n):
        fib.append(fib[i - 1] + fib[i - 2])
    return fib

main.py

代码示例

from utils import greet, add, fibonacci


def main():
    print(greet("Developer"))
    print(f"10 + 20 = {add(10, 20)}")
    print(f"Fibonacci(10): {fibonacci(10)}")


if __name__ == "__main__":
    main()

在VSCode中打开项目文件夹，按 F5 运行调试，验证一切配置正确。

注意事项

解释器路径：确保选择的Python解释器路径正确，特别是使用虚拟环境时
扩展冲突：不要同时安装多个Python格式化扩展（如Black和Ruff），避免格式化冲突
工作区设置：推荐使用工作区级别的设置（.vscode/settings.json），而非全局设置，这样不同项目可以有不同配置
性能优化：如果项目较大，可以在设置中排除不需要分析的目录："python.analysis.exclude": ["node_modules", ".git"]
自动激活虚拟环境：VSCode会自动检测并激活项目中的虚拟环境，确保终端中也能使用正确的Python
远程开发：VSCode支持通过Remote-SSH扩展在远程服务器上开发Python项目

小结

本教程详细介绍了VSCode的Python开发环境配置：

安装VSCode编辑器
安装Python扩展和相关推荐扩展
配置Python解释器路径
设置编辑器和Python专属配置项
配置调试环境，包括快速调试和自定义调试配置

VSCode轻量灵活，配合丰富的扩展生态，可以满足从初学者到专业开发者的各种需求。

练习题

练习1

在VSCode中安装Python扩展和Pylance扩展，然后创建一个Python项目，配置Python解释器，并成功运行一个简单的"Hello World"程序。

练习2

配置VSCode的调试环境，创建一个包含函数调用的Python脚本，设置断点，使用调试功能逐步执行代码，观察变量的变化。要求：

在 launch.json 中配置至少一种调试模式
在代码中设置至少两个断点
使用"单步进入"和"单步跳过"功能

常见问题

VSCode如何安装Python扩展？

使用快捷键 Ctrl + Shift + X（macOS: Cmd + Shift + X）打开扩展面板，搜索"Python"，安装由Microsoft发布的官方Python扩展即可。

VSCode如何切换Python解释器？

按 Ctrl + Shift + P 打开命令面板，输入"Python: Select Interpreter"，从列表中选择已安装的Python解释器；或者点击底部状态栏右侧的Python版本号进行选择。

VSCode调试Python代码的快捷键有哪些？

F5启动调试，Shift + F5停止调试，F9切换断点，F10单步跳过，F11单步进入，Shift + F11单步跳出。

VSCode推荐安装哪些Python相关扩展？

必装：Python（Microsoft）、Pylance（Microsoft）、Python Debugger（Microsoft）。推荐：Ruff（代码检查和格式化）、Python Indent（缩进辅助）、autoDocstring（自动生成文档字符串）。

如何在VSCode中配置Flask或Django项目的调试？

在项目根目录创建 .vscode/launch.json 文件，添加对应的调试配置。Flask需设置module为"flask"并配置环境变量FLASK_APP和FLASK_DEBUG；Django需设置program指向manage.py并启用django选项。

标签： VSCode Python扩展 IDE配置调试配置 Pylance Python教程开发工具

本文涉及AI创作

内容由AI创作，请仔细甄别

list快速访问

poll相关推荐

Python虚拟环境 - venv/virtualenv/conda环境管理

pip包管理器

PyCharm安装与配置教程 - Python IDE

Python 安装 - Linux

快速访问

相关推荐