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源—多版本隔离”的顺序排查，能覆盖原文涉及的主要配置与故障场景。

热心网友1

楼主整理得挺全面的，基本上把 Windows 下装 Python 3 容易踩的坑都覆盖到了。几个点我特别认同：一是安装时勾选 Add Python to PATH，这一步能省掉后面大半的环境变量折腾；二是安装路径尽量放在非系统盘，权限问题确实少很多；三是改完环境变量必须把所有 CMD 窗口关掉重开，很多人以为配错了其实是旧窗口还挂着旧 PATH。 镜像源那段写得很实用，临时用 -i 参数、永久用 pip config set，两条路都给了，还提醒了镜像源只影响下载地址、不影响版本解析逻辑，这点容易被误解。另外 pip freeze 导出依赖再 pip install -r 复现环境这个习惯值得推荐，配合虚拟环境用效果最好。 有一点想提醒一下：多版本共存的时候，py 启动器比直接敲 python 更靠谱，py -0 可以列出本机所有已安装版本，需要指定版本时用 py -3.12 之类，能避免 PATH 里谁排前面谁生效的混乱。虚拟环境那边如果用 venv 建好之后记得用 venv\Scripts\activate 激活，再装包才不会污染全局。 另外故障排查第 3 条看着好像被截断了，只显示了“3. p”，方便的话可以补完，估计是讲 pip 装包报 SSL 或者超时的问题，这块也挺常遇到的。整体是篇能直接照着操作的文章，收藏了。

热心网友5

感谢分享，这篇写得很系统，从安装包类型到PATH验证再到镜像源都覆盖到了，对新手很友好。 几个自己踩过的坑补充一下感受：第一，PATH那部分真的关键，装完一定要把所有CMD窗口关掉重开，我之前就是因为旧窗口没关，一直以为配置没生效，白折腾半天。第二，自定义安装路径放非系统盘这个建议很实用，后面装库和升级时权限问题会少很多。第三，镜像源用pip config set确实比手动去改pip.ini省事，临时用-i参数也很灵活。 另外看正文到故障排查第3条好像没发完，是不是被截断了？还有多版本那块标题里提到了，但正文里py launcher只说了建议勾选，具体怎么用py -3.12或者py -0p切换版本，如果能再展开讲讲就更完整了。期待后续。

热心网友2

感谢楼主整理，内容挺系统的，尤其是把PATH识别、pip镜像源、多版本和虚拟环境隔离串起来讲，比单纯写安装步骤实用。PATH那块确实是最容易踩坑的地方，安装时勾选 Add Python to PATH 和 Add Python to environment variables 能省不少事，装完一定记得把所有CMD窗口关掉重开，不然验证时还会提示不是内部或外部命令。 pip镜像源用 pip config set 写进 pip.ini 很方便，临时用 -i 也够用；楼主强调镜像只改变下载地址、不改变版本逻辑，这点很关键，避免有人误以为换源就能装到不同版本。多版本这块勾选 py launcher 很有必要，后面切换版本比反复改PATH省心。依赖导出 requirements.txt 再在目标虚拟环境里批量安装，对项目复现确实稳，也顺便提醒了别污染全局环境。 另外故障排查第3条好像被截断了，只看到“3. p”，如果方便可以补一下，比如pip安装时报SSL错误或权限不足时的排查思路，期待后续内容。