【Python开发入门】在VSCode中搭建Python环境及运行方法

“想开始学编程，但不知道从何下手……”
“一听到‘环境搭建’就觉得好难……”

几个月前的我，也完全是同样的心情。从零知识开始，无数次撞上错误的南墙，每天都在四处寻找解决方案。而现在，我借助AI的力量，已经能够独立搭建网站了。

这篇文章是我写给过去自己的“VSCode Python开发环境搭建指南”。我尽量不使用专业术语，并融入了许多我实际踩过的坑，以及“这样思考就懂了！”的经验。

本文的目标不仅仅是让你照着步骤操作。而是让你亲身体验自己写的代码在电脑上“跑起来”的那份小感动，为你的编程学习之旅开启一个最棒的开端。文中提供了复制粘贴即可运行的代码，请放心地跟着我来吧！

第1步：安装Python【最初也是最重要的关卡！】

首先，我们要在电脑上安装编程语言Python。这是第一步，也是最重要的一步。特别是，如果忘了一个关键的勾选，之后很容易陷入“命令无法执行！”的困境，所以让我们一起谨慎地进行吧。

从官网下载安装程序

万事开头难，我们先从Python官网获取安装程序。

1. 访问Python官网下载页面。
2. 点击页面上黄色的“Download Python x.x.x”按钮下载安装程序。（选择最新的稳定版本即可）

【最重要】安装时的魔法勾选

打开下载的安装程序，会显示安装界面。在这里，绝对不能忘记的是，勾选底部的“Add python.exe to PATH”复选框。

勾选后，点击“Install Now”开始安装。完成后点击“Close”即可。

检查是否安装成功

我们来确认一下电脑是否真的认识了Python。Windows用户打开“命令提示符”或“PowerShell”，Mac用户打开“终端”，输入以下命令并按Enter键。

python --version

如果显示出你安装的版本，比如Python 3.12.4，那就大功告成！如果出现错误，很可能是忘记勾选“Add python.exe to PATH”了。这种情况下，请先卸载Python，再试一次这个步骤。

第2步：安装VSCode (Visual Studio Code)

接下来，我们来安装用于编写代码的高性能编辑器“VSCode”。它对于程序员来说就像一把“瑞士军刀”，不仅可以用于Python，还能用于各种语言的开发。

1. 访问VSCode官网下载页面。
2. 根据你的操作系统（Windows, Mac）点击相应的按钮下载安装程序。
3. 运行下载的安装程序，按照屏幕指示进行安装。基本上保持默认设置即可。

第3步：为VSCode定制Python开发环境！【扩展功能】

刚安装好的VSCode只是一个普通的文本编辑器。通过安装名为“扩展”的附加组件，我们可以将它变成一个超强的Python开发工具。

首先，将VSCode汉化

如果你不习惯英文界面，可以先将它汉化。

1. 启动VSCode，点击左侧的方块图标（扩展视图）。
2. 在搜索框中输入“Chinese (Simplified) Language Pack”。
3. 选择最上方出现的地球图标的扩展，点击“Install”按钮。
4. 安装后，点击右下角出现的“Change Language and Restart”重启，菜单等就会变成中文了。

Python开发的必备扩展

接下来，我们要安装能极大提升Python开发效率的Microsoft官方扩展。在刚才的扩展视图中，搜索“Python”。

选择由Microsoft提供、带有蓝色对勾的“Python”进行安装。只需这一个扩展，就能获得以下主要功能：

• IntelliSense: 智能的代码自动补全助手，可以减少拼写错误，提高开发速度。
• 代码检查 (Pylint): 实时指出代码中的语法错误和不推荐的写法。
• 调试: 逐行执行代码，同时监控变量状态等，是解决错误的最强工具。

第4步：理解“虚拟环境”【最重要的概念】

好了，终于要开始写代码了！…但在那之前，请允许我再说明一个在专业开发中被视为“理所当然”的超重要概念——“虚拟环境”。理解了它，你离脱离新手就又近了一大步。

为什么需要虚拟环境？

我刚知道这个概念时，也觉得“为什么要搞这么麻烦？”。简单来说，就是“为每个项目隔离使用的工具（库）”。

比如，你要制作两个塑料模型。

• 模型A的说明书上写着：“请使用胶水X和油漆Y”。
• 模型B的说明书上写着：“请使用最新的胶水Z和旧版的油漆Y”。

如果你的工作台只有一个，会怎么样？胶水X和Z混在一起，或者因为放了新的油漆Y导致旧的油漆Y没法用了…简直一团糟，对吧？

编程也是一样。项目A可能需要用“库X的1.0版本”，而项目B需要用“库X的2.0版本”，这种情况非常普遍。如果把所有库都安装在整个电脑上（就像把工具都堆在一个桌子上），就无法应对这种版本差异，导致项目无法运行。

这时“虚拟环境”就派上用场了。它就像为每个项目准备一个专用的“虚拟工作台（工具箱）”。在这个箱子里只放入该项目所需的库，就能防止与其他项目的工具混淆。

创建并激活虚拟环境

理论就说这么多，我们来实际创建一个吧。

1. 在桌面等喜欢的地方创建一个新文件夹。这里我们叫它“my-python-project”。
2. 启动VSCode，从“文件”菜单中选择“打开文件夹...”，然后打开刚才创建的“my-python-project”文件夹。
3. 在VSCode中，从“终端”菜单中选择“新建终端”，在屏幕下方打开一个终端。
4. 在终端中，输入以下命令并按Enter键。这样就会创建一个名为“.venv”的虚拟环境（工具箱）。

python -m venv .venv

接下来，为了使用刚创建的工具箱，我们需要“激活”它。这就像打开工具箱的盖子。请注意，不同操作系统的命令是不同的。

【Windows (PowerShell) 的情况】

.venv\Scripts\activate

【Mac / Linux 的情况】

source .venv/bin/activate

如果成功，终端的行首会多出一个(.venv)的提示。这就是你已经进入虚拟环境（工具箱盖子打开了）的信号！

第5步：终于要运行了！显示“Hello, World!”

久等了！万事俱备。终于要亲手运行程序了。

1. 在VSCode左侧的资源管理器视图中，点击“my-python-project”文件夹旁边的“新建文件”图标。
2. 将文件名命名为“main.py”并按Enter键。
3. 在打开的main.py文件中，尝试手动输入以下这行代码。（复制粘贴也可以，但一开始练习打字也很重要！）

print("Hello, VSCode World!")

写好代码后，点击VSCode界面右上角的“播放（▶）”按钮。

如果终端中显示如下内容，那么你的第一个程序就成功运行了！恭喜！

Hello, VSCode World!

这就是编程学习中“跑起来了！”的感动瞬间。这种微小的成功体验的积累，是持续学习下去的最大动力。

第6步：体验调试功能【和错误做朋友】

程序不像预期那样运行是家常便饭。这时，找出错误原因的最强武器就是“调试器”。

什么是调试？

调试，就是让程序在运行中途暂停，仔细观察那个时间点的变量内容等，从而排除bug（虫子）的过程。它不是盲目地修改代码，而是科学地定位问题所在。

设置一个断点

首先，请将以下代码粘贴到main.py中。

name = "Copicode"
message = "Welcome to " + name
print(message)

num1 = 10
num2 = 20
total = num1 + num2
print(total)

接下来，尝试点击代码行号的左侧。会出现一个红点（●）。这就是“断点”，是“调试运行时，请在这里暂停一下”的标记。这次我们把它设置在total = num1 + num2这一行（第6行）吧。

开始调试！

1. 按下键盘上的F5键，或者打开左侧的“运行和调试”视图（带播放按钮的虫子图标），然后点击最上方的“运行和调试”按钮。
2. 如果出现选择Python文件的对话框，选择“Python File”。

程序会开始运行，但在设置了断点的第6行之前（执行到第5行）暂停。这时，请看屏幕左侧的“变量”面板。

name、message、num1、num2这些变量的值一目了然。尚未执行的第6行的变量total此时还不存在。

点击上方出现的调试工具栏中的“单步跳过（↓）”按钮一次，程序会前进一行，执行第6行。然后你会发现，变量面板中新增了total: 30。

像这样，使用调试功能，你可以对程序内部发生的事情了如指掌。即使出现错误，也不用写一大堆print语句，就能优雅地找到问题所在。

【应用篇】使用库来加深“跑起来了！”的感动

"Hello, World!"是了不起的第一步，但编程的真正力量，是通过使用世界各地开发者创建的“库（常用工具集）”来发挥的。

这里，我们来使用超人气的网络通信库`requests`，运行一个获取天气信息的简单程序吧。

1. 安装库

确认虚拟环境已激活（终端行首有(.venv)提示），然后执行以下命令，将`requests`库添加到你的“工具箱”中。

pip install requests

pip是管理Python库的便捷命令。

2. 调用天气预报API的代码

请先将main.py的内容全部清空，然后粘贴以下代码。这段代码会从日本气象厅提供的免费天气预报API获取东京的天气预报。

# 首先声明我们要使用requests库
import requests
import json

# 日本气象厅的API端点（东京天气预报）
url = "https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json"

try:
    # 实际访问API并获取信息
    response = requests.get(url)
    
    # 将获取的信息（JSON格式）转换为Python可以处理的格式
    weather_data = response.json()
    
    # 整理并显示信息
    publishing_office = weather_data[0]["publishingOffice"]
    report_datetime = weather_data[0]["reportDatetime"]
    target_area = weather_data[0]["timeSeries"][0]["areas"][0]["area"]["name"]
    weather_info = weather_data[0]["timeSeries"][0]["areas"][0]["weathers"][0]

    print(f"发布单位: {publishing_office}")
    print(f"发布时间: {report_datetime}")
    print(f"目标地区: {target_area}")
    print(f"今天天气: {weather_info}")

except requests.exceptions.RequestException as e:
    print(f"发生通信错误: {e}")
except json.JSONDecodeError:
    print("天气信息解析失败。")
except Exception as e:
    print(f"发生未知错误: {e}")

3. 运行试试看！

像往常一样，点击右上角的播放按钮来运行。如果终端里成功显示了今天的日期和东京的天气预报，那就太棒了！

仅仅几行代码，就实现了与外部服务器的通信，并获取到了有意义的信息。这就是编程的乐趣和强大之处。请带着这份感动，继续你的学习之旅吧！

我是一个编程新手。
运行以下Python代码时，出现了下面的错误。

# --- 在这里粘贴你的代码 ---
（粘贴上面的天气预报代码）
# --- 代码结束 ---

# --- 在这里粘贴错误信息 ---
（粘贴终端里出现的错误）
# --- 错误信息结束 ---

请用新手也能看懂的方式，解释错误的原因以及我应该怎么做才能解决它。

总结：致开启了完美开端的你

到这里，真的辛苦了！你现在已经拥有了一个完美的开发环境，可以在VSCode中运行Python程序了。不仅如此，你还同时获得了：

• 代码跑起来的感动
• 解决错误的武器（调试器）
• 遇到困难时可以依赖的伙伴（AI）

这在编程学习的道路上，是一笔极其宝贵的财富。

请珍视今天体验到的“跑起来了！”的微小成功，今后也请享受学习的乐趣，继续前进吧。你作为创作者的旅程，才刚刚开始！

即使环境搭建没有遇到问题，编程中也难免会遇到各种各样的错误。作为下一步，推荐你阅读下面这篇总结了常见错误及其解决方法文章。