- 核心目标：完成 Python 开发环境搭建，在 VS Code 中写出并运行第一个程序
- 核心知识点：Windows / Mac / Linux 三平台安装 Python、VS Code 安装与 Python 插件配置、终端运行
.py文件 - 实操产出：独立配置完整开发环境，成功运行
Hello World程序 - 前置基础：零基础，本章为专栏第一篇，无需任何编程经验
一、写在前面
你可能用过 Scratch——打开浏览器，拖积木就能跑，零安装零配置，体验非常丝滑。
但 Python 不一样。它是一门真正的编程语言，代码写在文件里，需要安装「解释器」才能运行。这就像 Scratch 是一打开就能玩的在线积木盒，而 Python 是一套需要自己组装的工具箱——第一次组装会麻烦一点，但装好之后，你能做的事比积木多得多。
本章就带你完成这「第一次组装」：安装 Python、配置 VS Code、写出第一个Hello World。全程手把手，每一步都有截图占位和报错排查。
二、安装 Python 解释器
Python 代码本身只是文本，你需要安装Python 解释器才能让代码跑起来。截至本文写作，Python 最新稳定版为3.13.x，建议安装 3.10 及以上版本。
2.1 Windows 安装
步骤 1：下载安装包
前往 Python 官网下载页：https://www.python.org/downloads/
点击「Download Python 3.x.x」按钮，下载 Windows 安装包（64 位推荐）。
步骤 2：运行安装（关键一步）
双击下载的安装包，看到安装界面后：
⚠️最重要的一步：勾选底部「Add Python to PATH」（将 Python 添加到环境变量）。
如果不勾选，后续在终端输入python命令会报「不是内部或外部命令」的错误。
然后点击「Install Now」等待安装完成。
步骤 3：验证安装
按Win + R，输入cmd回车打开命令提示符，输入：
python--version如果输出类似Python 3.13.12，说明安装成功。
2.2 Mac 安装
Mac 系统自带 Python，但版本较旧（通常是 Python 2.x），需要安装新版。
方式一：官网安装包（推荐新手）
同样前往 https://www.python.org/downloads/ ，下载 Mac 版安装包，双击按提示安装即可。
安装完成后打开「终端」，输入：
python3--version注意：Mac 上使用
python3而不是python，因为系统自带的python指向旧版本。
方式二：Homebrew 安装（适合有基础的用户）
如果已安装 Homebrew，一行命令搞定：
brewinstallpython安装完成后同样用python3 --version验证。
2.3 Linux 安装
大多数 Linux 发行版已预装 Python，但可以用包管理器更新到最新版。
Ubuntu / Debian：
sudoaptupdatesudoaptinstallpython3 python3-pipCentOS / RHEL：
sudoyuminstallpython3验证：
python3--version2.4 安装报错排查
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
'python' 不是内部或外部命令 | 安装时未勾选 Add to PATH | 重新运行安装包，选 Modify，勾选 Add to PATH；或手动添加环境变量 |
python3: command not found（Mac/Linux） | 未安装或 PATH 未生效 | Mac 用 Homebrew 重装；Linux 用包管理器安装；重启终端 |
| 安装包打开提示「已损坏」（Mac） | macOS 安全限制 | 终端执行sudo xattr -rd com.apple.quarantine /Applications/Python\ 3.x/ |
| 下载速度极慢 | 官网服务器在海外 | 使用国内镜像站，如华为云镜像：https://mirrors.huaweicloud.com/python/ |
三、安装 VS Code 编辑器
Python 自带的 IDLE 也能写代码，但体验很差。推荐使用VS Code（Visual Studio Code）——免费、轻量、插件丰富，是目前最流行的代码编辑器。
3.1 下载安装
前往 VS Code 官网：https://code.visualstudio.com/
根据你的系统选择对应版本下载，安装过程和普通软件一样，一路下一步即可。
3.2 安装 Python 插件
打开 VS Code 后：
- 点击左侧栏扩展图标（或按
Ctrl+Shift+X/Cmd+Shift+X） - 搜索框输入
Python - 找到微软官方的Python 插件（发布者是 Microsoft），点击安装
3.3 配置 Python 解释器
安装完插件后，VS Code 需要知道你用的是哪个 Python：
- 按
Ctrl+Shift+P（Mac 按Cmd+Shift+P）打开命令面板 - 输入
Python: Select Interpreter，回车 - 选择你刚才安装的 Python 版本（如
Python 3.13.12）
如果列表中没有出现，点击「Enter interpreter path」手动选择 Python 安装路径。
四、第一个 Hello World
环境搭好了，现在写你的第一行代码。
4.1 新建文件
- 在电脑上新建一个文件夹，比如
D:\python-learn\（Mac/Linux 可以放在~/python-learn/） - 用 VS Code 打开这个文件夹：菜单栏 File → Open Folder → 选择文件夹
- 在 VS Code 中新建文件，命名为
hello.py
4.2 写代码
在hello.py中输入以下内容：
print("Hello, World!")就这一行。print()是 Python 的输出函数，括号里用引号包裹的内容会被原样打印到屏幕上。
4.3 运行代码
方式一：VS Code 直接运行
点击代码编辑区右上角的▶ 运行按钮，或者按Ctrl+F5（Mac 按Ctrl+F5）。
底部终端面板会显示运行结果：
Hello, World!方式二：终端运行
在 VS Code 中按Ctrl+``（反引号）打开终端，输入：
# Windowspython hello.py# Mac / Linuxpython3 hello.py输出结果相同。
恭喜！你已经完成了从零到运行第一行代码的全过程 🎉
五、Scratch 积木对照
如果你学过 Scratch，这一行代码其实就等于 Scratch 里的「说」积木：
| Scratch | Python | 说明 |
|---|---|---|
| 「说 Hello!」积木 | print("Hello!") | 都是把内容显示出来 |
| 绿旗点击启动 | 终端运行python 文件名.py | 都是触发程序运行的方式 |
Scratch 拖一个积木就能跑，Python 需要写代码 + 安装环境——这是图形化编程和代码编程最大的区别。但核心逻辑是一样的：给指令，看结果。
scratch积木代码：
python等效代码
# Scratch「说 Hello, World!」→ Python 对照print("Hello, World!")
终端运行python 文件名.py
六、综合实战：个人信息自我介绍程序
把Hello World升级一下，写一个稍微完整的小程序：
# 个人信息自我介绍程序print("="*30)print(" 我的第一个 Python 程序")print("="*30)name="小明"age=18hobby="学编程"print("大家好，我叫",name)print("今年",age,"岁")print("我的爱好是",hobby)print("="*30)print(" 程序运行完毕！")print("="*30)运行结果：
============================== 我的第一个 Python 程序 ============================== 大家好，我叫 小明 今年 18 岁 我的爱好是 学编程 ============================== 程序运行完毕！ ==============================不用完全看懂每一行，这里只是让你感受一下 Python 能做什么。变量、print的多种用法，下一章会详细讲。
七、常见报错速查表
| 报错信息 | 出现场景 | 原因 | 解决方法 |
|---|---|---|---|
'python' 不是内部或外部命令 | 终端运行 python | 未加入 PATH | 重新安装勾选 Add to PATH，或手动添加环境变量 |
[Errno 2] No such file or directory | 运行 .py 文件 | 文件路径错误 | 用cd命令切换到文件所在目录，或使用完整路径 |
SyntaxError: invalid character | 运行代码 | 用了中文标点（如中文括号、中文引号） | 检查代码中的标点，全部使用英文半角标点 |
SyntaxError: invalid syntax | 运行代码 | 代码语法有误（如缺少括号、引号不配对） | 检查括号和引号是否成对出现 |
| VS Code 无法运行 / 没有运行按钮 | 编辑器内 | 未安装 Python 插件或未选择解释器 | 安装 Python 插件 + 选择解释器（见 3.2 / 3.3） |
| 终端中文显示乱码 | Windows | 终端编码问题 | 终端执行chcp 65001切换为 UTF-8 编码 |
八、本章小结
本章你完成了三件事：
- 安装了 Python 解释器——让你的电脑能读懂 Python 代码
- 配置了 VS Code 开发环境——有了顺手的写代码工具
- 写出了第一个 Hello World——正式踏入编程世界
环境搭建是编程的第一道门槛，过了这关，后面的学习就是写代码 → 运行 → 看结果 → 改代码的循环，会越来越顺。
往期回顾：
《Python 零基础入门：从积木到代码》专栏序
下一章预告：
我们将学习print()的完整用法、变量赋值、四大数据类型和input()交互式输入，写出能跟用户对话的小程序。
文末资源区
| 资源 | 说明 |
|---|---|
| Python 官方下载 | https://www.python.org/downloads/ |
| Python 华为云镜像（国内加速） | https://mirrors.huaweicloud.com/python/ |
| VS Code 官方下载 | https://code.visualstudio.com/ |
| 本章完整源码 | chapter1_all.py（关注梅雅达编程笔记，评论发） |
每节课都配套课后练习题与完整源码。代码报错、看不懂知识点，可在评论区粘贴问题，逐一解答！
欢迎关注梅雅达编程笔记，持续分享Python零基础学习内容
)
