Win11下C++调用嵌入式Python导入Numpy失败问题咨询

在Win11系统中，我有一个调用Python模块的C++程序，该模块会间接导入Numpy：

• 将可执行文件放在Miniconda环境目录（c:\users\jim\miniconda3）时，程序可正常运行；
• 将可执行文件放在其他目录运行时，会触发Numpy的警告：

C:\Users\jim\miniconda3\lib\site-packages\numpy_init_.py:127: UserWarning: mkl-service package failed to import, therefore Intel(R) MKL initialization ensuring its correct out-of-the box operation under condition when Gnu OpenMP had already been loaded by Python process is not assured. Please install mkl-service package

两种场景下Python的sys.path存在显著差异：

• Miniconda目录下运行时，sys.path包含不存在的路径C:\users\jim\miniconda3\python39.zip；
• 其他目录下运行时，sys.path包含存在的路径C:\Program Files\Amazon\AWSCLIV2\python39.zip。

移除系统PATH中的AWSCLIV2路径后，程序可在任意目录正常运行。

我有两个问题：

1. 这一现象的原因是什么？
2. 如何在不移除系统路径中AWSCLIV2的前提下解决该问题？

1. 现象原因 #

问题核心在于Python模块加载的路径优先级冲突：

• 当程序不在Miniconda目录运行时，系统PATH中AWSCLIV2的路径被优先识别，导致Python初始化时将C:\Program Files\Amazon\AWSCLIV2\python39.zip加入sys.path的前列；
• AWSCLIV2自带的Python环境（python39.zip）与Miniconda的Numpy依赖不兼容：要么该环境中缺少mkl-service模块，要么其内置的Gnu OpenMP库与Miniconda Numpy依赖的Intel MKL库冲突，导致Numpy无法正常初始化mkl-service，触发警告；
• 当程序在Miniconda目录运行时，Python会优先读取当前目录下的环境配置，sys.path中虽然包含不存在的python39.zip，但后续Miniconda的Lib、site-packages路径会覆盖这个无效路径，保证Numpy能加载到正确的依赖模块。

2. 保留AWSCLIV2路径的解决方法 #

方法1：在C++程序中显式指定Miniconda的Python路径 #

在初始化Python解释器后，手动调整sys.path，将Miniconda的核心路径放在最前面，覆盖AWS的路径：

#include <Python.h>

int main() {
    Py_Initialize();
    // 向sys.path添加Miniconda的核心路径，并放在最前面
    PyRun_SimpleString(R"(
import sys
sys.path.insert(0, 'c:\\users\\jim\\miniconda3\\Lib')
sys.path.insert(0, 'c:\\users\\jim\\miniconda3\\Lib\\site-packages')
)");
    // 后续调用Python模块的代码
    Py_Finalize();
    return 0;
}

方法2：运行前激活Miniconda环境 #

在命令行中先激活Miniconda环境，再运行C++程序，让环境变量优先指向Miniconda的路径：

call c:\users\jim\miniconda3\Scripts\activate.bat
your_program.exe

也可以把这两行保存为.bat脚本，直接运行脚本启动程序。

方法3：修改程序的运行环境变量 #

在Windows中，给可执行文件创建快捷方式：

1. 右键快捷方式 → 属性；
2. 在“起始位置”栏填写c:\users\jim\miniconda3；
3. 或者在“环境变量”中，将c:\users\jim\miniconda3、c:\users\jim\miniconda3\Scripts添加到用户变量的PATH最前端，优先于AWSCLIV2的路径。

方法4：打包独立的Python环境 #

使用PyInstaller等工具，将Miniconda中Python、Numpy及依赖的模块与C++程序打包在一起，让程序运行时直接使用打包后的独立环境，完全不受系统PATH的影响。

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