欢迎来到Python世界的第一天！
今天我们的目标只有一个：成功运行你人生中的第一行Python代码。
我会把每一步尽量都拆得很细，哪怕你从来没装过任何软件，也能跟着做成功。

一、下载Python

1.1 打开官网

打开你的浏览器，在地址栏输入：
https://www.python.org/downloads/

你会看到页面中央有一个黄色的按钮，上面写着 “Download Python 3.12.x”（x是具体小版本号）。
直接点它，浏览器会自动下载适合你操作系统的安装包。

💡 新手常见疑问：为什么不是Python 2.x？
Python有两个大版本：2.x 和 3.x。2.x 已经停止维护，现在所有新项目都用3.x。所以一定要装3.x。

二、安装Python

2.1 Windows用户

1. 找到下载好的文件，名字类似 python-3.12.x-amd64.exe，双击打开。

2. ⚠️ 最重要的一步：在安装窗口的最底部，有一个 “Add Python to PATH” 的复选框，一定要打勾！
   （如果不勾，后面会很麻烦，新手90%的问题都出在这里）

3. 然后点击绿色的 “Install Now”。

4. 等待进度条走完，出现“Setup was successful”就完成了。

💡 如果安装过程中弹出“User Account Control”窗口，点“是”。

2.2 macOS用户

1. 下载的文件名类似 python-3.12.x-macos11.pkg，双击打开。

2. 一路点击“继续”、“同意”、“安装”。

3. 可能需要输入你的电脑开机密码，输入后点击“安装软件”。

4. 完成后，安装器会提示“安装成功”。

💡 macOS自带一个老旧的Python 2.7，但别管它。我们装的3.x会独立存在，互不影响。

三、验证安装是否成功

这一步非常重要，能确认Python是否真的装好了。

3.1 打开终端（命令行）

• Windows：按键盘上的 Win + R，输入 cmd，然后按回车。

• macOS：按 Command + 空格，搜索“终端”，打开。

3.2 在终端中输入以下命令

bash

python --version

然后按回车。

你应该看到类似这样的输出：

text

Python 3.12.2

（数字可能略有不同，但只要开头是3.x就是对的）

💡 新手常见问题：如果提示 'python' 不是内部或外部命令
→ 说明你在Windows安装时忘了勾选“Add Python to PATH”。
解决方法：重新运行安装程序，勾上那个选项，再装一遍即可。

macOS用户特别提醒：
如果输入 python --version 显示的是 Python 2.7.x，说明你调用的是系统自带的旧版本。请改用：

bash

python3 --version

之后我们统一使用 python3 命令（macOS推荐）。

 四、安装代码编辑器（推荐VS Code）并安装常用插件（含汉化）

虽然你可以用记事本写Python，但一个好用的编辑器能让你写得更快、错误更少。
我强烈推荐 Visual Studio Code（简称VS Code），它免费、轻量、插件丰富。

4.1 下载并安装VS Code

1. 打开浏览器，访问：https://code.visualstudio.com/

2. 点击首页蓝色的 “Download for Windows/Mac” 按钮（会自动识别你的系统）。

3. 下载完成后，双击安装包：

   • Windows：一路点击“下一步”，默认选项即可。

   • macOS：将“Visual Studio Code.app”拖入“Applications”文件夹。

4. 安装完成后，在开始菜单（Windows）或启动台（macOS）找到 VS Code 图标并打开。

4.2 安装中文语言包（汉化）

VS Code默认是英文界面，如果你是新手，汉化后会舒服很多。

1. 打开VS Code后，看左边竖着一排图标，点击最下方的 扩展 图标（像四个小方块，或者按快捷键 Ctrl+Shift+X / Cmd+Shift+X）。

2. 在顶部的搜索框内输入：Chinese

3. 你会看到一个叫做 “Chinese (Simplified) (简体中文) Language Pack” 的插件，点它右边的 Install 按钮。

4. 安装完成后，右下角会弹出一个提示：“Would you like to change your display language to Chinese Simplified?”
   点击 “Yes”（或者 “Restart”），VS Code会自动重启，界面就会变成中文。

💡 如果没弹出提示，可以按 Ctrl+Shift+P（Windows） / Cmd+Shift+P（Mac），输入 Configure Display Language，选择 zh-cn，然后重启。

4.3 安装Python插件（让VS Code认识Python）

1. 再次打开扩展商店（还是那个四个小方块的图标）。

2. 搜索：Python

3. 找到由 Microsoft 发布的 Python 插件（第一个就是），点击 安装。

4. 安装后，VS Code就能自动识别 .py 文件，并提供代码高亮、自动补全、错误提示等功能。

4.4 测试一下环境是否就绪

在VS Code中，点击“文件” → “新建文本文件”，然后点击右下角的“纯文本”，选择 Python 语言。或者直接保存文件时加上 .py 后缀也行。

现在，你有了一个专业级的Python编写环境。

💡 新手常见疑问：我不装VS Code，直接用Python自带的IDLE可以吗？
可以。IDLE是安装Python时自带的简单编辑器，也可以用。但VS Code更强大，以后写复杂项目会省很多时间。我建议新手就装VS Code，一步到位。

五、写下你的第一行Python代码

现在，你有三种方式运行第一行代码。我会从最简单的方式开始。

5.1 方法一：交互式环境（最简单，适合试代码）

在终端中直接输入：

bash

python

（macOS用户输入 python3）

然后你会看到 >>> 提示符，这表示你已经进入了Python的交互式环境。

接着，在 >>> 后面输入：

python

print("Hello, World!")

按回车。

你会立刻看到：

text

Hello, World!

恭喜！你已经成功运行了第一行Python代码。

💡 print() 是Python里用来显示内容的函数。双引号里的内容会被原样输出。

想退出交互式环境，输入 exit() 或按 Ctrl + Z（Windows） / Ctrl + D（macOS）。

---

5.2 方法二：在VS Code中创建脚本文件（推荐）

1. 打开VS Code，点击“文件” → “新建文件”。

2. 点击“文件” → “保存”，将文件命名为 hello.py，选择一个方便的位置（例如桌面或一个新建的 python_demo 文件夹）。

3. 在编辑区输入以下代码：

        python

        # 这是我的第一个Python程序
        print("Hello, World!")

1. 保存文件（快捷键 Ctrl+S / Cmd+S）。

2. 运行代码：点击右上角的小三角形 ▶️（“运行 Python 文件”），或者右键编辑区 → “在终端中运行 Python 文件”。

   你会看到屏幕下方出现一个“终端”面板，里面显示：

text

Hello, World!

如果你看到这个，说明一切正常！

💡 VS Code可能会提示你安装额外的“Python解释器”，点击“选择”或“安装”即可，它会自动找到你刚才装的Python。

---

5.3 方法三：用命令行运行脚本（通用方法）

无论你用什么编辑器，最终都要学会这种方式，因为以后部署程序时经常用到。

1. 打开终端（命令行），用 cd 命令切换到 hello.py 所在的文件夹。
   比如你把文件放在桌面的 python_demo 文件夹里：

   • Windows：

     bash

     cd Desktop\python_demo（文件路径）

   • macOS：

     bash

     cd Desktop/python_demo（文件路径）

2. 运行命令：

   • Windows：

     bash

     python hello.py

   • macOS：

     bash

     python3 hello.py

你会看到：

text

Hello, World!

成功！

---

🐛 六、新手最容易遇到的几个问题和解决方法

问题现象	可能原因	解决方法
'python' 不是内部或外部命令	Windows安装时忘记勾选“Add Python to PATH”	重新运行安装程序，勾上后重装
SyntaxError: invalid syntax	在交互式环境里输入了多余的字符或拼写错误	检查 print 有没有拼错，括号是不是英文括号
直接双击 .py 文件，窗口一闪就没了	程序运行完自动关闭	在代码最后加一行 input("按回车键退出...")，或者用终端运行
macOS输入 python 出来的是2.7版本	系统默认指向旧版	以后统一用 python3 命令
VS Code无法运行，提示“Python未安装”	VS Code没有找到Python解释器	按 Ctrl+Shift+P，输入“Python: Select Interpreter”，选择你装的Python 3.x
VS Code界面是英文的	没有安装中文语言包	按上面的步骤安装Chinese插件，并切换语言