python 的安装(详细教程)

文章目录

• 一、简介
• 二、安装前准备
• • 2.1 系统要求
  • 2.2 检查是否已安装 Python
  • 2.3 说明
• 三、下载 Python
• • 3.1 官方下载
  • 3.2 选择安装包
• 四、安装 Python
• • 4.1 安装包安装（推荐）
  • • 4.1.1 自定义安装（Customize installation）
  • 4.2 验证环境变量
• 五、验证安装
• 六、使用 pip 管理第三方库
• • 6.1 查看已安装的包
  • 6.2 安装第三方库
  • 6.3 查看包信息
  • 6.4 卸载包
• 七、配置国内镜像源（推荐）
• • 7.1 临时使用镜像源
  • 7.2 永久配置镜像源
• 八、常用 Python 命令速查表
• 九、常见问题排查
• • 9.1 python 命令无法识别
  • 9.2 pip 命令无法识别
  • 9.3 pip install 下载速度慢
  • 9.4 多版本 Python 冲突

一、简介

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

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

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

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

二、安装前准备

2.1 系统要求

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

2.2 检查是否已安装 Python

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

python –version
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) 即可。

四、安装 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 后，进入可选功能页面：

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

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

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

安装完成后，点击 Close。

4.2 验证环境变量

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

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

五、验证安装

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

python –version

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

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

pip –version

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

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

六、使用 pip 管理第三方库

6.1 查看已安装的包

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

pip list

6.2 安装第三方库

安装指定的 Python 包：

pip install requests

安装指定版本：

pip install requests==2.31.0

6.3 查看包信息

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

pip show requests

6.4 卸载包

卸载指定的 Python 包：

pip uninstall requests

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

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

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

7.1 临时使用镜像源

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

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

7.2 永久配置镜像源

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

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

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

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host = mirrors.aliyun.com

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

常用国内镜像源汇总：

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

八、常用 Python 命令速查表

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

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

九、常见问题排查

9.1 python 命令无法识别

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

可能原因及解决方案：

9.2 pip 命令无法识别

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

可能原因及解决方案：

9.3 pip install 下载速度慢

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

解决方案：

9.4 多版本 Python 冲突

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

解决方案：

参考文献：

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

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

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

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