升级Python新版本后如何迁移所有包、配置及用户数据？

• Windows下不同大版本的Python（比如3.9和3.10）默认使用完全隔离的安装目录、第三方包存储目录（site-packages）、可执行脚本目录（Scripts），不存在跨版本自动共享包和脚本的机制。
• 安装Python3.10时，安装程序会自动修改系统PATH变量的优先级，把3.10的相关路径放到旧版本前面，此时系统会优先找3.10目录下的脚本，但你没给3.10装过jupyter等工具，自然会报「不是内部或外部命令」的错误。
• 卸载3.10后问题没恢复，是因为卸载程序没有自动还原PATH变量里3.9路径的优先级，甚至可能直接删掉了3.9的路径条目，和开发框架本身损坏没有关系。
• 直接复制Python39/Scripts下的文件到3.10目录完全不可行：Scripts下的exe启动器是pip安装包时针对当前解释器路径、版本硬编码生成的，跨版本复制后会直接报模块找不到、版本不匹配的错误，没有任何可用性。

按以下步骤操作5分钟内就能恢复正常使用，不需要重装任何东西：

1. 按下Win+S搜索「环境变量」，打开「编辑系统环境变量」面板，点击右下角「环境变量」按钮
2. 在「用户变量」和「系统变量」两个区域分别找到名为Path的条目，双击编辑
3. 检查条目里的路径：
   • 确保存在C:\Program Files\Python39\和C:\Program Files\Python39\Scripts\两个路径
   • 把这两个路径的优先级调到所有其他Python相关路径的最前面，删掉残留的无效Python310路径
4. 点击所有窗口的确定保存配置，关闭所有已打开的终端/命令行窗口重新打开，执行python --version确认返回3.9.x版本，此时再执行jupyter notebook等命令就会和安装3.10之前完全一致。

不需要手动复制任何目录文件，按照以下流程操作不会丢失任何包和配置，也不会出现环境失效问题。

第三方包迁移 #

1. 旧版本环境恢复正常后，终端执行命令导出所有已安装第三方包的精确版本清单：
   pip freeze > requirements.txt
2. 安装新的Python版本（比如3.10），安装时注意勾选「Add Python to PATH」和「Install launcher for all users」两个选项
3. 打开新终端，执行py -3.10 -m pip install -r requirements.txt，pip会自动把所有包安装到3.10对应的site-packages目录，同时自动在Python310/Scripts下生成jupyter、pytest等所有工具的启动脚本，不需要手动拷贝任何文件。

多版本共存时不需要反复修改PATH，用Python自带的py启动器就能精准调用对应版本：py -3.9调用3.9解释器，py -3.10调用3.10解释器，给指定版本装包就用py -对应版本号 -m pip install 包名，完全不会出现命令冲突、找错版本的问题。

自定义配置迁移 #

所有第三方工具的用户级配置默认存储在Windows用户目录下，和Python安装目录完全无关，重装包、升级Python版本时不需要手动迁移，工具会自动读取：

• Jupyter的自定义配置、内核设置、插件配置默认存放在C:\Users\你的用户名\.jupyter目录
• pip全局源配置存放在C:\Users\你的用户名\pip\pip.ini
• 其他绝大多数Python第三方工具的用户配置，都存在C:\Users\你的用户名\下以.开头的对应隐藏目录中，不会因为换Python版本丢失。

• 不要把所有项目依赖都装在全局Python环境中，使用Python自带的venv为每个项目创建独立虚拟环境：虚拟环境会把对应版本的解释器、依赖包、启动脚本都存放在单独的项目目录里，不管全局Python怎么升级、卸载、换版本，只要激活对应虚拟环境就能直接运行项目，完全不受全局环境变动影响。创建虚拟环境的命令为py -对应版本号 -m venv 虚拟环境目录名。
• 调用Python相关命令时优先使用py -版本号 -m 模块名的格式，比如启动Jupyter就用py -3.10 -m jupyter notebook，这种调用方式不依赖PATH里的脚本路径，永远不会出现「命令不存在」的错误。
• 安装新Python大版本时不需要卸载旧版本，py启动器会自动识别所有已安装的Python版本，多版本共存不会有任何冲突。

内容的提问来源于stack exchange，提问作者srhslvmn