python 的安装(详细教程)

---

一、简介

官网：https://www.python.org/

Python 是一种广泛使用的高级编程语言，由 Guido van Rossum 于 1991 年首次发布。Python 以简洁优雅的语法、强大的生态库和跨平台特性著称，被广泛应用于 Web 开发、数据分析、人工智能、自动化运维、科学计算等领域。

Python 的主要特点和用途包括：

1. 语法简洁易读：Python 使用缩进来划分代码块，代码风格清晰直观，非常适合编程初学者入门。

2. 丰富的标准库和第三方库：Python 拥有庞大的包管理工具 pip，可轻松安装数以万计的第三方库，覆盖 Web、数据科学、机器学习等各个领域。

3. 跨平台：Python 可在 Windows、macOS、Linux 等多种操作系统上运行，同一份代码无需修改即可在不同平台上执行。

4. 多版本共存管理：Python 2 和 Python 3 在语法上存在较大差异，实际开发中可能需要在同一台机器上管理多个 Python 版本。

5. 社区活跃：Python 拥有全球最大的开发者社区之一，遇到问题时可以方便地查阅文档和获取社区支持。

说明：Python 2 已于 2020 年 1 月 1 日 正式停止维护（EOL），目前官方推荐使用 Python 3。本文以 Python 3 的安装与配置为主。

---

二、安装前准备

2.1 系统要求

在安装 Python 之前，请确认你的 Windows 系统满足以下要求：

要求项	最低配置
操作系统	Windows 7 SP1 及以上（推荐 Windows 10/11）
系统架构	64 位（推荐）
内存	2 GB 可用内存
磁盘空间	至少 200 MB 可用空间

2.2 检查是否已安装 Python

在 CMD 中执行以下命令，检查系统中是否已存在 Python：

1. python --version
2. python3 --version

复制代码

• 如果输出版本号（如 Python 3.12.x），说明系统中已安装 Python。
• 如果提示 'python' 不是内部或外部命令，说明尚未安装或未配置环境变量。

2.3 说明

• Windows 系统不自带 Python，需要手动下载安装。
• 安装时建议选择 Add Python to PATH（添加到环境变量），省去手动配置的步骤。
• 如果系统中已安装旧版 Python，建议先卸载或通过多版本管理工具进行管理。

---

三、下载 Python

3.1 官方下载

Python 官方下载地址：

• 官网首页：https://www.python.org/
  

• 下载页面：https://www.python.org/downloads/
  

• Windows 专用下载页：https://www.python.org/downloads/windows/
  

打开下载页面后，选择最稳定的版本（如 Python 3.12.x），点击 Download 按钮。

3.2 选择安装包

在下载页面中，Windows 版本提供多种安装包：

安装包	说明	推荐
Windows installer (64-bit)	标准安装包，适用于大多数 64 位 Windows 系统	推荐
Windows installer (32-bit)	适用于 32 位 Windows 系统	仅在 32 位系统上使用
Windows embeddable package	嵌入式版本，不包含 pip，适合嵌入其它程序	高级用户
Windows installer (ARM64)	适用于 ARM 架构的 Windows 设备	ARM 设备用户

提示：绝大多数用户选择 Windows installer (64-bit) 即可。

---

四、安装 Python

4.1 安装包安装（推荐）

双击下载的安装包（如 python-3.12.x-amd64.exe

将下载好的安装包找一个目录存放，例如：D:\dev\python\install-package

双击安装包运行，进入安装向导：

勾选 Add python.exe to PATH（非常重要！），这一步会自动将 Python 添加到系统环境变量中。

• Use admin privileges when installing py.exe：在windows系统中，管理员账户Administrator具有最高的访问权限，有访问其它账户的权限，而个人账户之间是没有互相访问权限的。该项勾选，以管理员权限安装python的可执行程序。以管理员权限安装python，其它windows账户(User)登录系统后都可以使用python。若该项不勾选，且当前账户是个人账户，安装python后，其它非管理员账户登录到windows系统不能使用这个账户安装的python。
• Add python.exe to PATH：该项勾选，添加python到windows的系统路径，方便操作系统自动识别。

点击 “Install Now”（默认安装）或 “Customize installation”（自定义安装）。

提示：建议选择 Customize installation，可以自定义安装路径和可选组件。

4.1.1 自定义安装（Customize installation）

点击 Customize installation 后，进入可选功能页面：

可选功能	说明	建议
Documentation	Python 官方文档	勾选
pip	Python 包管理工具	勾选（必选）
tcl/tk and IDLE	Python 自带的 GUI 工具包和 IDE	根据需要
Python test suite	Python 标准库测试套件	可不勾选
py launcher	用于在不同 Python 版本之间切换的启动器	勾选
for all users	为所有用户安装（需要管理员权限）	根据需要

点击 Next，进入高级选项页面：

高级选项	说明	建议
Install for all users	为系统所有用户安装	根据需要
Associate files with Python	关联 .py 文件	勾选
Create shortcuts	创建桌面快捷方式	根据需要
Add Python to environment variables	添加环境变量	勾选（必选）
Precompile standard library	预编译标准库	勾选（加快导入速度）

选择安装路径（例如：D:\dev\python），点击 Install，等待安装完成。

注意：建议将 Python 安装到非系统盘（如 D 盘），避免权限问题。

安装完成后，点击 Close。

4.2 验证环境变量

安装完成后，如果安装时勾选了 Add Python to environment variables，环境变量会自动配置好。以下是 Python 安装时自动配置的环境变量：

环境变量	说明	示例值
Path（追加）	Python 安装目录和 Scripts 目录	D:\dev\python、D:\dev\python\Scripts

如果需要手动配置环境变量，请参照以下步骤：

1. 右键 此电脑（我的电脑） → 属性 → 高级系统设置 → 环境变量

2. 在 系统变量 中找到 Path，选中后点击 编辑，新增以下路径：

   • Python 安装目录：如 D:\dev\python
   • Scripts 目录：如 D:\dev\python\Scripts

3. 配置完成后，关闭所有已打开的 CMD 窗口，重新打开一个新的 CMD 窗口使环境变量生效。

---

五、验证安装

安装完成后，打开 CMD 命令窗口（Win + R 输入 cmd），执行以下命令验证安装是否成功：

1. python --version

复制代码

如果输出版本号（例如：Python 3.12.9），说明 Python 安装成功。

继续验证 pip（Python 包管理工具）：

1. pip --version

复制代码

如果输出版本号（例如：pip 24.0 from ...），说明 pip 安装成功。

提示：如果提示 'python' 不是内部或外部命令，请检查环境变量是否正确配置，并重新打开 CMD 窗口再试。

---

六、使用 pip 管理第三方库

6.1 查看已安装的包

查看当前环境中已安装的所有 Python 包：

1. pip list

复制代码

6.2 安装第三方库

安装指定的 Python 包：

1. pip install requests

复制代码

安装指定版本：

1. pip install requests==2.31.0

复制代码

6.3 查看包信息

查看已安装包的详细信息：

1. pip show requests

复制代码

6.4 卸载包

卸载指定的 Python 包：

1. pip uninstall requests

复制代码

提示：如果安装速度较慢，建议配置国内镜像源（参见第七章）。

---

七、配置国内镜像源（推荐）

由于 PyPI（Python Package Index）官方源在国内访问较慢，建议配置国内镜像源以加速下载。

7.1 临时使用镜像源

在执行 pip install 时，通过 -i 参数临时指定镜像源：

1. pip install requests -i https://mirrors.aliyun.com/pypi/simple/

复制代码

7.2 永久配置镜像源

通过命令永久设置默认镜像源：

1. pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

复制代码

或手动创建/编辑配置文件 %APPDATA%\pip\pip.ini，添加以下内容：

1. [global]
2. index-url = https://mirrors.aliyun.com/pypi/simple/
4. [install]
5. trusted-host = mirrors.aliyun.com

复制代码

说明：以上使用的是阿里云提供的 PyPI 镜像源，是国内最稳定、最常用的 Python 镜像之一。

常用国内镜像源汇总：

镜像源	地址
阿里云	https://mirrors.aliyun.com/pypi/simple/
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple/
中国科技大学	https://pypi.mirrors.ustc.edu.cn/simple/
豆瓣	https://pypi.doubanio.com/simple/

配置完成后，再次执行 pip install 命令即可体验高速下载。

---

八、常用 Python 命令速查表

以下是 Python 环境下的常用命令：

操作	命令	说明
查看 Python 版本	python --version	查看当前安装的 Python 版本
进入交互模式	python	启动 Python 交互式解释器
运行脚本	python script.py	执行指定的 Python 脚本文件
查看 pip 版本	pip --version	查看 pip 的版本信息
安装第三方库	pip install	安装指定的 Python 包
卸载第三方库	pip uninstall	卸载指定的 Python 包
查看已安装的包	pip list	列出所有已安装的包
查看包信息	pip show	查看指定包的详细信息
更新包	pip install --upgrade	更新指定的包到最新版本
导出依赖	pip freeze > requirements.txt	导出当前环境的所有依赖
批量安装依赖	pip install -r requirements.txt	根据文件批量安装依赖
配置镜像源	pip config set global.index-url	设置默认 pip 镜像源

提示：退出 Python 交互模式可使用 exit() 命令或按 Ctrl + Z 后回车。

---

九、常见问题排查

9.1 python 命令无法识别

执行 python 命令时提示 'python' 不是内部或外部命令：

可能原因及解决方案：

1. 环境变量未配置：安装时未勾选 “Add Python to PATH”

   • 解决方案：手动将 Python 安装目录和 Scripts 目录添加到系统 Path 中（参见第四章 4.2 节）

2. CMD 未重启：安装完成后未关闭旧的 CMD 窗口

   • 解决方案：关闭所有 CMD / PowerShell 窗口后重新打开

3. 安装路径不正确：检查 Python 安装路径下是否存在 python.exe

   1. dir D:\dev\Python312\python.exe

   复制代码

9.2 pip 命令无法识别

执行 pip 命令时提示 'pip' 不是内部或外部命令：

可能原因及解决方案：

1. Scripts 目录未加入 Path：检查环境变量 Path 中是否包含 D:\dev\Python312\Scripts

2. pip 未安装：安装时未勾选 pip 组件

   • 解决方案：通过以下命令重新安装 pip：
   1. python -m ensurepip --default-pip

   复制代码

3. pip 版本过旧：尝试升级 pip

   1. python -m pip install --upgrade pip

   复制代码

9.3 pip install 下载速度慢

使用 pip install 安装第三方库时下载速度极慢：

解决方案：

1. 配置国内镜像源（参见第七章）
2. 检查网络代理设置
3. 如果公司网络有限制，可联系网络管理员开放相关域名的访问权限

9.4 多版本 Python 冲突

系统中安装了多个 Python 版本，执行 python 命令时调用的不是期望的版本：

解决方案：

1. 调整 Path 顺序：在环境变量 Path 中，将期望版本的 Python 路径移到最前面

2. 使用 py launcher：安装时勾选 py launcher，通过以下命令指定版本：

   1. py -3.12 script.py # 使用 Python 3.12 执行脚本
   2. py -3.10 script.py # 使用 Python 3.10 执行脚本

   复制代码

3. 使用虚拟环境：为每个项目创建独立的虚拟环境（推荐）：

   1. python -m venv myenv # 创建虚拟环境
   2. myenv\Scripts\activate # 激活虚拟环境

   复制代码

---

参考文献：

Python 官方网站：https://www.python.org/

Python 官方文档：https://docs.python.org/zh-cn/3/

PyPI（Python 包索引）：https://pypi.org/

阿里云 PyPI 镜像：https://mirrors.aliyun.com/pypi/