目录
- 第一步：准备工作
- 了解 Python 的两个主要版本
- 确认你的操作系统版本
- 第二步：下载 Python 安装包
- 官方网站介绍
- Windows 系统下载
- macOS 系统下载
- Linux 系统下载
- 第三步：安装 Python
- Windows 安装详解 (最详细,包含关键选项)
- macOS 安装详解
- Linux 安装详解
- 第四步：验证安装
- 检查 Python 版本
- 检查 pip (Python 包管理器)
- 第五步：配置环境变量 (如果需要)
- 什么是环境变量？
- Windows 环境变量配置
- 第六步：选择一个代码编辑器
强烈推荐：Visual Studio Code (VS Code)
（图片来源网络，侵删） - 第七步：进阶学习 - 使用虚拟环境和管理多个 Python 版本
- 为什么需要虚拟环境？
- 如何使用
venv创建虚拟环境？ - 如何管理多个 Python 版本？(推荐
pyenv)
- 常见问题与解答 (FAQ)
第一步：准备工作
在开始之前,请做好以下准备：
-
了解 Python 的两个主要版本
- Python 2: 已于 2025 年 1 月 1 日停止官方支持。除非你维护非常老旧的项目，否则请务必不要学习或安装 Python 2。
- Python 3: 当前主流版本，持续更新和维护，所有新项目都应使用 Python 3，本教程将指导你安装 Python 3。
-
确认你的操作系统版本
- Windows: 点击
开始->设置->系统->关于，查看“设备规格”下的“系统类型”，是64 位操作系统还是32 位操作系统。 - macOS: 点击屏幕左上角的苹果标志 ->
关于本机，查看“macOS”版本号，macOS Sonoma 14.1或macOS Ventura 13.6。 - Linux: 打开终端，输入
uname -a或lsb_release -a查看发行版和版本信息。
- Windows: 点击
第二步：下载 Python 安装包
-
官方网站 Python 的官方网站是下载最安全、最可靠的来源：https://www.python.org/
（图片来源网络，侵删） -
Windows 系统下载
- 访问 https://www.python.org/downloads/windows/
- 你会看到 "Latest Python 3 Release" (最新的 Python 3 发布版)。
- 根据你的系统类型（64位或32位）点击 "Download x86-64 executable installer" 或 "Download x86 executable installer"。
- 强烈建议下载 "Windows installer (64-bit)"，即使你不确定，现在绝大多数电脑都是 64 位系统。
-
macOS 系统下载
- 访问 https://www.python.org/downloads/mac-osx/
- 下载 "Latest Python 3 Release" 对应的 "macOS 64-bit installer"。
- 注意: 从 macOS 10.12 (Sierra) 开始，系统自带了 Python 2.7，但你无法用它来安装新的 Python 3 包，所以你仍然需要从官网下载并安装最新的 Python 3。
- 从 macOS 11 (Big Sur) 开始，Apple 改用 ARM64 架构 (M1/M2 芯片)，下载页面通常会提供针对 Intel 芯片和 Apple Silicon (M1/M2) 芯片的不同安装包，请根据你的 Mac 芯片类型下载正确的版本，你可以在
关于本机中查看你的 Mac 是使用 "Apple M1" 还是 "Intel" 芯片。
-
Linux 系统下载
- 对于大多数 Linux 发行版（如 Ubuntu, Debian, Mint），最佳方式是通过系统的包管理器安装,这样能更好地与系统集成。
- 以 Ubuntu/Debian 为例:
# 更新软件包列表 sudo apt update # 安装 Python 3 及其包管理工具 pip sudo apt install python3 python3-pip
- 以 Fedora/CentOS 为例:
# 安装 Python 3 及 pip sudo dnf install python3 python3-pip
- 从源码编译安装 (适用于高级用户或需要特定版本的情况): 访问 https://www.python.org/downloads/source/ 下载源码包,然后按照官方文档进行编译安装。
第三步：安装 Python
Windows 安装详解 (最重要！)
-
找到你下载的
.exe文件（python-3.11.4-amd64.exe）,双击运行它。
（图片来源网络，侵删） -
关键一步：勾选 "Add python.exe to PATH"
- 在安装程序的第一个界面，务必勾选左下角的 "Add python.exe to PATH" 这个选项。
- 为什么重要？ 勾选后，你就可以在电脑的任何地方（如命令提示符或 PowerShell）直接输入
python命令，而不需要输入完整的文件路径,这会极大地方便你的后续操作。 - 如果你不小心忘记勾选了，别担心,本教程的第五步会教你如何手动配置。
-
点击 "Install Now" (立即安装)。
- 这会使用默认选项进行安装，推荐大多数初学者选择，它会将 Python 安装到
C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX目录下。
- 这会使用默认选项进行安装，推荐大多数初学者选择，它会将 Python 安装到
-
等待安装完成，然后点击 "Close" (关闭) 即可。
macOS 安装详解
-
找到你下载的
.pkg安装包,双击打开它。 -
按照屏幕上的提示一步步进行操作。
- 你可能会被要求输入你的电脑密码,因为安装程序需要管理员权限。
- 安装程序会自动将 Python 安装到系统合适的位置。
-
安装完成后，你可以打开“终端”(Terminal) 应用，输入
python3来启动它，注意，在 macOS 上，为了避免与系统自带的 Python 2 冲突，新安装的 Python 3 通常需要用python3命令来调用。
Linux 安装详解
如果你通过 apt 或 dnf 命令安装，安装过程是自动完成的,无需额外操作。
安装完成后，打开终端，输入 python3 或 python3 --version 来验证。
第四步：验证安装
无论你使用哪个操作系统，安装完成后都需要验证 Python 是否正确安装并配置了环境变量。
-
打开终端/命令行工具
- Windows: 按
Win + R，输入cmd或powershell,然后按回车。 - macOS: 在“应用程序” -> “实用工具” 中找到“终端”(Terminal) 并打开。
- Linux: 直接按
Ctrl + Alt + T或在应用程序菜单中找到“终端”(Terminal)。
- Windows: 按
-
检查 Python 版本 在终端中输入以下命令：
python --version
或者（在 macOS 和部分 Linux 系统上更推荐）：
python3 --version
如果安装成功，你会看到类似
Python 3.11.4的输出，如果提示'python' is not recognized...，说明环境变量没有配置好,请跳到第五步。 -
检查 pip (Python 包管理器)
pip是 Python 的包安装工具，用来安装第三方库（如 NumPy, Pandas 等）,输入以下命令检查：pip --version
或者：
pip3 --version
如果看到类似
pip 23.1.2 from ...的输出，说明 pip 也安装成功了。
第五步：配置环境变量 (如果需要)
只有当你在第四步验证时，系统提示 'python' is not recognized as an internal or external command... 时，才需要执行此步骤。
Windows 环境变量配置
- 在 Windows 搜索栏中搜索“编辑系统环境变量”,然后打开它。
- 在弹出的“系统属性”窗口中，点击右下角的“环境变量...”按钮。
- 在下方的“系统变量”区域，找到名为
Path的变量，选中它，然后点击“编辑...”。 - 在“编辑环境变量”窗口中，点击“新建”。
- 将 Python 的安装路径和 Scripts 路径添加进去，路径通常是：
C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX(XX是你的版本号，如 Python311)C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\Scripts- 提示：如果你在安装时勾选了 "Add python.exe to PATH",这一步通常已经自动完成了。
- 依次点击“确定”保存所有更改。
- 非常重要：关闭所有已打开的命令行窗口，然后重新打开一个新的，再执行
python --version命令。
第六步：选择一个代码编辑器
Python 代码可以用任何文本编辑器编写，但使用专业的代码编辑器能极大地提高你的效率，它们提供语法高亮、代码补全、调试等功能。
强烈推荐：Visual Studio Code (VS Code)
- 下载: 访问 https://code.visualstudio.com/ 下载并安装。
- 安装扩展: 打开 VS Code，点击左侧的扩展图标（四个方块），搜索并安装以下两个核心扩展：
- Python: 由 Microsoft 官方提供，提供智能代码补全、语法检查、调试等功能。
- Chinese (Simplified) Language Pack: 如果你希望使用中文界面,可以安装这个语言包。
第七步：进阶学习 - 使用虚拟环境和管理多个 Python 版本
为什么需要虚拟环境？
当你开始写多个项目时,可能会遇到这样的情况：
- 项目 A 需要一个旧版本的库。
- 项目 B 需要一个新版本的库。
如果直接在系统全局安装这些库，版本之间会发生冲突，虚拟环境可以为每个项目创建一个独立的、隔离的 Python 环境,完美解决这个问题。
如何使用 venv 创建虚拟环境？
venv 是 Python 3.3+ 自带的虚拟环境模块,无需额外安装。
-
打开终端,进入你的项目文件夹。
# 创建一个名为 my_project 的文件夹并进入 mkdir my_project cd my_project
-
创建虚拟环境：
# 在当前目录下创建一个名为 venv 的文件夹来存放虚拟环境 python3 -m venv venv
- 在 Windows 上，
python命令可用，也可以用python -m venv venv。
- 在 Windows 上，
-
激活虚拟环境：
- Windows (CMD):
venv\Scripts\activate
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
激活成功后，你的终端提示符前面会出现
(venv)字样,表示你当前正在虚拟环境中。
- Windows (CMD):
-
在虚拟环境中工作：
- 现在当你用
pip install安装的包，只会被安装到这个venv环境中，不会影响全局 Python。 - 你可以在这里运行你的 Python 脚本：
python your_script.py
- 现在当你用
-
退出虚拟环境： 当你完成工作后,只需在终端中输入：
deactivate
如何管理多个 Python 版本？
有时你可能需要同时使用 Python 3.8 和 Python 3.11 来测试不同的项目,这时可以使用版本管理工具。
-
对于 macOS 和 Linux: 推荐使用
pyenv。- 安装和配置请参考其官方文档：https://github.com/pyenv/pyenv
pyenv可以让你轻松安装、切换和设置不同版本的 Python。
-
对于 Windows: 推荐使用
pyenv-win。- 它是
pyenv在 Windows 上的移植版。 - 安装和配置请参考其 GitHub 页面：https://github.com/pyenv-win/pyenv-win
- 它是
常见问题与解答 (FAQ)
Q: 安装时提示 "Access is denied" 或需要管理员权限怎么办？
A: 这通常是因为你的用户账户没有足够的权限，在 Windows 上，右键点击安装程序 .exe 文件，选择“以管理员身份运行”，在 macOS/Linux 上，安装 .pkg 或使用 sudo 命令时需要输入用户密码。
Q: 我在终端输入 python，但出来的是 Python 2，怎么办？
A: 这说明你的系统环境变量中，Python 2 的路径在 Python 3 的前面,你有两个选择：
- 永远使用
python3命令来调用 Python 3。 - 按照“配置环境变量”的教程，调整
Path变量中 Python 3 路径的顺序，将其移到 Python 2 路径的前面。（不推荐，可能会破坏依赖 Python 2 的旧系统）。
Q: pip install 时提示 "Permission denied" 或 "ERROR: Could not install packages due to an OSError"
A: 这是因为你试图在全局 Python 环境中安装包，而你的用户没有权限。最佳实践是： 先创建并激活一个虚拟环境，然后在虚拟环境中使用 pip install，如果一定要全局安装，可以在命令前加上 sudo (macOS/Linux) 或以管理员身份运行 (Windows)。
Q: 我应该安装 32 位 (x86) 还是 64 位 (x86-64) 的 Python？ A: 除非你有特殊的老旧软件或硬件限制，否则请始终选择 64 位版本。 现代电脑几乎都是 64 位，64 位 Python 可以使用更多内存，性能更好,兼容性也更广。
恭喜你！现在你已经成功安装了 Python，并准备好开始你的编程之旅了！下一步可以尝试学习 Python 的基础语法，并尝试用 VS Code 编写并运行你的第一个 "Hello, World!" 程序。
