第4章 安装开发环境与第一个程序

前三天一直在"学工具、做准备"，今天终于要动真格：装好写代码的全套家当，跑通人生第一个 Python 程序。

先打个比方。写代码就像开饭店：Python 是锅（编程语言本体，负责"炒菜"），VSCode 是厨房台面（编辑器，负责"摆菜、切菜"，也就是写代码的地方），Cursor 是请来的 AI 大厨（AI 编程工具，负责帮你写菜谱、检查菜）。后两者都是"操作 Python 这口锅"的软件。

今天的目标一句话：让电脑能运行 Python 代码，并亲眼看到输出。环境装好是以后一切学习的地基，地基歪了后面全歪。装的过程会有报错、会有看不懂的英文，都正常——按顺序来，错了就查速查表、问 AI。今天结束时，你一定能看到那行 "Hello, World!"。

先认清要装的三件套

开发环境不是一个大软件，而是几样东西凑起来的一套：

关系说透：代码是"菜谱"，Python 是"锅"，VSCode/Cursor 是"厨房"。你可以用任何编辑器写代码，但最终让代码"跑起来"的是 Python 自己。本课程的日常学习主力是 Cursor（AI 辅助写代码），VSCode 是它的"原生兄弟"，界面几乎一样。装 VSCode 是为了让你明白两者关系，以后进阶也会用到它。

先记住本次安装的"验收标准"，全部完成后你应当能运行出类似结果：

python --version
# 输出：Python 3.12.4

git --version
# 输出：git version 2.43.0.windows.1

三个认知先摆正：

• 只装 Cursor 不装 Python 不行：Cursor 只负责写代码，跑代码靠 Python，两样缺一不可。
• 三个软件各自独立安装、独立使用，不存在"装一个全都有了"。
• 判断装没装好，不看图标，看命令能不能跑通：python --version 有输出才算数。

第一步：装 Python，别忘勾 PATH

去 Python 官网（python.org）下载 Windows 安装包，双击安装。全流程最关键的一步来了：

安装界面第一屏，最底下有个复选框 Add Python to PATH，一定要勾上！

PATH（读作"帕斯"）是电脑的"通讯录"。勾上它，电脑才知道"python 这个命令对应哪个程序"，你才能在终端里用 python 命令。不勾会怎样？终端输 python --version 会报：

'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。

这是初学者第一高频报错，十有八九是没勾 PATH。如果已经装完没勾，重装一遍勾上就行，重装很快。

装完做两个验证：

# 第1步：验证 Python
python --version
# 输出示例：Python 3.12.4

# 第2步：验证 pip（Python 的"软件商店"，以后装库用）
pip --version
# 输出示例：pip 24.0 from ... (python 3.12)

pip 是 Python 的软件包管理器，相当于 Python 的"应用商店"，以后装各种功能库全靠它，今天先验证它存在即可。

几个细节：

• 只认准官网 python.org 下载，别从乱七八糟的下载站下，避免捆绑软件。
• 安装完必须重开终端：旧终端里 PATH 还没刷新，会误以为没装好。
• 输 python --version 时是 --version（两个横杠），一个横杠 -v 是别的意思。
• Windows 商店里也有 Python，但版本可能老，且 PATH 配置方式不同，建议用官网安装包。

第二步：装 VSCode

VSCode（全名 Visual Studio Code，微软出品，免费）= 一个专门写代码的编辑器。它比记事本强在：代码有颜色（语法高亮）、能自动补全、能直接开终端、能装插件扩展功能。

安装要点：

• 官网 code.visualstudio.com 下载 Windows 版，一路"下一步"
• 安装向导里建议勾选"添加到 PATH"和"将'通过 Code 打开'操作添加到文件资源管理器上下文菜单"，方便以后右键直接打开

打开后的布局先认个脸熟：

VSCode 里最常用的几个操作：

打开文件夹：File → Open Folder → 选中你的项目文件夹
新建文件：  File → New File（或点左侧文件列表旁的"新建文件"图标）
打开终端：  Terminal → New Terminal（或快捷键 Ctrl+`）

装完后有几件事要知道：

• VSCode 是"编辑器"不是"编译器"，写完代码要在终端里运行，别在编辑器里找"运行"按钮（装插件后可以有，初期先习惯终端）。
• 第一次打开要信任文件夹：弹窗选"是，我信任此文件夹"，否则无法正常编辑。
• 中文界面不是必须的，想要的话装"Chinese (Simplified) 中文（简体）语言包"插件即可。

第三步：装 Cursor

Cursor = 带 AI 大模型的代码编辑器，界面和 VSCode 几乎一样，但多了一个"AI 对话面板"。你可以在里面用中文描述需求，AI 直接生成代码、解释代码、改 bug。本课程的学习主力就是它。

安装要点：

• 官网 cursor.com 下载 Windows 版，一路下一步
• 打开后注册一个免费账号（邮箱即可，免费额度足够课程使用）
• 顺手把 GitHub 账号和通义灵码（阿里巴巴的 AI 编程助手，免费）也注册好——课程后续会用，账号早注册早省心

Cursor 的核心入口：

在 Cursor 的 AI 对话面板里输入第一句提问（明天会详细学，今天先试手感）：

我完全没学过编程，请用大白话告诉我：什么是 print()？

AI 会给你一段通俗解释。从现在起，遇到不懂就问它。

还有几个提醒：

• Cursor 免费账号有使用额度，课程学习足够；显示"额度用尽"就等刷新或换个时间段用，别慌。
• Cursor 和 VSCode 可以共存，但别在同一时间打开同一个文件夹，可能互相干扰配置文件。
• 账号注册用常用邮箱，密码记在手机备忘录里——以后每天都要用。

验收：三行命令全跑通

装完不等于装好，验收一下：打开 Cursor 内置终端（顶部菜单 → Terminal → New Terminal，或快捷键 Ctrl+`，键盘左上角那个反引号键），依次运行三行命令，全部有输出才算完成：

python --version
git --version
pip --version

输出（示例）：

Python 3.12.4
git version 2.43.0.windows.1
pip 24.0 from C:\Users\xiaoming\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

三行都出来，环境就齐了。哪一行报错，就对号入座查下面的"常见报错速查"。

如果 python --version 报"不是内部或外部命令"，八成没勾 PATH，重装 Python 勾上，重开终端再试。有人会遇到两套 Python（python 和 python3）的问题，Windows 上直接用 python 即可，python3 是 Linux/Mac 的写法。验证完环境，顺手 cd 到你的项目文件夹，养成"在正确目录里干活"的习惯。

第一个程序：hello.py

环境就绪，写人生第一个程序：让电脑打印一句话。"打印"（print）在编程里的意思是在屏幕上显示出来，不是用打印机打纸。

程序只有一行核心：print("Hello, World!")。拆解它：

步骤：在 Cursor 里新建文件 hello.py → 输入代码 → 保存 → 在终端运行 python hello.py。

在 Cursor 里新建文件 hello.py，输入：

print("Hello, World!")
print("我是 AI 编程工程师预备役！")

保存（Ctrl+S），然后在终端运行：

python hello.py

输出：

Hello, World!
我是 AI 编程工程师预备役！

看到这两行输出，恭喜：你的编程生涯正式开始了。这是所有程序员都走过的第一步。

三个坑提前说：

• 引号必须是英文引号 " "，中文引号 “ ” 会报 SyntaxError——这是新手第一高频报错。
• print 全小写，Print 或 PRINT 会报错：Python 区分大小写，函数名必须小写。
• 运行命令是在终端里敲 python hello.py，不是双击文件，也不是在代码里运行。

改一改：打印你自己的名字

第一个程序跑通后，试着改一改：把程序改成打印你自己的信息。这是你第一次"改代码"——知道改哪里、怎么改、怎么验证。改完再运行，看到自己名字出现的那一刻，成就感会很强。

把 hello.py 改成：

print("大家好，我是小明")          # 改成你的名字
print("今天是 2025 年 1 月 6 日")  # 改成今天的日期
print("我正式开始学编程了！")

保存后运行：

python hello.py

输出：

大家好，我是小明
今天是 2025 年 1 月 6 日
我正式开始学编程了！

再进一步，把名字存进变量——一个带名字的盒子，里面可以放东西。这是编程最重要的概念之一，今天先见个面：

name = "小明"        # 盒子 name 里放了一串文字
print("大家好，我是" + name)

输出：

大家好，我是小明

+ 在这里的作用是"拼接字符串"，把两段文字连起来。

这里最容易出问题：

• 改了文件必须先保存（Ctrl+S）再运行，不保存跑的是旧代码——这是最常见的"我改了怎么没反应"。
• name = "小明" 的等号两边、引号都不能漏；name="小明" 也能运行，但养成写空格的规范习惯。
• "大家好" + name 里加号两边可以空格也可以不空格。不加引号的 name 是变量名，加引号 "name" 就变成纯文字了，效果完全不同。

随堂练习

1. 练习一（环境验收）：在 Cursor 终端依次运行 python --version、git --version、pip --version，三条全部有正常输出。 提示：哪条报错就去补装哪个；报"不是内部或外部命令"先怀疑 PATH，重装勾选后重开终端。

2. 练习二（第一个程序）：新建 hello.py，输入 print("Hello, World!") 和 print("我是 AI 编程工程师预备役！")，保存后运行 python hello.py。 提示：Ctrl+S 保存；确认终端当前目录里有 hello.py（用 ls 看）；运行报错就把报错复制下来看速查表。

3. 练习三（改造程序）：把程序改成打印你自己的名字和今天的日期，再运行一次。 提示：只改引号里的文字，其他结构不动；运行前先保存。

4. ★ 进阶题（变量的第一次）：用变量改造程序：name = "你的名字"，然后让程序打印三句话，其中一句包含 name。尝试再写一行，让程序把名字打印两遍。

AI 协作提示词

场景：环境装好，让 AI 带你写第一个程序

提示词：
我是完全零基础的编程初学者，刚装好 Python 和 Cursor。
请用大白话一步步带我写一个"自我介绍"程序：用变量存我的名字，然后用 print 打印
三句自我介绍。每行代码都解释一下是干什么的，不要一次给太多。

场景：运行报错，复制报错问 AI

提示词：
我是 Python 初学者，运行 hello.py 时报错了，报错内容是：
（把报错原文粘贴到这里）
请用大白话告诉我：这个报错是什么意思？我该怎么改？

常见报错速查

收个尾

今天的事归纳成三句：开发环境 = Python（跑代码）+ VSCode/Cursor（写代码），装 Python 必须勾选 "Add Python to PATH"；第一个程序 print("Hello, World!")，引号必须是英文引号、函数名全小写；改完代码先 Ctrl+S 保存，再在终端敲 python 文件名.py。报错先看速查表，看不懂就复制给 AI。

明天是本周最有意思的一天：看 AI 现场写程序，学"生成、解释、当老师"三种 AI 用法，还要用 AI 完成一个"猜数字"小游戏。今天跑通第一个程序，明天的 AI 演示你就能跟上节奏，还能亲手检验 AI 写的代码。