手把手教你用VS Code打造Python开发环境（附避坑指南）

最新推荐文章于 2025-05-16 15:07:08 发布

fluxcode

最新推荐文章于 2025-05-16 15:07:08 发布

阅读量1k

点赞数 19

CC 4.0 BY-SA版权

文章标签： python 开发语言

本文链接：https://blog.youkuaiyun.com/fluxcode/article/details/147600822

前言

作为一个被Python折磨了3年的老码农（其实是被自己坑的），今天必须把VS Code配置Python环境的血泪经验分享给大家！相信我，看完这篇至少能帮你省下20小时查资料的时间，特别是最后那个"路径玄学问题"，90%的新手都会中招！

第一步：安装Python的正确姿势

官网下载地址：python.org（认准官网！别在第三方网站下！！！）
安装时务必勾选 Add Python to PATH（图1红框处），这是后续一切顺利的前提！（重要程度五颗星★）
测试安装是否成功：
```
python --version
```
如果看到类似 Python 3.11.4 的输出，恭喜你迈出第一步！

常见坑点：很多教程会教大家用系统自带的Python，但这样容易引发权限问题。强烈建议单独安装新版Python！

VS Code基础配置

安装官方Python扩展（图2）：
- 快捷键 Ctrl+Shift+X 打开扩展商店
- 搜索 Python 安装微软官方版本（认准蓝色图标）
配置解释器路径：
- 按 Ctrl+Shift+P 打开命令面板
- 输入 Python: Select Interpreter 选择你的Python安装路径
- （超级重要）如果这里找不到Python，大概率是第一步的PATH没配置好！

必装插件推荐

插件名称	作用	推荐指数
Pylance	智能代码补全	★★★★★
Jupyter	交互式编程	★★★★☆
Python Test Explorer	单元测试工具	★★★★☆
autopep8	代码自动格式化	★★★★☆

个人私货：一定要试试 Python Snippets 这个插件，输入for就能自动生成循环模板，简直不要太爽！

调试配置玄学指南

创建 .vscode/launch.json 文件时，经常会遇到这些报错：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true  // 这个参数能跳过库文件调试
        }
    ]
}