10 分钟搭建 Python 开发环境

★ 

📝 预计阅读时间：15 分钟 | 难度：⭐☆☆☆☆

”

🎯 学习目标

完成本课后，你将能够：

• ✅ 在你的系统上安装 Python 3.12
• ✅ 配置 VS Code 开发环境
• ✅ 运行第一个 Python 程序
• ✅ 独立排查常见安装问题

📋 准备

• 一台电脑（Windows/Mac/Linux 均可）
• 网络连接（用于下载软件）
• 管理员权限（安装软件需要）
• 约 10 分钟时间

📚 课程内容

1. 为什么需要搭建开发环境？

很多新手教程一上来就讲语法，但你连代码在哪里写、怎么运行都不知道。

想象一下：

• 你想学做饭，但连厨房都没进过
• 你想学游泳，但还没到泳池边
• 你想学开车，但还没摸到方向盘

环境搭建就是你的「厨房」「泳池」「方向盘」。

本文目标：10 分钟内，让你写出并运行第一个 Python 程序！

2. 第一步：确认你的操作系统

不同系统安装方式略有不同，请先确认：

Windows 用户

• 按 Win + R，输入 winver，查看版本
• 推荐：Windows 10 或 Windows 11
• 需要权限：管理员权限（安装软件用）

Mac 用户

• 点击左上角苹果图标 → 关于本机
• 推荐：macOS 10.15 或更高版本
• 需要权限：输入密码授权安装

Linux 用户

• 终端输入 lsb_release -a 查看版本
• 推荐：Ubuntu 20.04+ / CentOS 7+
• 通常已预装 Python，但建议安装新版

3. 第二步：下载并安装 Python

3.1 访问官网

打开浏览器，访问 Python 官网： 👉 https://www.python.org/downloads/

网站会自动识别你的系统，推荐对应版本。 当前推荐版本：Python 3.12.x（最新稳定版）

3.2 Windows 安装步骤

1. 下载安装包（约 25MB）
2. 双击运行安装程序
3. ⚠️ 重要：勾选「Add Python to PATH」
4. 点击「Install Now」
5. 等待安装完成（约 2-3 分钟）
6. 点击「Close」

为什么勾选 PATH？勾选后，可以在命令行任何位置运行 Python，否则只能在安装目录运行。

3.3 Mac 安装步骤

方式一：官网安装包

1. 下载 macOS 安装包（.pkg 文件）
2. 双击运行，按提示安装
3. 输入电脑密码授权

方式二：使用 Homebrew（推荐）

# 打开终端，输入以下命令
brew install python@3.12

3.4 验证安装

打开命令行工具：

• Windows：按 Win + R，输入 cmd，回车
• Mac：按 Cmd + Space，搜索「终端」，回车

输入以下命令：

python --version

看到类似输出表示成功：

Python 3.12.3

常见问题：

• 如果提示「命令未找到」，检查是否勾选 PATH
• 如果显示 Python 2.x，尝试 python3 --version

4. 第三步：选择你的代码编辑器

写代码需要专门的工具，就像写作需要 Word 一样。

推荐方案：VS Code（免费、强大）

为什么选 VS Code？

• ✅ 免费开源
• ✅ 跨平台（Windows/Mac/Linux）
• ✅ 轻量快速
• ✅ 丰富的 Python 插件
• ✅ 智能代码补全
• ✅ 内置终端

安装 VS Code

1. 访问官网：https://code.visualstudio.com/
2. 下载对应系统版本
3. 安装（一路下一步即可）
4. 启动 VS Code

安装 Python 插件

1. 点击左侧「扩展」图标（或按 Ctrl+Shift+X）
2. 搜索「Python」
3. 找到 Microsoft 出品的官方插件
4. 点击「安装」

备选方案

5. 第四步：写出你的第一行代码

5.1 创建项目文件夹

1. 在桌面新建文件夹，命名为 python-learning
2. 在 VS Code 中打开这个文件夹：
• 点击「File」→「Open Folder」
• 选择刚才创建的文件夹

5.2 创建第一个 Python 文件

1. 点击左侧「新建文件」图标
2. 命名为 hello.py（注意后缀是 .py）
3. 在文件中输入：

print("Hello, Python!")
print("我的第一个 Python 程序")

5.3 运行程序

方式一：使用 VS Code 内置功能

• 点击右上角的 ▶️ 运行按钮
• 或使用快捷键 F5

方式二：使用终端

1. 在 VS Code 中打开终端（Ctrl + ~）
2. 输入命令：

python hello.py

5.4 见证奇迹时刻

看到以下输出，恭喜你成功了！

Hello, Python!
我的第一个 Python 程序

如果出错了怎么办？

• 检查文件后缀是否为 .py
• 检查引号是否成对（中文引号❌ vs 英文引号✅）
• 检查 print 是否小写（Python 区分大小写）

6. ✅ 环境检查清单

完成以下检查，确保环境完全就绪：

• [ ] Python 已安装（python --version 有输出）
• [ ] VS Code 已安装并能正常打开
• [ ] Python 插件已安装
• [ ] 能创建 .py 文件
• [ ] 能成功运行 hello.py
• [ ] 知道如何查看错误信息

全部打勾？恭喜你，环境搭建完成！🎉

接下来就可以开始正式的 Python 学习了！

7. ❓ 常见问题解答

Q1：安装时提示权限不足？
A：右键安装程序，选择「以管理员身份运行」（Windows）或输入密码（Mac）。

Q2：命令行输入 python 没反应？
A：尝试 python3，或者重新安装并勾选「Add to PATH」。

Q3：VS Code 运行后闪退？
A：在代码最后加一行 input()，防止窗口立即关闭。

Q4：中文显示乱码？
A：在文件第一行添加 # -*- coding: utf-8 -*-，或检查终端编码设置。

Q5：可以同时安装多个 Python 版本吗？
A：可以，但建议新手先专注一个版本（推荐 3.12）。

Q6：需要付费吗？
A：完全不需要！Python 和 VS Code 都是免费开源的。

8. 📝 课后练习

基础题

1. 修改 hello.py，输出一行自我介绍
2. 尝试输出多行内容（使用多个 print()）
3. 尝试输出特殊字符（如 emoji：🎉🚀💻）

挑战题

1. 搜索「Python print 技巧」，尝试输出彩色文字
2. 创建一个新文件 calc.py，输出简单的数学计算结果

思考题

1. 如果 print() 里什么都不写，会发生什么？
2. 如果忘记加引号，会发生什么？

提示：大胆尝试，出错是学习的一部分！

9. 📌 下期预告

第 02 期：《和 Python 说第一句话——print() 输出详解》

• print() 的多种用法
• 字符串拼接技巧
• 格式化输出入门
• 实用案例：制作个性化名片

敬请期待！

10. 🔗 本期资源

• Python 官网下载
• VS Code 官网下载
• Python 官方文档