一、 python启动器介绍
- py.exe 是 Python启动器（Python Launcher），是Windows系统上Python安装附带的一个特殊工具。 它支持python多版本选择、替代直接调用python.exe、支持虚拟环境、Shebang支持等。
- 官方文档：https://docs.python.org/zh-cn/3.14/using/windows.html#python-launcher-for-windows
二、安装（它随python一起安装）
1.使用安装管理器安装Python（推荐，常用方式）
- python下载地址
https://www.python.org/downloads/windows/
https://www.python.org/downloads/release/python-3142/
(从3.14.2版本开始，不再有python3.exe)
1.1安装python （当前系统可以安装多个版本）
- 1.1 Use admin privileges when installing py.exe 请选上
- 1.2 Add python.exe to PATH 请选上
1.2.注意事项
- 安装完成后，使用py.exe替代python运行(官方推荐方式，默认没有python.exe的路径)
2.使用Nuget安装Python (不建议)
- nuget.exe 命令行工具可以直接从 https://aka.ms/nugetclidl 下载，例如，使用 curl 或 PowerShell。 使用该工具安装 64 位或 32 位最新版本的 Python:
nuget.exe install python -ExcludeVersion -OutputDirectory .
nuget.exe install pythonx86 -ExcludeVersion -OutputDirectory .
三、使用
1. 查看版本
- 查看python版本
py –version 查询当前系统中默认的 Python 解释器版本
py –list 查询当前系统中安装的所有python 解释器版本 或py -0
//带路径查看所有python版本
py -0p
- 查看pip版本
py -m pip –version //查询当前python版本下，包安装器的版本
2.运行脚本
2.1指定版本运行脚本
//运行python脚本
py 1.py
//使用指定版本运行脚本
py -3.14 1.py
2.2 Shebang 支持示例
在脚本开头添加 shebang 行，启动器会自动选择对应版本：
#!/usr/bin/env python3
# 或 #!python3.12
print("Hello World")
3.运行模块(py -m)
3.1 执行Python标准库模块
# 启动本地Web服务器
py -m http.server 8000
# 启动简单GUI计算器
py -m tkinter
# 创建虚拟环境
py -m venv myenv
# 运行单元测试
py -m unittest discover -s tests
# 启动Python调试器
py -m pdb myscript.py
3.2 执行已安装的第三方包
# 使用pip（ 通常在项目虚拟环境下，直接调用pip）
py -m pip install requests
# 运行pytest测试
py -m pytest
# 运行flask应用
py -m flask run
# 执行jupyter
py -m jupyter notebook
3.3 执行自定义模块
// 执行当前目录下的脚本文件
py my_module.py
// 以模块形式执行。Python会在sys.path中寻找名为my_module的包或模块来运行。
// my_module可以是当前目录下的.py文件，也可以是已安装的包。
py -m my_module
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或.bat等可执行文件)
(.venv) d:\\1>
// 4. 虚拟环境下使用python与pip
(.venv) d:\\1>python –version (虚拟环境下的powershell/cmd下)
(.venv) d:\\1>pip list (虚拟环境下的powershell/cmd下)
//5.退出虚拟环境
(.venv) d:\\1> deactivate
5.修改默认版本 (影响 py –list ，当前版带*)
方式1：变量设置
Set PY_PYTHON=3.12 临时设置
或
Setx PY_PYTHON=3.12 永久设置，重启电脑
方式2：配置文件设置
启动器将搜索两个 .ini 文件 —— 当前用户应用程序数据目录中的 py.ini (%LOCALAPPDATA% 或 $env: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（使用py替代python.exe使用）
- 把常用的python版本设为默认版本,通常使用“py -版本号 ”来切换使用不同的python版本（或临时设置环境变量切换Set PY_PYTHON=3.12）；
- 开发项目必须使用虚拟环境（在虚拟环境里可以直接使用python,pip等命令）
- 切勿在系统全局 Python 中直接安装项目依赖,不想进虚拟环境,快捷管理项目包请使用“.venv\\Scripts\\pip <包名>"来安装包。
