VS Code配置Python环境全攻略（手把手教学版）

一、环境准备篇（装错全白搭！）

1. Python安装避坑指南

官网下载地址直接贴这里：python.org/downloads（别去第三方网站下！）

安装时务必勾选这两个选项：

• Add Python to PATH（环境变量自动配置）
• Install launcher for all users（全用户安装）

（超级重要）安装完成后按Win+R输入cmd打开命令行，输入：

python --version

看到版本号才说明安装成功！如果报错，90%是环境变量没配置好

2. VS Code正确安装姿势

推荐下载稳定版：code.visualstudio.com

安装时注意：

• 勾选"添加到PATH"（以后在命令行用code .命令直接开项目）
• 文件关联全选（特别是.py文件）
• 安装路径不要有中文和空格！

二、基础配置篇（效率翻倍的关键）

1. 必装插件三件套

1. Python（微软官方出品）
2. Pylance（智能提示神器）
3. Jupyter（交互式编程必备）

（装完记得重启VS Code才会生效！）

2. 中文界面设置（附赠彩蛋）

1. Ctrl+Shift+P打开命令面板
2. 输入"Configure Display Language"
3. 选择"zh-cn"后重启
4. （隐藏技巧）想切回英文？同样操作选en即可

三、项目实战配置（手把手演示）

1. 新建Python项目

推荐目录结构：

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

（重要）按F1输入"Python: Select Interpreter"选择正确的Python版本

2. 调试配置终极方案

修改launch.json配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "env": {"PYTHONPATH": "${workspaceFolder}"}
        }
    ]
}

（调试卡住怎么办？检查断点是否打在可执行代码行！）

四、高级技巧篇（老司机必备）

1. 虚拟环境配置

推荐使用venv：

python -m venv .venv

激活环境：

• Windows: .venv\Scripts\activate
• Mac/Linux: source .venv/bin/activate

（VS Code右下角可以快速切换虚拟环境）

2. 实用插件推荐

• Python Test Explorer：单元测试神器
• Python Indent：智能缩进修正
• autoDocstring：自动生成文档注释
• GitLens：代码版本管理加强版

五、常见问题急救包

1. 导入模块报错？

• 检查文件路径是否正确
• 在终端执行pip install 模块名
• 检查是否在虚拟环境中

2. 代码提示不生效？

• 检查Pylance是否安装
• 按Ctrl+Shift+P输入"Developer: Reload Window"
• 删除.vscode文件夹重新配置

3. 终端显示乱码？

• 设置 -> 搜索"Terminal > Integrated: Default Profile"
• 改为"Command Prompt"（Windows）或"bash"（Linux/Mac）

（终极解决方案）在settings.json中添加：

"terminal.integrated.defaultProfile.windows": "Command Prompt",
"terminal.integrated.shellArgs.windows": ["/K", "chcp 65001"]

六、个性化设置（打造专属IDE）

1. 主题推荐

• One Dark Pro（护眼首选）
• Material Icon Theme（图标美化）
• Rainbow CSV（数据文件高亮）

2. 快捷键魔改

必改快捷键：

• 格式化代码：Shift+Alt+F → 改为Ctrl+S保存时自动格式化
• 运行代码：F5 → 改为Ctrl+R
• 多光标选择：Alt+点击 → 改为更顺手的组合键

（修改方法：按Ctrl+K Ctrl+S打开快捷键设置）

最后的小贴士

配置过程中最容易踩的坑：

1. Python版本和项目需求不匹配（用pyenv管理多版本）
2. 虚拟环境没激活就安装包
3. 工作区没正确设置导致模块导入失败

建议新手先用默认配置跑通流程，再逐步个性化定制。遇到问题多查官方文档（按F1输入"Python: Help"），少走弯路才是真捷径！