PyCharm迁移venv到无基础解释器时报Invalid Python SDK问题

• 常规venv生成的虚拟环境并非自包含的独立运行时：它内部仅存储项目依赖、配置元数据，根目录下的Scripts/python.exe仅为几KB的引导程序，核心依赖创建该虚拟环境时绑定的原生Python解释器的运行库，且元数据中硬编码了原机器上原生Python的路径。
• 直接拷贝venv目录到未安装任何基础Python的第二台机器时，引导程序找不到对应的核心运行库，自然触发SDK无效报错。
• 被误识别为Python 3.10，是PyCharm扫描系统SDK索引时，读取了第二台机器注册表中残留的旧Python版本信息，匹配了错误的版本标签。

注意：仅修改原venv目录下pyvenv.cfg文件中的home字段为新路径无法解决问题，因为venv本身不包含Python核心动态链接库，脱离原生Python环境无法运行。

临时方案：仅在当前第二台机器临时运行项目 #

如果不需要做便携分发，仅需要在当前机器跑通项目：

• 安装与原虚拟环境完全同版本、同架构的Python 3.8.5，安装时可选择不加入系统PATH，仅让PyCharm能读取到即可。
• 安装完成后重新在PyCharm中选择venv下的Scripts/python.exe作为SDK，PyCharm会自动匹配到对应的原生运行时，版本识别错误、SDK无效的报错会直接消失。

正式方案：实现便携分发，使用者无需安装基础Python #

因为常规venv无法脱离原生Python独立运行，要实现免安装分发的效果，需要用「嵌入式便携Python + 项目依赖隔离」的方式替代原venv，步骤如下：

• 下载对应版本的Python 3.8.5 Windows embeddable package（选和原项目依赖匹配的64/32位版本），解压到项目目录下新建的runtime文件夹中，该文件夹即为完整的自包含Python运行时，无需依赖系统环境。
• 调整嵌入式Python配置，开启第三方包支持：打开runtime目录下的python38._pth文件，删除文件中#import site行前面的注释符#，保存退出。
• 安装pip工具：下载get-pip.py脚本放入runtime目录，在命令行进入该目录执行python get-pip.py完成pip初始化。
• 迁移项目依赖：回到最初创建项目的机器，在原虚拟环境的终端执行pip freeze > requirements.txt，导出全量依赖版本到项目根目录。
• 将项目代码、requirements.txt一起拷贝到第二台机器，在第二台机器的命令行进入项目的runtime目录，执行pip install -r ../requirements.txt，将所有依赖安装到便携运行时的隔离目录中。
• 在PyCharm中重新配置SDK：进入Project Interpreter设置，点击齿轮图标选择Add，定位到项目下runtime文件夹中的python.exe，确认后保存。此时PyCharm会正确识别Python 3.8.5版本，不会触发SDK无效报错。
• 后续分发时直接打包整个项目目录（包含runtime文件夹、项目代码、依赖说明）即可，使用者无需在本机安装任何Python版本，直接用PyCharm打开项目、选中对应路径下的便携python.exe即可运行；也可编写简单批处理脚本，直接调用便携运行时启动项目，无需依赖PyCharm环境。

• 打包分发时可直接删除原拷贝过来的venv目录，其硬编码的原路径元数据容易引发识别错误，无保留必要。
• 所有后续的依赖安装、版本升级，都在PyCharm关联该便携SDK的终端中操作即可，所有改动都会保存在项目的runtime目录下，不会写入系统环境，保证分发一致性。

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