Windows 10安装Python并配置环境变量的详细步骤

在 Windows 10 系统中安装 Python 并完成环境变量配置，核心任务在于让系统能够正确找到 Python 解释器（python.exe）及其自带的包管理工具（pip.exe）。整个流程包含四个清晰阶段：从官网下载与系统匹配的安装包、在安装向导中进行合理选项勾选、在系统高级设置中核实或手动追加环境变量路径，最后通过命令提示符（cmd）完成验证。只要掌握关键配置细节，就能彻底杜绝“python 不是内部或外部命令”等常见环境异常。

一、前期准备与安装包下载

在开始下载前，先确认当前 Windows 10 系统的系统类型。可以通过快捷键 Win + Pause/Break 打开“关于”设置，或在桌面右键单击“此电脑”选择“属性”，查看“系统类型”一栏是否为“64 位操作系统，基于 x64 的处理器”。目前绝大多数 Windows 10 均为 64 位，若为 32 位系统则需选择 32 位（x86）版本安装包。

接下来前往 Python 官方网站下载安装包：

1. 使用浏览器打开官方网站下载页面：https://www.python.org/downloads/windows/。
2. 在稳定发布列表（Stable Releases）中找到当前的长期支持或稳定版本（例如 Python 3.12 系列）。
3. 点击下载 Windows installer (64-bit)。下载后的文件名为 python-3.x.x-amd64.exe，请保存在易于找到的本地目录中。

二、运行安装向导与核心选项设置

双击运行下载好的 .exe 安装程序。安装界面的第一步包含了决定后续能否在终端直接使用 Python 的最关键选项，操作时切忌快速连击“Next”跳过。

1. 勾选环境变量复选框

进入安装界面底部，可以看到两个复选框：

• Use admin privileges when installing py.exe：以管理员权限安装 Python 启动器，保持默认勾选即可。
• Add python.exe to PATH：必须勾选此项。勾选后，安装程序会自动将 Python 安装目录与 Scripts 目录写入当前用户的 PATH 环境变量，省去后续大量手动配置工作。

2. 选择自定义安装（Customize installation）

如果点击“Install Now”，Python 会默认安装在当前用户的 AppData\Local\Programs\Python\... 目录下。该目录层级很深且处于隐藏文件夹中，后续查找模块或配置第三方工具时较为繁琐。因此推荐点击 Customize installation：

1. Optional Features（可选功能）：默认勾选 Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher，全部保持默认打勾，直接点击“Next”。
2. Advanced Options（高级选项）：建议勾选 Install Python for all users（为所有用户安装）。
3. Customize install location（自定义安装路径）：将冗长的默认路径修改为简单易记且不包含空格与中文字符的路径，例如 C:\Python312 或 D:\Python\Python312。
4. 点击 Install 开始安装，等待进度条走完。
5. 安装成功页面若出现 Disable path length limit（解除 Windows 260 字符路径长度限制），建议点击该项授权以避免长路径文件名报错，最后点击 Close 退出。

三、手动配置 Windows 10 环境变量

如果在安装时漏勾了“Add python.exe to PATH”，或者之后迁移了 Python 目录，命令行便无法通过输入 python 直接启动程序。此时需要手动打开系统属性进行配置。

1. 打开环境变量管理窗口

1. 使用快捷键 Win + S 打开搜索框，输入 env 或 环境变量，选择“编辑系统环境变量”；或者右键桌面“此电脑”选择“属性”，点击右侧或左侧的“高级系统设置”。
2. 在弹出的“系统属性”面板中，切换至“高级”选项卡，点击右下角的 环境变量(N)... 按钮。

2. 在 Path 变量中添加两条完整路径

环境变量窗口分为两块：上方为“用户变量”，仅对当前 Windows 登录用户生效；下方为“系统变量”，对这台电脑上的所有用户生效。若为个人日常使用电脑，修改任一处均可，推荐修改“系统变量”以保持全局生效：

1. 在“系统变量”区域中向下滚动找到名为 Path 的变量，双击它或选中后点击“编辑”。
2. 在弹出的编辑环境变量列表窗口右侧，点击 新建(N) 按钮。
3. 第一条路径填入 Python 主安装目录，例如：C:\Python312\（如果是默认安装，形如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\）。
4. 再次点击 新建(N) 按钮，填入 Scripts 目录路径，例如：C:\Python312\Scripts\。
5. 若之前列表中存在 Windows 自带的应用别名（形如 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps），可以选中刚刚添加的 Python 路径，点击右侧的“上移”按钮，将其移动到该应用别名条目的上方。
6. 依次点击“确定”、“确定”、“确定”，退出所有配置窗口。

四、环境验证与可用性测试

配置完成后，必须通过终端验证安装是否真正生效。

1. 验证 Python 解释器

按下快捷键 Win + R，在运行对话框中输入 cmd 并回车打开命令提示符，输入以下命令：

python --version

若配置成功，终端会直接输出当前安装的版本号（示例输出）：

Python 3.12.3

2. 验证包管理器 pip

在同一个 cmd 窗口中输入以下命令检查包管理工具：

pip --version

正常情况下将输出 pip 版本及其对应的 Python 安装路径（示例输出）：

pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

3. 查看实际调用的程序路径

如果电脑中安装过多个版本的 Python，或者想确认终端调用的可执行程序位置，可以执行 Windows 自带的寻址检测命令：

where python

系统会按匹配优先级列出所有发现的 python.exe 路径：

C:\Python312\python.exe
C:\Users\Admin\AppData\Local\Microsoft\WindowsApps\python.exe

4. 运行简单测试代码

在 cmd 中直接键入 python 并回车，此时命令行提示符会变为三个大于号 >>>，表示已进入 Python 交互式环境。输入以下测试代码：

print("Hello, Python!")

回车后控制台立即输出 Hello, Python!。输入 exit() 或按下 Ctrl + Z 后回车，即可退出交互环境返回系统命令行。

五、常见问题排查与避坑速查

在 Windows 10 上配置 Python 环境时，通常有三种高频问题需要特别注意：

1. 故障表现一：输入 python 自动弹出微软商店（Microsoft Store）

原因分析：Windows 10 系统自带了名为“应用执行别名”的功能，默认在环境变量中注入了微软商店的占位快捷程序。当系统没有找到真实的 Python 路径，或者 WindowsApps 目录排在实际 Python 路径前边时，系统就会拦截输入并启动微软商店。

解决步骤：

1. 点击 Windows“开始”菜单，打开“设置”（齿轮图标）。
2. 进入“应用” > “应用和功能”。
3. 在窗口右侧或相关设置中点击 应用执行别名（App execution aliases）。
4. 在别名列表中找到 应用安装程序 python.exe 与 应用安装程序 python3.exe，将右侧的开关全部切换为 关。
5. 重新打开命令提示符，再次输入 python 即可正常进入真实安装的 Python 环境。

2. 故障表现二：提示“'python' 或 'pip' 不是内部或外部命令”

原因分析：系统在当前所有 PATH 目录中均未检索到对应名称的 .exe 文件。

解决步骤：

1. 重新打开“环境变量”窗口，核对 Path 中的两条记录是否存在拼写错误、漏掉斜杠或缺少盘符。
2. 检查安装目录中是否存在 python.exe，以及 Scripts 文件夹下是否存在 pip.exe。
3. 确认是否关闭并重新启动了命令提示符窗口。在旧窗口中执行 echo %PATH% 检查最新路径是否已被加载。

3. 国内网络环境下加速 pip 安装库

在日常使用中，默认的 pip 源位于国外服务器，下载如 numpy、requests 等库时可能会出现网络超时错误。建议在完成环境搭建后，配置国内清华大学或阿里云镜像源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

设置完成后，后续每次使用 pip install 包名 时便会自动通过国内高速镜像节点下载，极大提升开发效率。