Python安装时Custom Install选项该怎么设置

为什么推荐选择 Custom Install

双击打开 Python 官方安装程序后，界面通常会提供两个醒目的按钮：“Install Now”与“Customize installation”。如果直接点击“Install Now”，安装器会按照默认配置静默安装。对于日常开发而言，默认配置存在两个明显的缺陷：

• 默认安装路径极其深长：默认路径位于当前用户的 C:\Users\<用户名>\AppData\Local\Programs\Python\PythonXX 目录下。该目录不仅属于系统隐藏文件夹，且层级过深。一旦 Windows 用户名包含中文、特殊字符或空格，后续安装第三方库进行 C 扩展编译时极易出现编码解析失败。
• 环境变量极易被漏配：默认界面下方的环境变量复选框默认为未勾选状态。直接点击 Install Now 会导致安装完成后在命令行终端中输入 python 提示“不是内部或外部命令”。

选择“Customize installation”，可以让开发者自主控制功能模块的取舍、全局系统权限分配以及最为重要的安装根目录。

安装首屏：不可忽略的全局前置开关

在点击进入自定义配置界面之前，欢迎界面最底部的两个复选框具有至关重要的作用：

• Use admin privileges when installing py.exe：推荐勾选。该选项允许安装程序以管理员特权安装 Windows 的多版本 Python 调度工具 py.exe，使这台电脑上的所有 Windows 账户均可调用启动器。
• Add python.exe to PATH：必须勾选。该选项决定了安装程序是否会自动将 Python 的可执行文件目录及 Scripts 脚本目录注册到系统的 Path 环境变量中。如果遗漏此项，在安装完成后必须手动前往系统高级设置中配置环境变量。

勾选好底部的复选框后，点击中间的 Customize installation 按钮，进入自定义配置流程。

步骤一：Optional Features（可选功能）设置策略

自定义安装的第一个界面是“Optional Features”。该页面用于决定 Python 安装包中具体包含哪些内置功能和外围组件。界面中一共列出六个复选框：

1. Documentation（官方文档）保留勾选

安装 Python 离线 HTML/CHM 帮助手册。占用硬盘空间仅约 10MB 至 30MB。保留该选项可以在离线断网或没有网络检索条件时，随时通过本地查阅标准库的模块与函数定义。

2. pip（包管理工具）必须勾选

pip 是 Python 生态中最为核心的包管理工具。日常编程中绝大多数场景都会用到第三方库（例如 requests、numpy、pandas、fastapi 等），所有这些库的安装与升级均依赖 pip 命令。务必保持勾选。

3. tcl/tk and IDLE（图形库与基础开发环境）强烈推荐勾选

该选项会安装 Tkinter 模块（Python 官方标准的图形用户界面开发库）以及简易交互式开发环境 IDLE。初学者学习海龟绘图（turtle）、运行带有基础窗口的小程序或者临时调试简单代码段时都需要该组件。若取消勾选，后续代码中 import tkinter 将直接报错。

4. Python test suite（标准库测试套件）建议取消勾选

包含用于验证 Python 标准库各个功能模块正确性的单元回归测试脚本。这些测试文件仅在对解释器核心进行定制或源码回归测试时使用，普通开发者在日常编写代码时完全不需要。取消该勾选可减少数百个碎文件的写入，节省磁盘碎片开销。

5. py launcher 与 for all users强烈推荐勾选

py launcher 是 Windows 平台专属的轻量级调度器（即 py.exe）。它位于 Windows 系统级目录中，能够根据脚本首行的 shebang 说明（例如 #!python3.11）或命令行参数（例如 py -3.11 / py -3.12）在电脑中已安装的多个 Python 版本之间平滑切换。勾选其下方的 for all users (requires elevation)，可以使该调度器对整台计算机的所有账户生效。

设置完成后，点击右下角的 Next 按钮，进入关键的“Advanced Options”界面。

步骤二：Advanced Options（高级选项）与安装路径设定

“Advanced Options”界面直接决定了 Python 在操作系统中的权限层级、系统关联行为以及文件存放的物理路径，是 Custom Install 中最需要细心确认的环节。

复选框设置细则

• Install Python 3.x for all users建议勾选：勾选后会将 Python 安装为整机所有系统账户共享的环境，安装路径默认基准也会自动切换到全局程序目录。
• Associate files with Python (requires py launcher)必须勾选：将 .py 脚本扩展名与 Python 解释器进行系统关联。配置后双击脚本或在命令行直接输入脚本文件名即可启动执行。
• Create shortcuts for installed applications建议勾选：在 Windows 开始菜单中创建 IDLE、命令行以及手册的快捷方式，方便从开始菜单快速定位。
• Add Python to environment variables核心必选：如果首屏未勾选环境变量，该项必须勾选。它会自动将 Python 安装根目录以及存放第三方命令行工具的 Scripts 目录追加到系统的 Path 环境变量中。
• Precompile standard library建议勾选：在安装过程中预先将所有标准库 .py 文件编译生成字节码缓存（.pyc 文件）。虽然安装耗时会轻微增加几秒，但可以显著提升后续首次运行与导包的响应速度。
• Download debugging symbols 与 Download debug binaries保持不勾选：这两个选项用于调试 Python 解释器本身的底层 C/C++ 崩溃调用栈，需要联网下载数百兆的调试符号文件及特定版本的 Visual Studio 运行时。普通 Python 开发完全不需要，保持未勾选即可。

Customize install location（路径自定义规划）

界面底部的“Customize install location”输入框允许用户自定义安装目录。默认路径通常位于深层目录，建议手动修改为结构简洁、路径简短的根目录：

修改方式非常直接：可以直接在输入框中清空原有文本并键入 C:\Python312，也可以点击右侧的 Browse 按钮手动选择或新建文件夹。完成之后，点击右下角的 Install 开始安装。系统若弹出 UAC 用户账户控制提权提示，点击“是”允许写入。

步骤三：安装收尾与环境可用性验证

安装过程读条结束后，会出现“Setup was successful”界面。在该界面中，需要重点关注一个可能出现的特殊提示按钮。

解除 Windows 260 字符路径限制（Disable path length limit）

在安装成功界面的说明文字下方，如果出现了 Disable path length limit 的盾牌图标链接，务必点击它。

Windows 操作系统在历史上保留了 260 个字符的文件路径长度上限（MAX_PATH）。现代 Python 生态在进行深度学习开发、大型 Web 框架构建或者使用复杂虚拟环境时，包与模块的嵌套目录很容易超过 260 个字符。点击该按钮后，安装程序会自动修改注册表中的 LongPathsEnabled 键值，解除该限制，防止后续安装依赖包时触发“Filename too long”的致命错误。

终端自检与验证命令

点击“Close”关闭安装窗口后，按下快捷键 Win + R，输入 cmd 或 powershell 打开全新的命令行终端，依次执行以下三条验证命令：

# 1. 验证 Python 解释器版本与 PATH 注册状态
python --version
示例输出: Python 3.12.3

# 2. 验证 pip 包管理工具及其挂载目录
pip --version
示例输出: pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

# 3. 验证 py 启动器所管理的多版本路径
py -0p
示例输出:  -3.12-64 * C:\Python312\python.exe

若三条命令均能正确输出版本号与完整路径，说明 Python 解释器、pip 包管理器以及全局环境变量均已正确生效。

常见问题与排错方法

如果在执行 python --version 时遇到错误提示：

'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。

这说明系统的环境变量未能成功加载 Python 的可执行路径。可以按照以下步骤排查修复：

1. 确认终端是否重开：如果终端窗口是在点击安装之前打开的，它不会读取安装过程中新增的环境变量。关闭所有打开的 CMD 或 PowerShell 窗口，重新开启一个新终端再试。
2. 手动补齐系统环境变量：
   • 按下 Win + S 搜索“环境变量”，点击“编辑系统环境变量”。
   • 在弹出的系统属性窗口中点击右下角“环境变量”按钮。
   • 在下方“系统变量”列表中找到并双击 Path。
   • 检查列表中是否包含你所设置的安装路径，如 C:\Python312\ 以及 C:\Python312\Scripts\。若没有，点击右侧“新建”按钮将这两条路径逐一添加并保存。
3. 使用安装程序修复：重新运行下载的 python-3.x.x-amd64.exe 安装程序，选择“Modify”，在进入 Advanced Options 时勾选“Add Python to environment variables”，点击更新即可自动写入。

全选项设置决策速查矩阵

为了便于在安装时快速对照查阅，以下将 Custom Install 全流程涉及的所有设置项梳理为速查决策矩阵：

通过在 Custom Install 流程中落实清晰的路径规划并正确激活环境变量与核心工具链，可以从源头上杜绝后续在代码调试、工具链集成及第三方依赖安装中频繁出现的路径和权限问题，构建起干净、规范且易于维护的 Python 本地开发基底。