【第 005 讲】搭建 Python 运行环境：Python 运行环境的安装 | 环境变量的原理与配置

        前一篇确定了本专栏的基准环境：官方参考实现 CPython，版本 3.14.10。接下来就是把它真正安装到计算机上。所谓安装 Python，实际安装的是一套以解释器为核心的完整环境：解释器负责读取并执行 Python 代码，标准库与配套工具随它一同就位；计算机上若没有解释器，Python 代码就无法运行。

        本篇以 Windows 11 64 位系统为操作基准（本专栏后续的全部操作同样以此为准），内容分为两个部分：先获取官方安装程序，认识下载页面上的各类分发文件，完成图形化安装并验证结果；随后专门讲解安装过程中反复出现的 “环境变量”——理解了这项操作系统的基础机制，你才能真正明白安装程序替你做了什么。

1 Python 运行环境的安装

1.1 获取安装程序

        获取 Python 3.14.10 安装程序有两种途径：从 Python 官方网站下载，或通过本专栏配套的学习资料网盘获取。两种途径得到的安装程序完全相同。

途径一：从官方网站下载

        Python 官方网站的地址为 https://www.python.org/。建议始终从官方网站等可信渠道获取安装程序，避免使用来源不明的第三方安装包。若从官方网站下载指定版本的安装程序，请按以下步骤操作：

        1. 定位目标版本：访问 Python 官方网站主页，在页面右上角的搜索框中输入目标版本号 3.14.10，随后点击搜索框右侧的 GO 按钮，或直接按下回车键执行搜索。

        2. 进入发布详情：在搜索结果页面中，点击 Release 后的 “Python 3.14.10” 链接，进入该版本的发布详情页。页面记录了这一版本的发布日期与主要更新内容，所需的下载文件位于页面底部。

        3. 选择安装文件：将页面滚动至底部的 Files 表格。表格的每一行对应一个分发文件：Version 列给出文件名称，同时充当下载链接；Operating system 列标明文件面向的操作系统；Description 列是官方给出的备注；其余各列提供文件大小与完整性校验信息，此处暂不涉及。本专栏的基准环境是 Windows 11 64 位系统，对应的文件是 Windows installer (64-bit)——这一行的 Description 列标注为 Recommended，即官方推荐选项。点击 Version 列中的 Windows installer (64-bit)，浏览器随即开始下载，得到的安装程序文件名为 python-3.14.10-amd64.exe。

途径二：从配套网盘获取

        你也可以通过本专栏配套的学习资料百度网盘链接获取完全相同的安装程序：https://pan.baidu.com/s/1h1Y3nm7gYezAlbaUmPenDA?pwd=yyds。本专栏后续涉及的全部学习资源与扩展工具，均会统一存放于该网盘，建议将其收藏备用。

1.2 分发文件的类型与选择

        在下载安装程序时，你已经见到了发布详情页底部的 Files 表格——它列出了本版本的全部 12 个分发文件，粗看之下名称十分相近：这些文件分别面向哪些平台？为什么 Windows 相关的条目多达 7 个？本节先纵览整个表格，再聚焦与本专栏环境相关的 Windows 安装文件，逐一解开这些疑问。

        按目标平台划分，这 12 个文件可以分为四组：

• 源代码包，共 2 个：Gzipped source tarball 与 XZ compressed source tarball，包含 Python 解释器的完整源代码，面向需要在 Linux、Unix 等系统上自行编译 Python 的使用者。
• macOS 安装包，共 1 个：macOS installer，面向 macOS 10.15 及以上版本。
• Android 嵌入包，共 2 个：Android embeddable package，分 aarch64 与 x86_64 两种架构，供 Android 应用内嵌 Python 运行时使用。
• Windows 相关文件，共 7 个：3 个 Windows installer 与 3 个 Windows embeddable package，外加 1 个 Windows release manifest。最后这个文件是一份清单，供命令行工具自动安装该版本时使用，与本次图形化安装无关。

        与本专栏相关的，是 3 个 Windows installer 与 3 个 Windows embeddable package。它们的名称可以从两个维度理解：末尾括号中的处理器架构标注，以及 installer 与 embeddable package 两种包类型。

Windows 安装包的三种架构

        这 6 个文件的名称末尾，均以括号标注了各自面向的处理器架构，共有三种：

• 64-bit：面向 x64 架构的处理器。x64 由 x86 架构扩展而来，是其 64 位版本——Windows 系统信息中显示的 “基于 x64 的处理器”，指的就是这一架构。它也是当前个人计算机的主流架构，绝大多数现代 Windows 电脑都属于这一类，本专栏采用的正是这一选项。此前下载的 python-3.14.10-amd64.exe，文件名中的 amd64 正是这一架构的通用代号：x64（又称 x86-64）由 AMD 率先设计推出，业界因此普遍以 amd64 指代它。
• 32-bit：面向 32 位的 x86 架构处理器，主要出于兼容老旧硬件或特定遗留场景的考虑而保留，在现代开发中已逐步退出主流。
• ARM64：面向基于 ARM 架构处理器的 Windows 设备，如搭载高通骁龙处理器的轻薄本与二合一平板。表格中这一行的 Description 列标注为 Experimental（实验性），表明它仍处于测试与完善阶段，稳定性尚未经过充分验证。

        选择安装包时，建议让架构标注与自己电脑的处理器保持一致，以获得原生的运行性能。

💡 提示：如何查询电脑的处理器架构

        以下两种方式打开的都是同一个设置页面：

• 右键点击桌面上的 “此电脑” 图标，选择 “属性”。
• 按下 Windows 徽标键 + i 组合键打开系统设置，依次进入 “系统” → “系统信息”。

        在页面上方的 “设备规格” 区域中查看 “系统类型” 一栏：

• 若显示 “64 位操作系统，基于 x64 的处理器”，对应 64-bit 架构。
• 若显示 “32 位操作系统，基于 x86 的处理器”，对应 32-bit 架构。
• 若显示 “64 位操作系统，基于 ARM 的处理器”，则对应 ARM64 架构。

常规安装包与可嵌入包

        再来区分两种包类型。Windows installer 与 Windows embeddable package 的定位截然不同，主要差异如下表所示：

        可嵌入包的典型用途，是为应用程序提供一个私有的 Python 运行时——例如把脚本引擎打包进桌面软件或游戏引擎，随软件一起安装，用户全程无感知。它剥离了 pip、IDLE 等开发工具，也不写入环境变量，因此并不适合编程学习与常规项目开发。常规安装包才是为开发环境准备的标准方案：安装向导会完成全部配置，开箱即用，本文安装使用的正是这一版本。

        把两个维度合起来看，此前下载的 Windows installer (64-bit) 正是 “x64 架构 + 常规安装包” 的组合，与本专栏的基准环境完全对应。

1.3 图形化安装流程

        成功下载 python-3.14.10-amd64.exe 后，请按以下步骤完成安装。

        1. 启动安装程序：打开文件资源管理器，找到下载的 python-3.14.10-amd64.exe，右键点击该文件，在弹出的菜单中选择 “以管理员身份运行”。这里之所以建议以管理员身份运行，有两方面考虑：本专栏将把 Python 安装到 C 盘根目录下的自定义文件夹，向该位置写入文件需要管理员权限；安装完成界面上的个别配置选项需要写入注册表（Registry），同样依赖管理员权限。注册表是 Windows 存放系统与应用配置信息的数据库。直接双击运行也能完成默认安装，但按照本专栏的安装方案，以管理员身份运行更为稳妥。

        2. 配置环境变量与选择安装方式：启动后，安装向导首先显示 Install Python 3.14.10 (64-bit) 首屏。界面上部提供了两种安装方式：Install Now 采用默认配置，把 Python 安装到当前用户目录下的固定位置（其下方的小字给出了具体位置），无法选择组件与路径；Customize installation 则允许逐项确认要安装的组件，并自定义安装位置。本专栏需要自定义安装路径，因此选择后者。

        选择之前，请先勾选界面底部的 Add python.exe to PATH 复选框：勾选后，安装程序会自动把 Python 相关目录写入环境变量 Path，使你在任意目录下都能直接执行 python 命令；若不勾选，安装完成后系统将无法识别 python 命令，必须手动配置环境变量。该复选框对两种安装方式都有效，请确认勾选后再点击 Customize installation。

📚 扩展：传统安装程序正在退役

        首屏顶部的 NOTE 提示值得留意：这类安装程序已被官方标记为弃用（This installer is being retired and will no longer be available after Python 3.15），自 Python 3.16 起将不再提供，取代它的是官方新推出的 Python 安装管理器（Python install manager）。本专栏选用的 3.14 分支仍在传统安装程序的支持范围内，安装与使用不受影响；记住这一变化，今后接触更新版本的 Python 时，就不会对官方安装方式的不同感到困惑。

        3. 确认可选功能：进入 Optional Features 配置面板，其中列出了五个可选组件：

• Documentation：Python 官方离线文档。
• pip：Python 的包管理工具，用于下载、安装与管理第三方库。
• Tcl/Tk, turtle and IDLE：安装 Tkinter 图形界面工具包、turtle 绘图模块，以及 Python 官方自带的简易开发环境 IDLE。
• Python test suite：标准库测试套件。
• py launcher：Python 启动器，提供 py 命令，用于快捷启动 Python；当系统中存在多个 Python 版本时，也便于指定启动其中的某一个。

        以上五个组件保持默认的勾选状态即可。py launcher 右侧还有一个未勾选的子选项 for all users (requires admin privileges)，用于把 py 启动器安装给这台电脑上的所有用户；保持默认不勾选，启动器将只面向当前用户安装。确认无误后，点击 Next 按钮。

        4. 配置安装路径并执行安装：进入 Advanced Options 配置面板。面板中共有八个复选框，分两类处理。

        已默认勾选的三项保持勾选：

• Associate files with Python (requires the 'py' launcher)：将 .py 等 Python 脚本文件与 Python 建立关联。
• Create shortcuts for installed applications：在开始菜单中创建 Python 相关的快捷方式。
• Add Python to environment variables：把 Python 相关目录写入环境变量——它与首屏的 Add python.exe to PATH 是同一项配置，此处应已默认勾选，请再确认一遍。

        其余五个复选框保持默认不勾选：最上方的 Install Python 3.14 for all users 用于把 Python 安装给这台电脑上的所有用户（安装位置也会相应变为系统级目录），本专栏不勾选，即只面向当前用户安装；Precompile standard library、Download debugging symbols、Download debug binaries (requires VS 2017 or later) 与 Download free-threaded binaries 分别用于预编译标准库、下载调试符号、下载调试版程序与自由线程构建，属于进阶用途，初学阶段用不到。

        面板下方的 Customize install location 输入框用于指定安装位置，默认指向当前用户目录，本专栏将其改为 C:\\1MySoftware\\Python3.14.10。这里顺带说明选择自定义目录的理由。Windows 下的软件大多默认安装到 C 盘的固定位置，安装的软件一多，不仅持续占用系统盘空间，目录也难以统一管理；若在安装时统一指定一个自建的安装目录，今后查找、备份与卸载软件都会清晰许多，C 盘空间紧张时还可以把这类目录设到其他磁盘分区。这只是一种值得养成的安装习惯，并非必需的步骤。

        修改安装路径时，有两点建议：

        5. 解除路径长度限制并完成安装：稍候片刻后，向导进入 Setup was successful 界面，表示安装成功。若界面底部出现 Disable path length limit 选项，建议点击它：该操作会修改注册表中的相应配置，解除 Windows 默认的 260 字符 MAX_PATH 路径长度限制，解除后路径长度上限可以扩展到约 32000 个字符。当然，解除限制并不等于鼓励深层嵌套的目录结构，规划目录时保持层级简洁依然是更好的做法。最后点击 Close 按钮，关闭安装向导。

1.4 验证安装结果

        安装结束后，执行一条命令即可验证结果，确认 Python 解释器已正确安装、环境变量配置已生效。具体步骤如下：

        1. 启动终端：按下 Windows 徽标键 + R 组合键，打开 “运行” 对话框，在输入框中输入 cmd，随后点击 “确定” 按钮或直接按回车键。打开的窗口即命令提示符（Command Prompt）——Windows 自带的命令行程序，也就是通常所说的终端（Terminal）；后续执行各类命令，都将以它为主要入口。

        2. 执行校验命令：在命令提示符窗口中输入 python –version，按下回车键。若安装与配置一切正常，终端会返回一行版本号 Python 3.14.10，与所安装的版本一致——这说明解释器安装成功、环境变量配置生效，当前系统已经具备执行 Python 代码的能力。

💡 提示：用 py 命令验证

        安装时勾选的 py launcher 组件会在系统中提供 py 命令。在终端中输入 py –version 并回车，终端同样会返回 Python 3.14.10：

        两种验证方式任选其一即可。py 启动器更主要的用途，是在多个 Python 版本并存时指定启动其中的某一个，此处暂不展开。

⚠️ 注意：环境变量未生效的处理

        若终端没有返回版本号，而是提示 “‘python’ 不是内部或外部命令，也不是可运行的程序或批处理文件”，说明环境变量尚未正确配置，可按以下顺序处理：

2 环境变量

        安装 Python 时，你勾选了首屏底部的 Add python.exe to PATH 复选框，随后 python –version 顺利返回了版本号；假如当时没有勾选，同样的命令就会得到 “‘python’ 不是内部或外部命令……” 的报错。同一条命令，两种截然不同的结果，差别只在一个复选框——答案指向操作系统的一项基础机制：环境变量。本节将讲解环境变量的工作原理与分类，以及查看与配置环境变量的具体方法。

2.1 环境变量的工作原理

        环境变量（Environment Variable）是操作系统维护的一组键值对（Key-Value Pair），用于向系统自身与各类应用程序传递配置信息——临时文件存放在哪里（TEMP）、处理器属于哪种架构（PROCESSOR_ARCHITECTURE），都可以由它来说明。每个环境变量都有一个名称和一个对应的值，操作系统与应用程序通过名称读取相应的值。

        在 Windows 系统中，与命令执行最直接相关的环境变量是 Path：它存储了一份目录列表，是命令提示符查找可执行文件的依据。当你在命令提示符中输入一条命令（例如 python –version）时，它会按照固定的顺序查找对应的可执行文件：

        还有一个细节值得留意：当输入的命令没有写明文件扩展名时，命令提示符会按照 PATHEXT 环境变量中定义的扩展名顺序依次尝试匹配。PATHEXT 是 Windows 预置的环境变量之一，在 Windows 11 中，它的典型默认值如下图所示（不同系统可能略有差异，以实际显示为准）：

        可以看到，.EXE 在列表中排在 .BAT 之前。因此，若某个目录下同时存在 python.exe 与 python.bat 两个文件，命令提示符会优先执行 python.exe。

        至此可以看清，配置 Path 变量的本质，就是把应用程序所在的目录加入查找范围；安装 Python 时勾选 Add python.exe to PATH，正是安装程序替你完成了这一步。

2.2 环境变量的分类

        Windows 的环境变量分为两个层级：用户变量（User Variables）与系统变量（System Variables）。二者的核心区别如下表所示：

        在日常使用中，两个层级的适用场景通常如下：在一台多人共用的计算机上，如果某项配置只供你自己使用，就把它添加到用户变量；如果希望这台电脑上的所有用户都能使用，则添加到系统变量。

        那么，当同一个变量同时存在于两个层级时，以哪一层的值为准？这需要分两种情况讨论。对于一般的环境变量，同名时以用户变量的值为准；Path 则比较特殊——Windows 不会在两者中取其一，而是把系统变量中的 Path 目录与用户变量中的 Path 目录拼接成一份完整的搜索列表，用户变量的 Path 目录排在后面。命令提示符依旧按从上到下的顺序依次搜索这份列表，因此，若两个层级的 Path 目录列表中存在同名的可执行文件，排在前面的系统变量目录会先被找到、先被执行。对安装 Python 而言，这条规则带来一个很实际的结果：无论把 Python 的目录添加到哪一层 Path 中，python 命令都能被找到。至于安装程序会把目录写入哪一层，则取决于安装方式：安装时没有勾选 Install Python 3.14 for all users，Python 只面向当前用户安装，相关目录因此被写入用户变量的 Path；反之，若勾选该选项并为所有用户安装，目录就会写入系统变量的 Path。

⚠️ 注意：谨慎修改系统变量

        系统变量对这台电脑上的所有用户生效，误删或改错其中的条目，可能导致系统命令或已安装的软件无法正常运行。修改之前，建议先将原值完整复制、保存在本地文件中作为备份，以便出现问题时能够恢复。

2.3 查看与配置环境变量

        按照以下步骤，可以查看当前操作系统中的环境变量配置，并了解修改后如何使其生效。

        1. 打开环境变量管理入口：按下键盘上的 Windows 徽标键，在搜索框中输入 “环境变量”。在搜索结果中，点击 “编辑系统环境变量”，或点击其右侧的 “打开”。

        2. 进入高级系统设置：在弹出的 “系统属性” 窗口中，确认当前位于 “高级” 选项卡，然后点击窗口底部的 “环境变量” 按钮。

        3. 定位目标变量：在 “环境变量” 窗口中，上半部分为当前用户的用户变量区域，下半部分为系统变量区域。在用户变量区域中找到名为 Path 的条目，双击该行，或选中后点击下方的 “编辑” 按钮。

        4. 查看路径列表：在弹出的 “编辑环境变量” 窗口中，系统以列表形式展示 Path 变量当前包含的所有目录。由于安装 Python 时勾选了 Add python.exe to PATH 复选框，列表中应能看到安装程序自动写入的三条 Python 相关目录：

• 扩展脚本目录：路径示例 C:\\1MySoftware\\Python3.14.10\\Scripts\\。该目录存放包管理工具 pip 等可执行文件，配置后你可以在任意目录下直接使用 pip 命令安装、卸载或管理第三方库。
• 核心解释器目录：路径示例 C:\\1MySoftware\\Python3.14.10\\。该目录存放核心解释器 python.exe，是 python 命令能够被识别的关键。
• 官方启动器目录：路径示例 C:\\Users\\Thanks\\AppData\\Local\\Programs\\Python\\Launcher\\。该目录存放启动器 py.exe；当系统中同时安装了多个 Python 版本时，可以通过 py -3.14 这样的命令指定运行其中的某个版本。

        前两条目录以你实际的安装位置为准；启动器目录则位于当前用户文件夹的 AppData 中——这是因为安装时 py launcher 的 for all users 子选项保持了默认不勾选，启动器只面向当前用户安装。此外，列表中可能还会看到其他条目，它们或是 Windows 系统自带，或是其他软件所需的环境配置，与本次安装无关，保持原样即可，切勿误删。

        5. 保存修改：查看完毕后，若未做任何改动，点击 “取消” 直接关闭窗口即可；若进行了新增、编辑或删除操作，则必须依次点击各层级窗口的 “确定”，变更才会正式写入操作系统。

💡 提示：管理 Path 列表的最佳实践

        在 Path 列表中，目录的查找顺序是从上到下。若希望某个目录被优先搜索，可以选中它，点击窗口右侧的 “上移” 按钮调整位置；“下移” 按钮则用于降低优先级。删除路径之前，应先确认该目录下没有正在被系统或其他软件使用的可执行文件，以免影响它们的正常运行。

📝 总结：从安装到环境变量

        本篇先完成了 Python 的安装：从官方网站获取 Windows installer (64-bit)，弄清架构与包类型的区别，以自定义路径完成图形化安装，最后用 python –version 验证了结果。随后讲解了让这些命令生效的幕后机制：环境变量以键值对的形式向系统与程序传递配置，Path 变量决定 python、pip 等命令能否被找到，用户变量与系统变量分别作用于个人与整台计算机——同名变量以用户变量为准，Path 则按 “系统在前、用户在后” 拼接。至此，运行 Python 代码所需的基准环境已经全部就绪。