Windows下怎么用py-3.13启动指定Python版本？

一、核心命令与快速上手

很多初学者在 Windows 下安装了新版本 Python 3.13 后，直接在终端敲 python，却发现仍然进入了旧版本的 Python 3.10 或 3.12，甚至弹出了 Windows 应用商店页面。这是由于系统的 PATH 环境变量中旧版本路径排列在前，或者没有配置环境变量。

Windows 官方给出的标准解决方案是 Python Launcher（即 py.exe）。只要在安装 Python 时保留了默认勾选的启动器组件，即可在任意工作目录下使用统一的语法来唤起 Python 3.13：

py -3.13

运行特定的 Python 脚本时，将脚本文件名紧跟在版本参数之后：

py -3.13 app.py

为该版本独立安装第三方模块或执行工具包，利用 -m 开关即可直接将指令分发至 Python 3.13 的环境：

py -3.13 -m pip install requests
py -3.13 -m venv myenv_313

二、py.exe 如何定位并调用 Python 3.13

理解 py.exe 的底层查找逻辑，有助于在遇到版本调用异常时快速排查。py.exe 是一个轻量级调度工具，通常安装在 C:\Windows\py.exe 或 %LOCALAPPDATA%\Programs\Python\Launcher\，该路径默认会注册到全局系统 PATH 中。

当你在终端输入 py -3.13 时，启动器并不会盲目遍历磁盘，而是按固定的优先级完成路径裁决并启动目标解释器：

这种机制保证了即使操作系统安装了三四个不同版本的 Python，也无需在系统设置里反复调整 PATH 顺序，只需一条参数即可实现确定性的精准调度。

三、操作实战：从环境侦测到项目运行的完整流程

在实际项目开发中，使用 py -3.13 启动指定版本通常包含四个标准化步骤：确认安装状态、验证交互环境、运行实际业务代码、以及创建隔离的虚拟环境。

步骤 1：查看当前系统所有已登记的 Python 版本

在开始之前，先检查 Windows 是否成功登记了 Python 3.13。在命令行输入：

py --list-paths
REM 或者简写形式：
py -0p

输出中带有星号（*）的行表示当前的系统默认版本。只要列表中包含了 -3.13，就说明 py.exe 已经找到了该版本并做好了启动准备。

步骤 2：启动交互终端验证版本

执行 py -3.13 进入交互环境，输入内置模块命令打印具体细节：

py -3.13 -c "import sys; print(f'Version: {sys.version}\nPath: {sys.executable}')"

步骤 3：运行业务脚本与模块

若你的项目目录下有 main.py，直接指定参数执行：

py -3.13 main.py --config prod.json --port 8080

这里注意：-3.13 是传递给 py.exe 启动器的版本控制参数；而 main.py 以及后面的 --config 是传递给脚本本身的参数。启动器会自动识别并正确转发。

步骤 4：基于 Python 3.13 创建独立虚拟环境

日常开发切忌直接向全局 Python 环境安装大量第三方包。推荐使用 Python 3.13 内置的 venv 模块创建独立虚拟环境：

REM 1. 创建名为 venv313 的虚拟环境
py -3.13 -m venv venv313

REM 2. 在 CMD 中激活虚拟环境
venv313\Scripts\activate.bat

REM 3. 或者在 PowerShell 中激活
.\venv313\Scripts\Activate.ps1

激活后，命令行提示符前会显示 (venv313)，此时直接执行 python 或 pip 就会默认绑定到该虚拟环境内部，不再需要反复敲 py -3.13。

四、参数规则：位数指定与版本匹配矩阵

py 启动器支持非常灵活的参数定义。不仅可以指定次版本（如 3.13），还可以根据需要指定主版本、系统架构位数（64位或32位），甚至指定窗口运行模式（pyw）。

五、脚本内 Shebang 与默认版本固化

除了在每次运行命令时手动敲入 -3.13，还可以通过以下两种方法将 Python 3.13 设定为默认环境或脚本专属环境：

方法 1：在 Python 脚本首行添加 Shebang 声明

在 Linux/macOS 中，脚本第一行的 #! 称为 Shebang。Windows 系统的内核本身不支持 Shebang，但 py.exe 原生实现了对 Shebang 的解析。当你直接用 py script.py 或者双击 .py 文件时，启动器会读取第一行：

#!python3.13
# -*- coding: utf-8 -*-
import sys

print("当前执行的 Python 版本是:", sys.version)

保存后，即使你在终端只输入 py demo.py，启动器也能识别出 #!python3.13，并自动分派给 Python 3.13 执行。如果脚本要求 64 位，还可以写为 #!/usr/bin/env python3.13-64。

方法 2：通过环境变量将 3.13 设为全局默认

如果你希望以后只输入 py 就直接默认启动 Python 3.13，而无需每次都输 -3.13，可以配置 Windows 用户环境变量 PY_PYTHON：

[System.Environment]::SetEnvironmentVariable('PY_PYTHON', '3.13', 'User')

或者在 %LOCALAPPDATA%\py.ini 文件（若不存在可新建）中写入配置：

[defaults]
python=3.13

设置完成后，直接输入 py 便会默认进入 Python 3.13。

六、常见问题排查与解决流程

在使用 py -3.13 过程中，最常遇到的问题通常与启动器未勾选安装、注册表缺失或参数格式不当有关。以下为排查诊断流程：

1. 报错：No suitable Python runtime could be found

如果在执行 py -3.13 时提示类似 Requested runtime Python 3.13 is not installed 或找不到合适运行时，原因通常为：

• Python 3.13 尚未实际安装，或者安装的是绿色免安装解压版（未向系统注册表注册）。
• 参数输错，例如写成了 py -3.13.0（启动器不支持三位版本号），应改为 py -3.13。
• 安装的是 32 位版本，而命令行指定了 py -3.13-64。可以通过 py -0p 查看注册表检测出的具体位宽。

2. 命令行提示 “py” 不是内部或外部命令

这说明 py.exe 自身未在系统的 PATH 环境变量中。通常官方安装包会将 py.exe 放置在 C:\Windows\（该目录默认在所有命令行的 PATH 内）。如果误删或选择跳过安装，只需重新运行 Python 安装包，点击 Modify（修改），确保勾选 “py launcher” 即可恢复。

3. VS Code 或 IDE 中如何配置指定为 Python 3.13

在 VS Code 中，无需依赖 PATH。快捷键按下 Ctrl + Shift + P，输入 Python: Select Interpreter，启动器已注册的 Python 3.13.x 会直接列在可选列表中。选择该项后，VS Code 的内置终端激活与脚本运行就会自动与 3.13 绑定。

七、总结

在 Windows 环境下管理与切换 Python 版本，py.exe 是官方标准且最高效的工具。要启动指定版本：

掌握 py -3.13 的用法后，无需再去系统属性中繁琐地增删 PATH 环境变量，即可从容应对多版本共存测试与日常开发。