Windows下用bat脚本实现Python多版本一键永久切换

接了那么多乱七八糟的项目，Python 版本管理这事儿算是被问得最多的之一。尤其 Windows 上做开发，手头三四个项目，有的要 Python 3.8 跑老代码，有的要 3.11 才能装新版依赖，每次切换环境靠手动改系统设置，改完还得重启终端，运气不好连 IDE 都给你缓存住旧版本。后来我直接写了一套 bat 批处理脚本，把 Python 版本切换这件事做成“双击一次、永久生效、全局统一”的效果。这套方案我用了两年多，期间换了三台电脑，流程已经打磨得相当稳定。今天把这套脚本的设计思路、完整代码、踩坑记录一次说清楚，适合所有在 Windows 上用多版本 Python 做开发的读者。

1. 先想清楚：版本切换到底要解决什么问题

1.1 多版本并存是刚需，不是“折腾”

大多数人的需求不是“我要尝鲜新版”，而是项目被迫锁死版本。我见过最典型的场景：公司老项目基于 Django 2.2 写的，Python 版本只能压在 3.6/3.8；新项目用了 Pydantic 2.x，又必须 Python 3.10+ 起步。两台电脑装两个版本不够现实，因为你要频繁同时开发两边，更不可能每切一个项目就重装一次 Python。

这时候核心需求就变成了：让命令行、脚本、IDE、pip 都同时认到“当前激活的是哪个版本”，并且这个状态能一直保持下去。不是每次开终端临时设置一下，而是我明确切换到 Python 3.11，三个小时后重启电脑、再开终端，敲 python --version 还是 3.11。

1.2 各方案横向对比，bat 的独特优势

你可能会说，Windows 上不是有 py launcher 吗？不是还有 conda、virtualenv 吗？为什么非要自己写 bat？我挨个说下我的体验。

py launcher 的最大问题在于，你执行 python 命令时它并不参与。很多构建脚本、Makefile、CMake 配置里写死了 python xxx.py，这些命令直接找 PATH 里的 python.exe，压根不管 py launcher。conda 则是把 base 环境的 python 放到了 PATH 最前面，切换环境只是临时遮蔽，全局仍然只有一个固定默认，而且 conda 本身太重，为了切版本装个几百 MB 的工具不太划算。

bat 方案的逻辑最简单透明：写一个批处理脚本，把“当前要激活的 Python 安装目录”写进系统环境变量，手动把该目录挪到 PATH 最前面。这样不改动任何 Python 安装本身，不影响项目内的虚拟环境，切换结果持久保存在注册表里。整个过程不需要安装额外工具、不需要重启电脑、逻辑完全可控。

2. 先搞清楚：Windows 环境下 Python 版本切换的本质

2.1 PATH 搜索顺序决定一切

在 Windows 命令行里敲 python，系统做的事情是：先找当前目录下有没有 python.exe，没有就按 PATH 环境变量里列出的目录顺序一个个找。谁排在前面谁先被找到，执行的就是那个版本。

所以版本切换的本质就是调整 PATH 中多个 Python 安装目录的先后顺序。你装了两个 Python，一个在 D:\Python\Python311，一个在 D:\Python\Python38，PATH 里哪个在前，python 命令就对应哪个版本。这听起来很简单，但实际操作中大部分人都是靠“系统设置 → 环境变量 → 编辑 PATH”手动调，来回改几次就烦了，而且很容易把 PATH 改坏。

2.2 setx、注册表与“永久生效”的关系

Windows 的环境变量有两层存储位置：系统变量存在注册表 HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment，用户变量存在 HKCU\Environment。系统变量对所有用户生效，用户变量只对当前用户生效。普通开发者修改用户变量就够了，不需要管理员权限。

bat 脚本里常用 setx 命令永久写入环境变量，它的本质就是写注册表。但 `se