VS Code配置Python环境全攻略（手把手保姆级教程）

最新推荐文章于 2025-04-26 00:40:05 发布

systemseer

最新推荐文章于 2025-04-26 00:40:05 发布

阅读量956

点赞数 24

文章标签： python 开发语言

本文链接：https://blog.csdn.net/systemseer/article/details/147522463

版权

一、为什么选择VS Code写Python？

（拍胸脯保证）这绝对是2023年最值得入手的Python开发组合！作为一个用PyCharm、Sublime、Jupyter Notebook都踩过坑的老司机，实测VS Code在轻量化、响应速度和扩展性上的表现简直惊艳（特别是对新手友好）！

二、环境搭建四步曲

1. Python本体安装

⚠️ 注意：这里有个90%新手都会踩的坑！

官网下载地址：python.org/downloads
安装时务必勾选Add Python to PATH（划重点！！！）
验证安装：命令行输入 python --version 看到版本号就算成功

2. VS Code安装

（如果已经安装的可以直接跳下一步）

官网下载速度慢？试试国内镜像站：
- 官方原版：code.visualstudio.com
- 国内镜像：vscode.cdn.azure.cn

3. 核心插件安装

按下 Ctrl+Shift+X 打开扩展商店，搜索并安装：

Python（微软官方出品）
Pylance（智能提示神器）
Jupyter（写.ipynb必备）

（小技巧）点击插件右下角的齿轮→扩展设置，可以开启自动格式化功能！

4. 创建你的第一个项目

新建文件夹 my_python_project
创建 hello.py 文件
输入经典代码：

print("Hello VS Code!")
print(1+1)  # 测试代码提示

三、调试环境配置（重点！）

按 F5 启动调试时如果报错，八成是解释器没选对：

按 Ctrl+Shift+P 打开命令面板
输入 Python: Select Interpreter
选择带 (global) 标签的解释器

（避坑指南）如果看到多个Python版本，建议选带3.10或更高版本号的！

四、虚拟环境配置（进阶必备）

在终端执行：

python -m venv .venv  # 创建虚拟环境
.\.venv\Scripts\activate  # Win激活环境
source .venv/bin/activate  # Mac/Linux激活

看到命令行前缀出现(.venv)就成功啦！这时安装的包都会在虚拟环境里，不会污染系统环境~

五、超实用插件推荐

Python Docstring Generator：自动生成函数注释模板
Code Runner：右键一键运行代码（快捷键Ctrl+Alt+N）
autoDocstring：智能参数提示（写函数时超省心）
Python Test Explorer：单元测试神器

六、常见报错解决方案

ImportError：先检查虚拟环境是否激活
ModuleNotFoundError：在终端执行 pip install 包名
SyntaxError：检查Python版本是否≥3.6
编码错误：在文件开头添加 # -*- coding: utf-8 -*-

七、个性化设置（装X必备）

在settings.json中添加：

{
    "python.formatting.provider": "black",
    "editor.formatOnSave": true,
    "python.linting.pylintEnabled": true,
    "python.analysis.typeCheckingMode": "basic"
}

这样就能实现保存时自动格式化代码+实时语法检查啦！

八、终极调试技巧

创建.vscode/launch.json配置文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python调试",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "args": ["--input", "test.txt"]  // 调试参数
        }
    ]
}