如何在MFC应用中嵌入最小Python环境并优先使用自带环境

1. 应用内部嵌入最小Python环境的实现方式 #

• 优先选择Python官方发布的嵌入式（embeddable）压缩包，版本和架构必须和你的MFC程序编译架构（x86/x64）完全匹配，原生包解压后仅10-15M左右，无多余文档、开发工具和冗余三方库，是最小运行环境的最优选择
• 按需裁剪嵌入式包体积：如果对体积有更高要求，可以删除不需要的内置模块文件，例如不需要GUI相关能力可删除_tkinter.pyd，不需要网络能力可删除ssl.pyd、socket.pyd等，裁剪后最小可压缩到5M以内
• 将完整的嵌入式Python环境放在MFC程序的同目录下，建议单独新建python_runtime文件夹统一存放所有环境文件，避免和程序自身文件混淆
• MFC侧开发时仅需要引入对应版本Python的头文件，运行时动态加载自带环境中的python3x.dll（x为你的Python大版本号，例如Python3.11对应python311.dll），不要链接系统全局的Python库文件

2. 自带Python环境与本地Python的隔离方法 #

• 初始化Python解释器前，先修改当前进程的环境变量：调用Win32 API SetEnvironmentVariable 清空进程内PYTHONHOME、PYTHONPATH变量，再把自带Python环境的根目录、Scripts目录（如果有）追加到PATH环境变量的最前面，覆盖系统PATH中的Python路径优先级
• 显式指定Python解释器的搜索路径：调用Py_SetPythonHome 传入自带Python环境根目录的绝对路径，调用Py_SetPath传入你需要的模块搜索路径（一般包含自带环境下的python3x.zip、根目录、site-packages目录），完全覆盖解释器默认的搜索逻辑，不会主动读取系统Python的模块路径
• 修改嵌入式包内的python3x._pth配置文件，仅保留你自带环境的路径配置，示例如下：

  python311.zip
  .
  import site
  

  开启该配置后解释器只会从列出的路径中搜索模块，完全忽略全局环境的Python路径
• 优先使用进程内嵌入式解释器的调用方式：直接在MFC进程内调用Py_Initialize初始化解释器，不要通过启动python.exe子进程的方式调用Python，从根源上避免调用到系统安装的Python可执行文件

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