VSCode配置Python环境全攻略（新手必看版）

一、安装前的准备动作

1.1 下载VSCode

打开官网（code.visualstudio.com）直接点那个大大的绿色下载按钮就行（Windows用户选.exe文件最省心）！下载速度取决于你家网速，一般1分钟就能搞定～

1.2 Python解释器安装

（超级重要）先去python.org下载最新版（目前是3.11+），安装时一定要勾选"Add Python to PATH"！！！不勾选的话后面会哭的！安装完成后在cmd里输入python --version验证是否成功，看到版本号才算OK！

二、基础配置四步走

2.1 装Python扩展

打开VSCode左边栏的扩展商店（那个方块图标），搜索"Python"安装微软官方那个带星星的插件。安装完成后右下角可能会弹提示让你选解释器，先别急！

![示意图：扩展商店搜索界面]

2.2 创建工作区

随便找个地方新建文件夹（建议路径不要有中文！），右键用VSCode打开。新建个test.py文件，输入：

print("Hello VSCode!")

按F5尝试运行，这时候会弹出调试配置…

2.3 选择解释器

按Ctrl+Shift+P调出命令面板，输入"Python: Select Interpreter"，选刚安装的Python版本。这时候编辑器底部状态栏会显示当前使用的Python路径（重要检查点！）

2.4 配置settings.json

按Ctrl+,打开设置，右上角点开json配置文件，添加：

{
    "python.linting.pylintEnabled": true,
    "python.formatting.provider": "black"
}

（这样就能启用代码检查和自动格式化啦～）

三、进阶配置三大神器

3.1 虚拟环境配置

在终端里输入：

python -m venv .venv

等执行完后，点左下角解释器切换成新建的虚拟环境。看到终端前出现(.venv)就对了！（从此告别依赖冲突！）

3.2 Jupyter支持

新建.ipynb文件，VSCode会自动提示安装Jupyter插件。装完后可以直接在编辑器里运行代码块，数据分析党的福音！

3.3 调试配置技巧

在launch.json里添加：

{
    "name": "Python: Current File",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal"
}

（按F5调试时会在终端显示完整输出，比默认的调试控制台更直观！）

四、必装插件排行榜

1. Pylance - 智能补全神器（微软亲儿子）
2. Python Test Explorer - 单元测试可视化
3. Python Indent - 自动缩进修正
4. autoDocstring - 一键生成文档注释
5. GitLens - 代码版本追踪

（插件别装太多！会卡！按需安装～）

五、常见问题急救包

5.1 找不到解释器？

• 检查Python安装时的PATH选项
• 重启VSCode试试
• 手动指定解释器路径（一般在C:\Users\用户名\AppData\Local\Programs\Python）

5.2 插件冲突？

按Ctrl+Shift+P输入"Developer: Show Running Extensions"，看哪个插件占用了大量资源

5.3 终端无法激活虚拟环境？

在settings.json里加：

"terminal.integrated.shellArgs.windows": ["-ExecutionPolicy", "Bypass"]

六、终极调试大法

遇到玄学问题时：

1. 关所有插件 → 逐步启用排查
2. 删.vscode文件夹重新配置
3. 终极杀招：重装VSCode（记得先备份设置！）

（其实90%的问题重启都能解决…别问我怎么知道的）

配置完成后推荐新建个爬虫脚本试试：

import requests
response = requests.get('https://httpbin.org/get')
print(response.json())

看到返回的JSON数据说明环境彻底打通啦！接下来就可以愉快地写bug了～（不是）