Python 启动器（py.exe）安装与使用指南：多版本管理与虚拟环境最佳实践

一、Python 启动器简介

py.exe 是 Python 启动器（Python Launcher），随 Python 安装包附带，专为 Windows 系统设计。它支持多版本 Python 的选择与调用，替代直接使用 python.exe，同时提供虚拟环境支持和 Shebang 行解析等实用功能。官方文档参考：Python Launcher for Windows。

二、安装方法

1. 使用安装管理器安装（推荐）

从 Python 官方下载页 获取安装程序，例如 Python 3.14.2（注意：从 3.14.2 版本起，不再提供 python3.exe）。安装时请务必勾选以下两项：

• Use admin privileges when installing py.exe：确保启动器正确注册。
• Add python.exe to PATH：便于在命令行中直接调用。

安装完成后，官方推荐使用 py.exe 替代 python.exe 执行命令，因为默认情况下 PATH 中可能没有 python.exe 的路径。

2. 使用 NuGet 安装（不推荐）

可通过 NuGet 命令行工具安装 Python，但此方式不便于日常开发管理，仅作了解。示例命令：

nuget.exe install python -ExcludeVersion -OutputDirectory .
nuget.exe install pythonx86 -ExcludeVersion -OutputDirectory .

三、使用详解

1. 查看版本

查看当前默认 Python 版本及已安装的所有版本：

py --version   # 查看默认解释器版本
py --list      # 列出所有已安装版本（或 py -0）
py -0p         # 带路径列出所有版本

查看 pip 版本：

py -m pip --version

2. 运行脚本

py 1.py                # 使用默认版本运行
py -3.14 1.py          # 指定使用 Python 3.14 运行

在脚本首行添加 Shebang，启动器会自动选择对应版本：

#!/usr/bin/env python3
# 或
#!python3.12
print("Hello World")

3. 运行模块（py -m）

py -m http.server 8000          # 启动本地 Web 服务器
py -m tkinter                   # 启动 GUI 计算器
py -m venv myenv                # 创建虚拟环境
py -m unittest discover -s tests # 运行单元测试
py -m pdb myscript.py           # 启动调试器

py -m pip install requests      # 安装包
py -m pytest                    # 运行 pytest 测试
py -m flask run                 # 启动 Flask 应用
py -m jupyter notebook          # 启动 Jupyter

py my_module.py                 # 直接运行脚本
py -m my_module                 # 以模块方式运行（在 sys.path 中查找）

4. 设置项目虚拟环境（最佳实践）

虚拟环境（venv）自 Python 3.3 起内置，用于隔离项目依赖。操作步骤如下：

cd myproject
py -m venv .venv               # 创建虚拟环境（可指定版本，如 py -3.14 -m venv .venv）
.venvScriptsActivate.ps1     # 激活（Windows PowerShell）或 .venvScriptsactivate.bat（CMD）

激活后，命令行提示符前会出现 (.venv)，此时可直接使用 python 和 pip 命令：

(.venv) d:1> python --version
(.venv) d:1> pip list

退出虚拟环境：

deactivate

5. 修改默认版本

默认版本会影响 py --list 中带星号（*）的版本。可通过两种方式修改：

Set PY_PYTHON=3.12        # 临时设置
Setx PY_PYTHON=3.12       # 永久设置（需重启终端）

在 %LOCALAPPDATA% 下创建 py.ini 文件，内容如下：

[defaults]
python=3.12

启动器会优先读取该配置文件。

四、总结与最佳实践

• 通过官网安装 Python 时，务必勾选 Add python.exe to PATH 和 Use admin privileges when installing py.exe。
• 日常开发中，优先使用 py.exe 而非 python.exe，以充分利用多版本管理功能。
• 将常用 Python 版本设为默认，切换版本时使用 py -版本号 或临时设置环境变量 Set PY_PYTHON=3.12。
• 每个项目必须使用独立虚拟环境，避免在全局环境中安装依赖。若不想激活虚拟环境，可直接使用 .venvScriptspip <包名> 安装包。