手把手教你用VS Code打造Python开发环境（保姆级教程）

「已注销」

于 2025-04-25 21:29:56 发布

阅读量2.1k

点赞数 20

文章标签： python 开发语言

本文链接：https://blog.youkuaiyun.com/functionflow1/article/details/147521551

版权

一、环境搭建前的灵魂拷问

老铁们是不是经常遇到这种情况：装完Python后打开VS Code一脸懵逼？命令行运行正常但编辑器里疯狂报错？今天咱们就用最接地气的方式，把VS Code配置Python环境那点事儿彻底整明白！（相信我，看完这篇你绝对能少踩80%的坑）

二、环境配置四部曲

1. 安装VS Code（注意这些隐藏操作）

官网下载安装包这种基本操作咱们跳过，重点说几个新人必踩的坑：

安装时记得勾选添加到PATH（超级重要！！！）
首次启动后按Ctrl+Shift+X打开扩展商店
安装官方中文语言包（英语大佬请无视）

2. Python扩展安装玄学

在扩展商店搜索Python，认准微软官方出品（带蓝色认证标识的那个）。安装完成后可能会遇到：

正在下载Python语言服务器...

（这时候可以去冲杯咖啡，首次安装确实慢）

3. 解释器选择的艺术

按Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter，这里会出现：

系统自带Python（默认在/usr/bin/python）
虚拟环境Python（如果有的话）
Conda环境（如果安装了Anaconda）

![解释器选择界面示意图]（想象这里有个选择框）

敲黑板！！！新手建议选择虚拟环境（后面会教创建方法），避免污染系统环境

4. 创建你的第一个Python项目

新建文件夹→用VS Code打开→新建hello.py，输入：

print("Hello, VS Code!")

按F5启动调试，这时候会弹出选择调试配置：

Python File
Module
Attach

直接选第一个，见证奇迹的时刻到了！（如果报错请继续往下看）

三、调试配置进阶玩法

1. launch.json文件解密

在项目根目录会自动生成.vscode/launch.json，重点参数说明：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal", // 改成externalTerminal可开新窗口
            "args": ["--name", "老王"] // 自定义参数示例
        }
    ]
}

2. 断点调试骚操作

条件断点：右键断点→编辑条件（比如x > 100）
日志断点：右键断点→编辑日志消息（不暂停程序直接输出）
函数断点：直接在函数定义行打断点

四、依赖管理黑科技

1. 虚拟环境创建

在终端运行：

python -m venv .venv

然后按Ctrl+Shift+P选择解释器→找到.venv下的python

2. 一键安装依赖

新建requirements.txt，VS Code会自动检测并显示安装按钮：

numpy==1.24.3
pandas>=1.5.0

（实测比命令行敲pip install快10倍！）

五、插件全家桶推荐

插件名称	作用	必装指数
Python Test Explorer	单元测试可视化	★★★★★
Jupyter	交互式编程	★★★★☆
Python Indent	智能缩进	★★★★☆
GitLens	代码版本管理	★★★★☆

六、常见问题排雷指南

1. 找不到解释器怎么办？

检查路径是否正确，Windows用户注意：

# 错误路径
C:\Program Files\Python39\python.exe
# 正确路径
C:\Users\你的用户名\AppData\Local\Programs\Python\Python39\python.exe

2. 调试时提示超时？

在settings.json添加：

"python.terminal.launchArgs": ["--log-time"]

3. 自动补全失效？

尝试：

重启语言服务器：Ctrl+Shift+P → Python: Restart Language Server
删除~/.vscode/extensions/ms-python.python-*目录
重装Python扩展

七、终极配置方案

分享我的个人配置（settings.json）：

{
    "python.analysis.typeCheckingMode": "basic",
    "python.formatting.provider": "black",
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": false,
    "python.linting.flake8Enabled": true,
    "editor.formatOnSave": true,
    "files.autoSave": "afterDelay"
}

（这套配置能自动格式化代码+实时语法检查，强迫症福音！）

八、冷知识时间

你知道吗？VS Code的Python扩展其实是个套娃：

语言服务器：Pylance
调试器：debugpy
格式化工具：可切换black/yapf/autopep8

下次遇到问题可以直接查对应组件的文档，效率翻倍！

结语

配置环境就像拼乐高，缺一块都不行。按照这个教程走完，你的VS Code应该已经变身Python开发利器了。如果还有问题，欢迎评论区交流（但别问激活问题啊喂！）。最后送大家一句话：环境配得好，bug远离我～