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 系统满足以下要求：

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 安装时自动配置的环境变量：

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

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

   

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

   

   • python 安装目录：如 d:\dev\python
   • scripts 目录：如 d:\dev\python\scripts

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

五、验证安装

安装完成后，打开 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' 不是内部或外部命令：

可能原因及解决方案：

1. 环境变量未配置：安装时未勾选 “add python to path”

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

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

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

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

   dir d:\dev\python312\python.exe

9.2 pip 命令无法识别

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

可能原因及解决方案：

1. scripts 目录未加入 path：检查环境变量 path 中是否包含 d:\dev\python312\scripts

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

   • 解决方案：通过以下命令重新安装 pip：

   python -m ensurepip --default-pip

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

   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，通过以下命令指定版本：

   py -3.12 script.py    # 使用 python 3.12 执行脚本
   py -3.10 script.py    # 使用 python 3.10 执行脚本

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

   python -m venv myenv        # 创建虚拟环境
   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/

总结

到此这篇关于python安装详细教程及常见问题排查的文章就介绍到这了,更多相关python安装教程内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！