应固定python命令指向基础版本（如3.8），用python311、pip311等显式命名命令管理多版本；安装时取消“Add to PATH”、自定义含版本号路径、复制重命名python.exe而非直接重命名；Path中老版本路径置前、新版本置后；第三方命令如uvicorn需重命名为uvicorn311等以解耦。
直接结论：别动系统默认python.exe，用版本化命令+环境变量路径顺序控制
Windows下Python多版本共存失败的根源，90%出在“想让python命令自动切换版本”这个错误目标上。你不需要、也不该让python命令动态变来变去——它就该稳定指向一个基础版本（比如3.8），而把python311、pip311这类显式命名的命令当作主力工具。这样既避免PATH冲突，又杜绝pip崩溃、launcher失效等连锁问题。
安装时必须做的三件事：路径隔离、不加PATH、重命名副本
装Python 3.11（或3.8）时，如果系统已存在另一个版本，务必按以下操作执行：
- 取消勾选“Add Python to PATH”——防止覆盖或干扰已有路径
- 自定义安装路径为
C:\Python311（或C:\Python38），确保目录名含明确版本号 - 安装完成后，进入
C:\Python311目录，复制python.exe并重命名为python311.exe（不是重命名原文件！）
注意：python311.exe是独立可执行文件，不会影响pip调用逻辑；而直接重命名原始python.exe会导致所有pip子命令启动失败，报错Fatal error in launcher。
环境变量配置的关键：路径顺序决定优先级
把两个Python安装目录及其Scripts子目录都加进用户级Path，但顺序很重要：
立即学习“Python免费学习笔记（深入）”；
- 把老版本路径（如
C:\Python38和C:\Python38\Scripts）放在前面 - 把新版本路径（如
C:\Python311和C:\Python311\Scripts）放在后面
这样python和pip自然走3.8，而你主动调用python311或pip311时，系统能准确命中对应解释器和包管理器。验证方式：python -V应输出3.8.x，python311 -V应输出3.11.x。
Uvicorn等第三方命令的命名冲突必须手动解耦
每个Python版本安装uvicorn后，都会在各自Scripts目录生成uvicorn.exe。由于Path中多个Scripts目录并存，CMD默认只会执行第一个找到的uvicorn.exe（通常是老版本的）。
- 进入
C:\Python311\Scripts，将uvicorn.exe重命名为uvicorn311.exe - 同理，若需3.8专用命令，可将
C:\Python38\Scripts\uvicorn.exe改为uvicorn38.exe - 启动服务时明确使用：
uvicorn311 myapp:app --reload
这一步最容易被跳过，结果就是你以为用的是3.11跑FastAPI，实际底层还是3.8解释器在干活，类型提示、新语法全失效，debug半天才发现根本没切对环境。
