Python 启动器 py.exe 功能与使用指南

在脚本开头添加 shebang 行，启动器会自动选择对应版本：

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

3. 运行模块 (py -m)

3.1 执行 Python 标准库模块

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     # 启动 Python 调试器

3.2 执行已安装的第三方包

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

3.3 执行自定义模块

py my_module.py       # 执行当前目录下的脚本文件
py -m my_module       # 以模块形式执行。Python 会在 sys.path 中寻找名为 my_module 的包或模块来运行。
                      # my_module 可以是当前目录下的.py 文件，也可以是已安装的包。

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

项目要使用 Python 虚拟环境（venv 默认可在 Python 3.3 及以后版本中使用）

py -m venv <DIR>
<DIR>\Scripts\activate

在虚拟环境下使得 python 命令可用：

// 1. 进入项目目录
cd myproject

// 2. 使用 py 创建虚拟环境
py -m venv .venv
// 或可指定已安装的 python 版本，创建虚拟环境：
py -3.14 -m venv .venv

// 3. 激活 (进入虚拟环境)
.venv\Scripts\Activate.ps1  // PowerShell
.venv\Scripts\activate.bat  // CMD
(.venv) d:\1>                // 提示符显示激活状态

// 4. 虚拟环境下使用 python 与 pip
python --version
pip list

// 5. 退出虚拟环境
d deactivate

5. 修改默认版本

影响 py --list，当前版本带 *。

方式 1：变量设置

set PY_PYTHON=3.12        # 临时设置
setx PY_PYTHON=3.12       # 永久设置，重启电脑生效

方式 2：配置文件设置

启动器将搜索两个 .ini 文件 —— 当前用户应用程序数据目录中的 py.ini (%LOCALAPPDATA%) 以及启动器所在目录中的 py.ini。同样的 .ini 文件还会被用于启动器的'控制台'版本 (py.exe) 和'窗口'版本 (pyw.exe)。

建议在 %LOCALAPPDATA% 下创建 py.ini：

[defaults]
python=3.12

通常项目开发中我们使用 py -版本号 来切换使用 Python；虽然我们可以安装多个 Python 版本，但应用程序安装到一个 Python 版本里，项目开发所用包采用虚拟环境隔离（可以使用安装的多个 Python 版本支持）。

总结与最佳实践

通过官网安装程序安装 Python，务必勾选 Add python.exe to PATH 和 Use admin privileges when installing py.exe。优先使用 py.exe 启动器来调用 Python，而非直接使用 python.exe。把常用的 Python 版本设为默认版本，通常使用'py -版本号'来切换使用不同的 Python 版本（或临时设置环境变量切换 Set PY_PYTHON=3.12）。开发项目必须使用虚拟环境（在虚拟环境里可以直接使用 python, pip 等命令），切勿在系统全局 Python 中直接安装项目依赖。不想进虚拟环境，快捷管理项目包请使用'.venv\Scripts\pip <包名>'来安装包。