Python 详细安装教程

本文将详细介绍 Windows、macOS、Linux 三大主流操作系统下 Python 的安装方法，包含环境变量配置、安装验证及 pip 基础使用。

一、安装前说明

核心原则：从官方渠道下载 最安全、最可靠的方式是从下载安装程序，避免从第三方站点下载带来的安全风险。

当前最新稳定版本为 Python 3.13.x 系列，推荐新手安装最新稳定版。

二、Windows 系统安装教程（推荐新手）

步骤 1：下载安装包

1. 访问
2. 选择 Windows installer (64-bit) 下载（绝大多数电脑都是 64 位系统）
3. 文件名格式类似：python-3.13.0-amd64.exe

步骤 2：运行安装程序

关键注意：安装界面最下方的复选框务必勾选

1. 双击下载的 .exe 安装包
2. 勾选界面底部的 "Add Python 3.xx to PATH"（非常重要，自动配置环境变量）
3. 有两个安装选项：
   • Install Now：默认安装，一键完成，安装到用户目录
   • Customize installation：自定义安装，可修改安装路径和组件

步骤 3：自定义安装（可选）

如果选择自定义安装：

第一页（可选功能）：默认全部勾选即可

• Documentation：离线文档
• pip：包管理工具（必选）
• tcl/tk and IDLE：图形界面库和自带编辑器
• Python test suite：测试套件
• py launcher：多版本管理启动器

第二页（高级选项）：

• 勾选 "Install for all users"（如需所有用户可用）
• 修改安装路径，建议放在非系统盘，如 D:\Python313
• 勾选 "Add Python to environment variables"
• 点击 Install 开始安装

步骤 4：完成安装

安装完成后，会出现 "Setup was successful" 提示。

• 可选：点击 "Disable path length limit" 解除 Windows 260 字符路径限制，推荐开启

步骤 5：验证安装

1. 按下 Win + R，输入 cmd 打开命令提示符
2. 输入以下命令验证：

python --version

显示类似 Python 3.13.0 即为安装成功

1. 验证 pip：

pip --version

提示：如果提示 "不是内部或外部命令"，说明环境变量未配置成功。可重新运行安装包选择 "Modify"，确保勾选了 PATH 选项。

三、macOS 系统安装教程

方法一：官方安装包（推荐新手）

1. 访问
2. 下载 macOS 64-bit universal2 installer（支持 Intel 和 Apple Silicon）
3. 双击下载的 .pkg 文件，按照安装向导一步步完成
4. 安装程序会自动配置好环境

验证安装： 打开终端（Terminal），输入：

python3 --version

注意：macOS 上命令通常是 python3 而非 python，避免与系统旧版本冲突。

方法二：Homebrew（推荐开发者）

如果你已安装 Homebrew，打开终端执行：

brew install python

安装完成后同样用 python3 --version 验证。

四、Linux 系统安装教程

大多数 Linux 发行版已预装 Python 3，可先检查版本：

python3 --version

Ubuntu / Debian 系列

sudo apt update
sudo apt install python3 python3-pip python3-dev

CentOS / Fedora / RHEL 系列

# Fedora
sudo dnf install python3 python3-pip python3-devel

# CentOS 7
sudo yum install python3 python3-pip

Arch Linux

sudo pacman -S python python-pip

五、pip 基础使用

pip 是 Python 的包管理工具，用于安装第三方库。

常用命令

# 查看 pip 版本
pip --version

# 安装包
pip install 包名

# 安装指定版本
pip install 包名==版本号

# 升级包
pip install --upgrade 包名

# 卸载包
pip uninstall 包名

# 列出已安装的包
pip list

# 导出已安装包列表
pip freeze > requirements.txt

# 从文件批量安装
pip install -r requirements.txt

国内镜像源加速

默认 pip 下载速度较慢，建议配置国内镜像：

临时使用：

pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

六、常见问题与解决

1. Windows 提示 "python 不是内部或外部命令"

• 原因：环境变量 PATH 未正确配置
• 解决：重新运行安装程序 → 选择 "Modify" → 确保勾选 "Add Python to PATH" → 完成后重启命令行

2. pip 命令不可用

• 原因：Scripts 目录未加入 PATH
• 解决：使用 python -m pip 替代 pip，或重新配置环境变量

3. 安装多个 Python 版本

• Windows：使用 py -3.12、py -3.13 切换不同版本
• macOS/Linux：使用 python3.12、python3.13 指定版本

4. 权限不足

• Windows：以管理员身份运行命令提示符
• macOS/Linux：命令前加 sudo（不推荐，建议使用虚拟环境）

七、后续建议

安装完成后，推荐搭配代码编辑器使用：

• VS Code：轻量强大，安装 Python 扩展即可
• PyCharm：专业 Python IDE，功能全面，社区版免费