本文基于 Python 官方文档与最新生态现状整理，所有命令均经过实测，可放心复制执行。
前言
很多新手在安装 Python 时，常被版本选择、环境变量配置、pip 下载龟速等问题劝退。本文将从零开始，手把手带你完成 Python 开发环境的完整搭建，所有步骤均真实可执行。
适用平台：Windows / macOS / Linux
一、准备工作：版本选择与下载
1.1 选哪个版本？
截至 2026 年，Python 官方推荐的稳定版本是 Python 3.12，生态最成熟、兼容性最好。如果你想尝鲜，也可以选择 Python 3.13 或 3.14。
新手建议：直接选 Python 3.12.x 最新版，稳定且资料最多。
1.2 下载安装包
打开浏览器，访问 Python 官网：Welcome to Python.org
进入官网后，页面会自动识别你的操作系统，点击 Downloads 即可下载对应版本的安装包。
-
Windows：下载
.exe安装包 -
macOS：下载
.pkg安装包 -
Linux：多数发行版已预装 Python，或使用包管理器安装
二、安装 Python（分平台详解）
2.1 Windows 平台
步骤一：运行安装程序
双击下载的 .exe 文件，启动安装向导。
⚠️ 最关键的一步： 在安装界面第一页底部，务必勾选 “Add Python to PATH” 。如果不勾选，后续需要手动配置环境变量，非常麻烦。
步骤二：选择安装方式
勾选 PATH 后，点击 “Install Now” 即可开始安装。几秒钟后安装完成。
如果你想自定义安装路径（比如不想装在 C 盘），可以点击 “Customize installation” 。
小贴士：安装路径建议不要包含空格或中文，比如
C:\Python312比默认的Program Files更稳妥。
步骤三：验证安装
按 Win + R，输入 cmd 回车打开命令提示符，输入以下命令：
bash
python --version
如果看到类似 Python 3.12.x 的输出，说明安装成功。如果提示“python 不是内部或外部命令”，说明 PATH 没有配置好，请重装并勾选“Add Python to PATH”。
2.2 macOS 平台
下载 .pkg 安装包后双击运行，按提示完成安装即可。
安装完成后打开终端（Terminal），输入：
bash
python3 --version
macOS 自带了 Python 2.x，所以需要用 python3 命令来调用新安装的 Python 3。
2.3 Linux 平台（以 Ubuntu/CentOS 为例）
大多数 Linux 发行版默认自带 Python，但可能是 Python 2.x 版本。安装 Python 3 的方法：
Ubuntu/Debian：
bash
sudo apt update sudo apt install python3 python3-pip -y
CentOS/RHEL：
bash
sudo yum install python3 python3-pip -y
验证安装：
bash
python3 --version pip3 --version
三、配置 pip 国内镜像源（必做！）
在国内使用 pip install 下载 Python 包时，官方源在国外，速度极慢甚至经常超时。配置国内镜像源可以大幅提升下载速度。
3.1 临时使用镜像源（推荐新手）
安装某个包时临时指定镜像源：
bash
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
示例：安装 requests 库
bash
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
这种方法适合偶尔安装包，但每次都要手动输入地址。
3.2 永久配置镜像源（一劳永逸）
方法一：使用 pip 命令配置（推荐）
bash
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
方法二：手动创建配置文件
-
Windows：在
C:\Users\<你的用户名>\pip\目录下创建pip.ini文件 -
macOS / Linux：在
~/.pip/目录下创建pip.conf文件
文件内容：
ini
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple
3.3 验证配置是否生效
bash
pip config list
如果输出中包含 global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'，说明配置成功。
3.4 其他国内镜像源（备用）
如果清华源不好用，可以换成以下任意一个：
| 镜像源 | 地址 |
|---|---|
| 阿里云 | Simple Index |
| 中科大 | Verifying - USTC Mirrors |
| 豆瓣 | https://pypi.douban.com/simple |
四、虚拟环境（每个项目必备！）
4.1 为什么要用虚拟环境？
在实际开发中，不同项目可能需要不同版本的第三方库。比如项目 A 需要 Django 2.0，项目 B 需要 Django 4.0——如果全部装在全球环境中，就会产生冲突。
虚拟环境就是为每个项目创建独立的 Python 运行环境，互不干扰。
4.2 使用 venv 创建虚拟环境
Python 3 自带 venv 模块，无需额外安装。
步骤一：创建虚拟环境
打开终端，进入你的项目目录，执行：
bash
python -m venv myenv
其中 myenv 是虚拟环境的名称，可以换成你喜欢的名字。
步骤二：激活虚拟环境
-
Windows（CMD）：
bash
myenv\Scripts\activate
-
Windows（PowerShell）：
bash
myenv\Scripts\Activate.ps1
-
macOS / Linux：
bash
source myenv/bin/activate
激活成功后，命令提示符前面会出现 (myenv) 字样。
步骤三：在虚拟环境中安装包
bash
pip install requests pip install flask
所有安装的包都会被隔离在虚拟环境中，不会影响全局环境。
步骤四：退出虚拟环境
bash
deactivate
4.3 导出和导入依赖清单
导出当前环境的所有依赖：
bash
pip freeze > requirements.txt
在新环境中一键安装所有依赖：
bash
pip install -r requirements.txt
这个功能在团队协作和项目部署时非常实用。
五、编写并运行第一个 Python 程序
5.1 方法一：交互式命令行
在终端中输入 python（Windows）或 python3（macOS/Linux）进入交互模式，然后输入：
python
print("Hello, World!")
看到输出 Hello, World! 即表示成功。输入 exit() 退出交互模式。
5.2 方法二：创建 .py 文件（推荐）
-
新建一个文本文件，命名为
hello.py -
写入以下代码：
python
print("Hello, World!") -
保存文件
-
在终端中进入文件所在目录，执行：
bash
python hello.py
或（macOS/Linux）：
bash
python3 hello.py
如果输出 Hello, World!，恭喜你，Python 开发环境已完全搭建成功！🎉
六、常见问题与解决方案
Q1：安装时忘记勾选“Add Python to PATH”怎么办？
解决方法：重装 Python，记得勾选即可。如果不想重装，可以手动添加环境变量：
-
右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
-
在“系统变量”中找到
Path，点击“编辑” -
添加 Python 安装目录（如
C:\Python312）和 Scripts 目录（如C:\Python312\Scripts）
Q2：pip 安装包时报错“SSL certificate”怎么办？
可以临时使用国内镜像源绕过：
bash
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
Q3：虚拟环境激活失败怎么办？
-
Windows PowerShell 如果提示“无法加载脚本”，需要修改执行策略：
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后再尝试激活。
-
确保在项目目录下执行激活命令，路径要正确。
Q4：电脑上同时有 Python 2 和 Python 3，怎么区分？
-
Windows：用
python一般指向 Python 3，用python2指向 Python 2 -
macOS/Linux：用
python3指向 Python 3，用python或python2指向 Python 2
建议在 macOS/Linux 上统一使用 python3 和 pip3 命令。
总结
至此，你已经完成了：
✅ Python 的下载与安装
✅ 环境变量的自动配置
✅ pip 国内镜像源的配置（提速 10 倍+）
✅ 虚拟环境的创建与使用
✅ 第一个 Python 程序的编写与运行
整个流程中最重要的两个“坑”：
-
安装时务必勾选“Add Python to PATH”
-
务必配置国内镜像源，否则 pip 下载会慢到怀疑人生
如果本文对你有帮助，欢迎点赞、收藏、评论，让更多小伙伴少走弯路！
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/2601_96879282/article/details/164291634
