2026 全网最详细 Python 安装教程（Windows / macOS / Linux 全平台）：从下载到跑通，每一步都很详细

🏷️ 标签：Python | 环境搭建 | 新手入门 | 虚拟环境 | uv | 排错
💡 适合人群：零基础小白、转行程序员、重装/升级 Python 的开发者、CI/CD 运维

为什么写这篇

我看过太多「Python 安装教程」——三行命令结束，新手照着做 90% 会卡在 python 不是内部或外部命令。

Python 安装真正的坑不在「下一步下一步」，而在：

• Windows 第一屏那个 Add to PATH 你不勾，后面全废
• macOS 你用了系统自带 Python，pip 装包直接 Operation not permitted
• Linux 你 make install 覆盖了系统 python3，yum/dnf 当场去世
• 你没用虚拟环境，装着装着把项目 A 的依赖搞崩了项目 B

这篇把每一个会让你卡住的细节都摊开讲。建议收藏，装之前从头看一遍。

⚠️ 版本说明：本文以 Python 3.14（2025-10 发布，当前稳定版）为默认示例。所有步骤对 3.10~3.14 通用。不要装 Python 2，官方 2020 年已停止维护。

目录

1. 你到底该装哪个版本？

三条铁律：

2. 安装前的 3 个检查

检查 1：看系统位数（Windows）

右键「此电脑」→ 属性 → 系统类型
显示「64 位操作系统」→ 下 64-bit 安装包
显示「32 位」→ 下 32-bit（极少，老机器）

检查 2：看是否已装 Python

# Windows PowerShell / macOS / Linux 终端都试一遍
python —version
python3 —version
where python # Windows 看路径
which python3 # macOS / Linux 看路径

如果显示了版本，记下路径——你可能已经有 Python，只是没加 PATH。

检查 3：看有没有包管理器（加速用）

# macOS 有没有 brew
brew –version
# 没有就去 https://brew.sh 装

# 任意系统有没有 uv
uv –version

3. Windows 安装（保姆级）

3.1 下载

💡 国内镜像（下得快）：https://mirrors.tuna.tsinghua.edu.cn/python/

3.2 安装第一屏（最关键！）

双击 .exe 弹出第一个窗口，内容大概这样：

┌─────────────────────────────────────────────────┐
│ Install Python 3.14.0 │
│ │
│ ☑ Use admin privileges when installing py.exe │
│ ☑ Add python.exe to PATH ←←← 必须勾！ │
│ │
│ (x) Install Now 默认装在 C:\\Users\\你\\AppData │
│ ( ) Customize installation 自定义（推荐） │
│ │
│ [Install Now] [Customize installation] │
└─────────────────────────────────────────────────┘

两个必做：

• ✅ 勾上 Add python.exe to PATH（不勾后面全白搭）
• ✅ 点 Customize installation（别用默认，装 C 盘容易权限炸）

3.3 第二屏：Optional Features

全勾，尤其是这两个：

• ✅ pip（包管理器，必装）
• ✅ tcl/tk and IDLE（GUI 库，学 tkinter 要）
• ✅ Python test suite（测试套件）
• ✅ py launcher（多版本切换器，Windows 神器）
• ✅ for all users（如果电脑就你一人用，勾上省事）

3.4 第三屏：Advanced Options

☑ Install for all users
☑ Associate files with Python
☑ Create shortcuts for installed applications
☑ Add Python to environment variables ← 勾上（双保险）
☑ Precompile standard library ← 勾上，启动快
☑ Download debugging symbols（可选，调试用）
☑ Download debug binaries（可选）

最重要的一步：修改 Install location

默认：C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Python\\Python314\\
建议改成：D:\\Python314\\

理由：C 盘容易遇到权限问题，且重装系统会没。D 盘干净。

3.5 点击 Install，等进度条

进度条跑完显示 Setup was successful → 关掉窗口。

3.6 验证（见第 7 章）

4. Windows 手动配置 PATH（没勾 Add to PATH 的救命指南）

如果你忘了勾，或者 python 命令敲了没反应，手动加：

步骤：

验证：

python —version
pip —version

5. macOS 安装

5.1 ❌ 不要用系统自带 Python

macOS 自带 python（2.7，已废弃）或 python3（旧版）。直接用会：

• 没 pip 或 pip 指向系统，装包 Operation not permitted
• 升级会搞崩系统工具（如 xcrun）

5.2 ✅ 方案 A：Homebrew（最干净，推荐）

# 1. 装 Homebrew（已装跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 更新并装 Python
brew update
brew install python@3.14

# 3. 验证
python3 –version
pip3 –version

# 4. 确保 brew 的 bin 在 PATH（Apple Silicon 一般在 ~/.zshrc 自动加）
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Apple Silicon（M1/M2/M3）Homebrew 装在 /opt/homebrew；Intel 在 /usr/local。装完 brew 会提示你加 PATH，照做。

5.3 ✅ 方案 B：官方安装包

5.4 ✅ 方案 C：pyenv（见第 11 章，多版本玩家用）

6. Linux 安装

6.1 Ubuntu / Debian（PPA 装新版）

sudo apt update
sudo apt install -y software-properties-common build-essential
sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.14 python3.14-venv python3.14-dev python3.14-distutils

# 验证
python3.14 –version
which python3.14

6.2 CentOS / Rocky / Alma（dnf）

sudo dnf install -y python3.14
# 若仓库没有，用源码编译（见 6.4）

6.3 验证 + 建软链（可选）

# 不想每次敲 python3.14，可以加个别名
echo "alias python='python3.14'" >> ~/.bashrc
source ~/.bashrc

⚠️ 不要改系统 /usr/bin/python3 软链指向 3.14，yum/dnf 依赖旧版会挂。用别名或 pyenv 局部切换更安全。

6.4 源码编译（最稳，通用所有发行版）

# 1. 装编译依赖
# Ubuntu/Debian:
sudo apt install -y build-essential libssl-dev zlib1g-dev \\
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \\
libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev

# CentOS/Rocky:
sudo dnf install -y gcc openssl-devel bzip2-devel readline-devel \\
sqlite-devel wget xz-devel tk-devel libffi-devel zlib-devel

# 2. 下载源码
cd /tmp
wget https://www.python.org/ftp/python/3.14.0/Python-3.14.0.tgz
tar xzf Python-3.14.0.tgz
cd Python-3.14.0

# 3. 配置（enable-optimizations 跑测试会慢但性能更好）
./configure –enable-optimizations –prefix=/usr/local/python314

# 4. 编译（-j 用所有核，几十分钟）
make -j$(nproc)

# 5. 安装（关键：用 altinstall，别用 install！）
sudo make altinstall

# 6. 验证
/usr/local/python314/bin/python3.14 –version

🚨 make altinstall 不是 make install：install 会覆盖 /usr/bin/python3，系统包管理器（yum/dnf/apt）直接瘫痪。altinstall 只装 python3.14，互不影响。

7. 验证安装是否成功

通用三步：

# 步骤 1：版本
python –version # Windows
python3 –version # macOS / Linux

# 步骤 2：进交互模式
python
>>> print("hello")
hello
>>> 1 + 1
2
>>> exit() # 或 Ctrl+Z 回车（Windows）/ Ctrl+D（mac/Linux）

# 步骤 3：pip 可用
pip –version
# 应显示 pip 24.x from … (python 3.14)

失败现象对照表：

8. pip 包管理

8.1 基础命令

pip install requests # 装最新版
pip install requests==2.31.0 # 指定版本
pip install "requests>=2.30" # 最低版本
pip install -r requirements.txt # 批量装（项目标配）
pip list # 看已装
pip show requests # 看某包详情
pip uninstall requests # 卸载
pip freeze > requirements.txt # 冻结当前环境依赖（交付用）

8.2 换国内镜像（必做，否则下载慢到怀疑人生）

# 临时用
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

# 永久配置（推荐）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

国内镜像源清单：

8.3 升级 pip 自身

python -m pip install –upgrade pip

9. uv：2026 年首选包管理器

uv 是 Astral（Ruff 同款团队）用 Rust 写的，比 pip 快 10~100 倍，还内置虚拟环境、版本管理、Python 安装。

9.1 安装 uv

# 方式一：pip（ irony 但方便）
pip install uv

# 方式二：官方脚本（推荐，不污染 pip）
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

9.2 日常使用

# 建项目（自动建虚拟环境 + pyproject.toml）
uv init myproject
cd myproject

# 加依赖（自动解析 + 装包，一条顶 pip + venv）
uv add requests

# 跑脚本（在隔离环境里）
uv run main.py

# 装多个
uv add flask pandas numpy

# 移除
uv remove requests

9.3 uv 还能装 Python 本身

uv python install 3.14
uv python install 3.12
uv python pin 3.14 # 锁定项目版本

💡 新项目无脑用 uv，告别裸 pip + 手动 venv 的繁琐。

10. 虚拟环境 venv

10.1 为什么必须

痛点场景：项目 A 要 Django 4，项目 B 要 Django 5。装一起就冲突，谁也跑不了。

虚拟环境 = 每个项目独立「沙箱」，依赖互不干扰。

10.2 创建与激活

# 创建（会在当前目录生成 venv/ 文件夹）
python -m venv venv

# 激活
source venv/bin/activate # macOS / Linux / Git Bash
venv\\Scripts\\activate # Windows CMD
venv\\Scripts\\Activate.ps1 # Windows PowerShell

# 激活后命令行前缀变成 (venv)
(venv) pip install flask
(venv) python app.py

# 退出
deactivate

⚠️ Windows PowerShell 激活报错？

无法加载文件，因为在此系统上禁止运行脚本

解决（管理员 PowerShell 执行一次）：

Set-ExecutionPolicy –ExecutionPolicy RemoteSigned –Scope CurrentUser

10.3 虚拟环境常见报错

10.4 .gitignore 别忘了

venv/
.venv/
__pycache__/
*.pyc

11. 版本管理 pyenv

需要同时跑 3.12 / 3.14？用 pyenv 切。

11.1 macOS / Linux

# 装 pyenv
brew install pyenv # macOS
# 或
curl -fsSL https://pyenv.run | bash

# 装多版本
pyenv install 3.12.0
pyenv install 3.14.0

# 全局默认
pyenv global 3.14.0

# 单个项目局部（在项目目录执行，生成 .python-version）
pyenv local 3.12.0

11.2 Windows（pyenv-win）

pip install pyenv-win
pyenv install 3.14.0
pyenv global 3.14.0

11.3 原理

pyenv 通过 shim 拦截 python 命令，按当前目录的 .python-version 自动选版本。不碰系统 Python，安全。

12. Anaconda / Miniconda

做 AI / 数据科学，装 Anaconda 一步到位（自带 numpy/pandas/jupyter/scipy）。

# Miniconda 安装后
conda create -n myenv python=3.14
conda activate myenv
conda install numpy pandas matplotlib

# 导出环境
conda env export > environment.yml

⚠️ Conda 和 pip 混用易冲突。优先级：conda 能装的用 conda，没有的再用 pip。混用后环境坏了就 conda env remove -n myenv 重建。

13. IDE 配置（截图级步骤）

13.1 VS Code（最流行）

13.2 PyCharm（功能全）

14. 第一个程序 + 项目结构规范

14.1 第一个程序

# hello.py
def greet(name: str) –> str:
return f"你好，{name}！欢迎来到 Python 世界 🐍"

if __name__ == "__main__":
print(greet("小二"))

运行：

python hello.py
# 输出：你好，小二！欢迎来到 Python 世界 🐍

14.2 推荐项目结构

my_project/
├── venv/ # 虚拟环境（不提交 git）
├── src/
│ └── my_project/
│ ├── __init__.py
│ └── main.py
├── tests/
│ └── test_main.py
├── requirements.txt # 依赖锁
├── .gitignore
└── README.md

生成依赖锁：

pip freeze > requirements.txt

别人拿到项目一键复现：

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

15. 常见问题 20 连（高频踩坑 Q&A）

Q1：Windows 敲 python 没反应？
→ PATH 没加。重装勾 Add to PATH，或手动加（第 4 章）。

Q2：pip 不是内部命令？
→ Scripts 没进 PATH。加 Python314\\Scripts 到环境变量。

Q3：下载 pip 包超时 / 巨慢？
→ 换国内镜像（第 8.2 章）。

Q4：SSL 证书错误 CERTIFICATE_VERIFY_FAILED？
→ macOS 官方包装完要运行一次 Install Certificates.command（在 Python 安装目录里）；或临时 pip install –trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple pkg。

Q5：ModuleNotFoundError: No module named 'xxx'？
→ 你装在 A 环境，跑在 B 环境。先 which python 确认跑的是哪个，再在该环境 pip install。

Q6：Linux 装包报错 error: command 'gcc' failed？
→ 缺编译工具。sudo apt install build-essential 或 CentOS sudo dnf groupinstall "Development Tools"。

Q7：Permission denied？
→ 别用 sudo pip！用虚拟环境。sudo 装包污染系统 Python。

Q8：externally-managed-environment 错误（新版 Linux）？
→ PEP 668 保护机制，禁止裸装系统 Python。解决：用 venv 或 pip install –break-system-packages（不推荐后者）。

Q9：多个 Python 版本混乱？
→ 用 pyenv（第 11 章），或明确用 python3.14 全路径。

Q10：pip install 装到哪了？
→ pip show 包名 看 Location。优先确认在 venv 里。

Q11：PowerShell 激活 venv 报脚本禁止运行？
→ Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（第 10.2 章）。

Q12：Mac M 芯片装包报 architecture mismatch？
→ 混用了 x86 和 arm 的 Python。统一用 arm64 版（brew 默认就是）。arch 命令看当前架构。

Q13：pip 升级后 Cannot uninstall 'xxx'？
→ 系统包受保护。用 –user 或虚拟环境。

Q14：Jupyter 里 import 找不到自己装的包？
→ Jupyter 内核和终端 Python 不是同一个。在 venv 里 pip install ipykernel 然后 python -m ipykernel install –user –name myenv。

Q15：Windows 路径有中文/空格导致 pip 报错？
→ 安装路径别用中文和空格，用 D:\\Python314。

Q16：代理环境下 pip 失败？
→ pip install –proxy http://user:pass@host:port pkg 或设环境变量 HTTP_PROXY / HTTPS_PROXY。

Q17：pip 装包装一半断了？
→ 重试即可，pip 会接着下；断网包损坏就 pip cache purge 清缓存。

Q18：怎么彻底卸载 Python（Windows）？
→ 设置 → 应用 → 找 Python 3.14 → 卸载；再用 Everything 搜残留 Python314 删干净；最后清 PATH。

Q19：CI/CD 里怎么装 Python？
→ GitHub Actions 用 actions/setup-python@v5；GitLab 用 image: python:3.14。见第 16 章。

Q20：装完想确认是 64 位还是 32 位？

import struct
print(struct.calcsize("P") * 8) # 输出 64 或 32

16. 生产环境 / CI 注意事项

16.1 永远用虚拟环境或容器

FROM python:3.14-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install –no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "main.py"]

16.2 GitHub Actions 装 Python

– uses: actions/setup–python@v5
with:
python-version: "3.14"
cache: "pip"
– run: pip install –r requirements.txt

16.3 服务器别用 sudo pip

用 –user 或 venv：

python -m venv /opt/myapp/venv
source /opt/myapp/venv/bin/activate
pip install -r requirements.txt

17. 总结速查表

装完 Python 只是起点。环境这块踩过的坑，这篇文章基本覆盖全了。

有问题评论区见 👇 觉得有用点个赞，转发给还在卡安装的同学。

本文为「小二代码铺」原创技术干货，关注公众号也可以，转载请注明出处。