Windows系统安装Python 3.10.6及环境变量配置指南

周叙
周叙
发布时间:2026-11-18 | 5人浏览过
原创

针对Windows系统详细讲解Python 3.10.6的下载、安装、PATH环境变量手动配置、多版本共存及常见启动异常排查的完整实用操作指南。

在Windows操作系统上完整部署Python 3.10.6,关键包含三个确定性步骤:从Python官方站点获取对应64位安装程序、在安装向导中启用PATH自动注册或规范完成自定义目录设置、以及在终端通过版本查询与执行路径比对确认环境就绪。Python 3.10.6作为Python 3.10生命周期内广受各类开源项目(如Stable Diffusion WebUI、深度学习工具链及各类自动化脚本框架)指定的标准兼容版本,其运行稳定性和第三方C/C++编译依赖包的匹配度极高。本文将按实际操作流程,逐一讲解从安装包下载、向导选项设置、手动配置系统环境变量Path到排查终端异常响应的完整操作方案。

一、安装前准备与安装包获取

在Windows系统下安装Python前,需要先明确底层操作系统的架构版本。Python 3.10系列全面停止了对Windows 7及更早系统的支持,当前部署环境需为Windows 10(1607版本及以上)或Windows 11的64位版本。为了确保运行效率以及后期安装NumPy、PyTorch等科学计算包时的二进制轮子(Wheel)兼容性,务必选择64位(amd64)安装文件。

获取安装包的推荐途径是访问Python官方下载档案页面:

  • 官方历史版本列表:访问 https://www.python.org/downloads/windows/,向下滚动页面找到 Python 3.10.6 - Aug. 2, 2022 发行板块。
  • 目标文件选择:在文件列表中找到 Windows installer (64-bit),对应的直接下载文件名应为 python-3.10.6-amd64.exe。
选型注意

请勿下载名为 Windows embeddable package (64-bit) 的压缩包。该嵌入式版本去除了pip包管理器、IDLE交互环境以及控制台环境配置文件,仅用于软件二次打包嵌入,无法作为日常开发的主运行环境。

二、安装向导执行与核心选项配置

下载完成后,双击运行 python-3.10.6-amd64.exe。进入安装向导初始界面后,最下方的复选框是整个安装流程中最关键的决策点。

Windows系统安装Python 3.10.6及环境变量配置指南
图 1:Python 3.10.6 在 Windows 平台上的规范安装流程与各个阶段关键配置说明

1. 勾选自动配置环境变量

在向导第一页底部,找到 Add Python 3.10 to PATH 选项,务必手动打上勾。若跳过此项,安装程序将只复制文件而不在系统环境中注册命令,导致后续在命令提示符(CMD)输入 python 时提示找不到程序。

2. 选择安装方式

向导提供了两种安装入口:

  • Install Now(立即安装):将Python默认安装到当前用户的应用数据目录下(路径类似 C:\Users\<用户名>\AppData\Local\Programs\Python\Python310)。该方式适合普通单用户电脑,无需全局管理员权限。
  • Customize installation(自定义安装,推荐):允许用户指定更精炼的安装路径(例如 C:\Python310 或 D:\Develop\Python310),便于日后定位依赖文件或排查虚拟环境。

3. 可选功能与高级设置

点击 Customize installation 后进入“Optional Features”界面,保持默认全选即可,特别是 pip(第三方包安装工具)与 py launcher(多版本启动调度器)必须保持启用。

点击 Next 进入“Advanced Options”界面:

  • 建议勾选 Install for all users(为所有用户安装):勾选后安装路径会自动调整为全局可读路径(若选择自定义目录则会获得标准系统权限支持)。
  • 在 Customize install location 输入框中,填入规范的安装目录,例如:C:\Python310。
路径命名规范

自定义路径请使用纯英文字符,切勿包含中文字符、特殊符号或空格(例如避免安装至包含空格的系统文件夹,以防某些较早的编译工具在解析命令行参数时因缺少引号转义而中断)。

4. 关键收尾操作:解除长路径限制

安装过程完成后,向导会显示“Setup was successful”界面。若系统未提前开启长路径支持,界面底部会出现一行浅色提示:Disable path length limit。请直接点击该按钮并同意Windows UAC授权。

该操作会修改Windows注册表中的 LongPathsEnabled 项,解除传统Win32 API对文件路径260个字符(MAX_PATH)的硬性限制。在安装深度学习模型包或嵌套依赖较多的npm/pip库时,该项能有效避免由于包解压路径过深而导致的 FileNotFoundError 异常。

三、手动配置系统环境变量

如果由于安装时遗漏了勾选 Add Python 3.10 to PATH,或者系统存在多个Python环境需要调整优先级,则必须手动进入系统属性配置环境变量。

Windows系统安装Python 3.10.6及环境变量配置指南
图 2:Windows 命令解释器检索 PATH 变量的流程逻辑及应用商店别名拦截机制

1. 打开系统环境变量编辑器

通过快捷指令直达高级系统设置,是最不易产生操作偏差的方式:

  1. 按下键盘组合键 Win + R 唤出“运行”对话框。
  2. 在输入框中输入 sysdm.cpl 并按下回车,直接打开“系统属性”窗口。
  3. 切换到顶部的 高级 选项卡,点击右下角的 环境变量(N)... 按钮。

2. 确认必须配置的两条核心路径

完整的Python工作环境要求向 Path 变量中添加两个独立路径。如果仅添加主目录,则只能运行 python 命令,执行 pip 时仍会报错。

Windows系统安装Python 3.10.6及环境变量配置指南
图 3:PATH 环境变量中 Python 主目录与 Scripts 目录的具体职责与所含核心文件
路径类型 默认安装时的物理路径示例 自定义安装时的路径示例 包含的主要可执行文件
Python主目录 C:\Users\<用户名>\AppData\Local\Programs\Python\Python310\ C:\Python310\ python.exe, pythonw.exe
Scripts工具目录 C:\Users\<用户名>\AppData\Local\Programs\Python\Python310\Scripts\ C:\Python310\Scripts\ pip.exe, pip3.exe, pip3.10.exe

3. 添加与排序操作

  1. 在“环境变量”窗口中,推荐在下半部分的 系统变量 列表中找到名为 Path 的条目(若无管理员权限,可在上半部的“用户变量”中配置)。
  2. 选中 Path 并点击 编辑(I)...。
  3. 在弹出的编辑界面中点击右侧的 新建(N),将 Python主目录 粘贴进去。
  4. 再次点击 新建(N),将 Scripts目录 粘贴进去。
  5. 排序上移:选中刚才新建的两项,点击右侧的 上移(U) 按钮,确保它们的位置排在 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps 之前。这一步对避开系统应用商店冲突至关重要。
  6. 连续点击三次 确定 按钮,关闭所有属性窗口以持久化写入注册表。

四、安装结果与环境验证

完成安装与环境变量配置后,必须在终端执行命令验证。注意:必须启动一个新的命令提示符窗口。在修改环境变量之前已经打开的终端窗口不会重新读取注册表,仍会沿用旧的环境上下文。

1. 验证 Python 解释器

按下 Win + R,输入 cmd 回车打开命令提示符,执行版本查询指令:

终端执行命令
python --version
标准返回示例
Python 3.10.6

2. 验证 pip 包管理工具

继续执行 pip 命令核验包管理器的可用性及绑定的解释器路径:

终端执行命令
pip --version
标准返回示例
pip 22.2.1 from C:\Python310\lib\site-packages\pip (python 3.10)

从输出可以看到,pip不仅成功报告版本号,还准确指向了Python 3.10安装目录下的site-packages包存储路径。

3. 检索可执行文件来源与优先级

Windows系统提供了 where 工具用于查看当前终端下命令的实际物理匹配链路。在终端输入:

终端执行命令
where python
标准返回示例
C:\Python310\python.exe
C:\Users\Username\AppData\Local\Microsoft\WindowsApps\python.exe

where 会按检索优先级自上而下列出所有匹配项。排在第一行的路径即为当前输入 python 时实际启动的程序。只要 C:\Python310\python.exe 处于首位,就代表环境检索顺序正确无误。

五、常见问题排查与解决方案

在不同版本的Windows操作系统上部署环境时,初学者最常遇到三类典型故障,可根据具体的表现形态按图 4 矩阵进行针对性排查。

Windows系统安装Python 3.10.6及环境变量配置指南
图 4:Python 3.10.6 验证结果对比与典型环境故障诊断矩阵

1. 提示“'python' 不是内部或外部命令,也不是可运行的程序”

原因分析:这表明Windows在当前工作目录和Path列表的所有路径中,均未检索到名为 python.exe 的可执行文件。通常是因为安装时漏勾选了PATH选项、手动配置时路径拼写有误、或者配置完成后没有重启终端。

解决步骤:

  1. 打开资源管理器,手动进入你所填写的Python安装目录,确认该目录下确实存在 python.exe 文件。
  2. 按照本文第三节重新核对环境变量Path,确保主目录路径精确无误且结尾带有反斜杠或无多余空格。
  3. 彻底关闭所有已经打开的CMD、PowerShell或VS Code内置终端窗口,重新启动新的终端再次输入 python --version。

2. 输入 python 后直接跳转到微软应用商店 (Microsoft Store)

原因分析:从Windows 10 1903版本起,系统在 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps 目录下预置了 0 字节的 python.exe 和 python3.exe。这是一个“应用执行别名(App execution alias)”。当系统找不到真正的Python或该别名路径在Path中排在前面时,系统就会拦截调用并弹出应用商店指引用户购买下载。

解决步骤(两种方案任选其一,推荐方案一):

  • 方案一(系统设置关闭别名):点击 Windows 开始菜单 -> 打开“设置” -> 进入“应用” -> 点击“高级应用设置”(Windows 10中为“应用和功能”下的“应用执行别名”)-> 找到“应用执行别名”,在列表中找到 应用安装程序 (python.exe) 和 应用安装程序 (python3.exe),将它们右侧的开关全部切换为 关。
  • 方案二(调整Path优先级):如前文所述,在环境变量编辑窗口中,将 C:\Python310\ 及其 Scripts 目录连续上移,调整至 WindowsApps 目录之上。

3. 系统内存在多个Python版本时的调度冲突

原因分析:如果机器上之前安装过Python 3.9、Python 3.11或Anaconda,输入 python --version 可能会反馈其他版本的版本号。这是因为旧版本的环境变量排在最前面,被操作系统优先截获。

解决与共存策略:

  • 优先策略:若希望将 3.10.6 设为全局默认,在环境变量Path中将其两行路径移动至所有其他Python相关路径的最顶端。
  • 启动器调度策略:如果各版本都需要保留,建议充分利用Python官方的 py 启动器。无需更改Path顺序,在任意终端直接运行以下指令即可精确绑定到3.10.6环境:
使用 py 启动器精确调用 3.10 解释器
py -3.10 script.py
使用 py 启动器精确调用 3.10 对应的 pip
py -3.10 -m pip install requests

通过掌握以上安装流程、环境变量检索逻辑以及别名冲突解决技巧,即可在Windows平台上建立起一套纯净、明确且不受系统机制干扰的Python 3.10.6运行环境。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表