Windows下Python 3安装与环境变量配置、pip镜像源、多版本

脚本专家

适用场景与安装前检查

本文面向Windows下需要落地Python 3开发环境的开发者，重点不是单纯下载安装包，而是围绕PATH识别、pip包管理、镜像源加速、多版本冲突和虚拟环境隔离展开。原文信息显示，Python可在Windows、macOS、Linux上运行，Python 2已于2020年1月1日停止维护，当前应以Python 3为主。

安装前先确认系统条件：Windows 7 SP1及以上，推荐Windows 10/11；64位架构优先；至少2GB可用内存和200MB磁盘空间。可在CMD中检查是否已有Python：

2. python --version
3. python3 --version

复制代码

如果输出版本号，例如Python 3.12.x，说明已安装；如果提示python不是内部或外部命令，通常说明尚未安装或PATH未配置。Windows不自带Python，需要手动安装，建议安装时勾选Add Python to PATH，减少手工配置环境变量的步骤。

安装包选择与安装选项

官方下载入口包括python.org首页、Downloads页面和Windows专用下载页。原文建议选择稳定的Python 3.12.x。Windows安装包有多种类型：Windows installer 64-bit适用于大多数64位系统，是推荐选择；32-bit仅用于32位系统；embeddable package是嵌入式版本，不包含pip，适合嵌入其它程序；Windows installer ARM64用于ARM架构Windows设备。

运行安装包后，关键选项有两个。Add python.exe to PATH用于把Python加入系统路径，方便命令提示符自动识别；Use admin privileges when installing py.exe用于以管理员权限安装py启动器，勾选后其它Windows账户登录系统也可以使用Python，不勾选且当前为个人账户时，其它非管理员账户可能无法使用该账户安装的Python。

建议选择Customize installation自定义安装。可选功能中，pip为包管理工具，必须勾选；Documentation为官方文档；tcl/tk and IDLE为自带GUI工具包和IDE，按需选择；Python test suite为标准库测试套件，可不勾选；py launcher用于多版本切换，建议勾选；for all users按需选择。高级选项中，Associate files with Python建议勾选，Add Python to environment variables为必选，Precompile standard library可勾选以加快标准库导入。安装路径可放在非系统盘，例如D:\dev\python，以减少权限问题。

环境变量与安装验证

如果安装时勾选了Add Python to environment variables，PATH会自动追加Python安装目录和Scripts目录，例如D:\dev\python、D:\dev\python\Scripts。若需手动配置，可进入此电脑属性、高级系统设置、环境变量，在系统变量Path中新增这两个路径。配置后必须关闭所有已打开的CMD窗口，再重新打开使环境变量生效。

验证安装：

2. python --version
3. pip --version

复制代码

正常应输出版本号，例如Python 3.12.9和pip 24.0 from ...。如果python命令仍无法识别，优先检查环境变量是否包含安装目录，并确认CMD窗口已重启。

pip管理第三方库

pip用于安装、查看和卸载第三方库。常用操作如下：

2. pip list
3. pip install requests
4. pip install requests==2.31.0
5. pip show requests
6. pip uninstall requests

复制代码

pip list列出当前环境已安装包；pip install安装指定包；requests==2.31.0用于指定版本；pip show查看包详细信息；pip uninstall卸载包。如果安装速度慢，可进入镜像源配置，临时指定或永久设置默认源。

国内镜像源配置

PyPI官方源在国内访问可能较慢。临时使用镜像源可通过-i参数：

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

复制代码

永久设置默认镜像源：

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

复制代码

也可手动创建或编辑%APPDATA%\pip\pip.ini，写入：

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

复制代码

原文列出的国内镜像源包括阿里云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即可。

常用命令与依赖导出

除安装和卸载外，更新包、导出依赖和批量安装依赖是项目开发中的常见动作：

2. pip install --upgrade <package>
3. pip freeze > requirements.txt
4. pip install -r requirements.txt

复制代码

进入Python交互模式可用python，退出可执行exit()或按Ctrl+Z后回车；运行脚本使用python script.py。上述命令可用于开发调试和项目依赖复现，但应在目标虚拟环境中执行，避免污染全局环境。

常见故障排查

1. python命令无法识别。常见原因是安装时未勾选Add Python to PATH，或CMD未重启，或安装路径不正确。排查时先确认Path中是否有Python安装目录和Scripts目录，再检查安装路径下是否存在python.exe：

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

复制代码

2. pip命令无法识别。先检查Path是否包含Scripts目录，例如D:\dev\Python312\Scripts；若pip未安装，可用python -m ensurepip --default-pip重新安装；pip版本过旧时可用python -m pip install --upgrade pip升级。
3. pip install下载速度慢。优先配置国内镜像源；同时检查网络代理设置；公司网络有限制时，可联系网络管理员开放相关域名访问权限。
4. 多版本Python冲突。系统中存在多个版本时，python命令可能指向非预期版本。可在环境变量Path中把目标版本路径移到最前面；也可使用py launcher指定版本：

2. py -3.12 script.py
3. py -3.10 script.py

复制代码

更推荐为项目创建独立虚拟环境：

2. python -m venv myenv
3. myenv\Scripts\activate

复制代码

虚拟环境可以隔离项目依赖，配合pip freeze和pip install -r requirements.txt完成依赖记录与恢复。多版本场景下，PATH顺序决定命令解析结果，py launcher和venv分别解决“选解释器”和“隔离依赖”两类问题。

总体来看，Windows下Python 3环境是否可用，不只取决于安装包是否运行完成，还取决于PATH、Scripts目录、pip组件和命令窗口刷新状态。按“安装选项—环境变量—版本验证—pip源—多版本隔离”的顺序排查，能覆盖原文涉及的主要配置与故障场景。