Python C API集成C++应用时导入zmq报ImportError，同脚本直跑正常

我之前也碰到过类似的跨环境导入坑，结合你的场景（Windows 10 + VS2010 + Python3.6.10 + Qt5.1.0），大概率是环境不一致或者Python初始化不完整导致的，下面分点给你排查思路和解决方法：

1. 先查32/64位匹配问题 #

你用的是32位Python（C:\Python36-32），但VS2010编译的C++程序可能是64位的？zmq的Cython模块是和Python位数强绑定的，一旦位数不匹配，就会出现「找不到constants这类底层模块」的导入错误。

排查步骤：

• 打开VS2010项目属性，查看「配置属性 → 常规 → 平台」，确保是Win32（不是x64）；
• 编译完成后，右键你的C++程序，选「属性」→「详细信息」，确认「位数」是32位。

2. 对比环境变量（PATH/PYTHONPATH）差异 #

直接运行Python时的环境变量，和C++进程的环境变量可能天差地别——尤其是PATH，zmq的底层依赖（比如libzmq.dll）必须在PATH里才能被Python加载。

排查步骤：

• 在你的C++代码里，导入zmq前加一段打印环境变量的Python代码：

  import os, sys
  print("C++进程PATH:", os.environ['PATH'])
  print("C++进程sys.path:", sys.path)
  

• 然后在cmd里直接运行Python，执行同样的代码：

  import os, sys
  print("直接运行PATH:", os.environ['PATH'])
  print("直接运行sys.path:", sys.path)
  

• 对比两者的输出，重点看：
  • PATH里有没有包含zmq依赖的dll路径（比如C:\Python36-32\Lib\site-packages\zmq或者Python的Scripts目录）；
  • sys.path里有没有包含C:\Python36-32\lib\site-packages（zmq所在的目录）。

解决方法：
如果发现C进程的PATH缺少必要路径，可以在C代码里手动补全：

// 在Py_InitializeEx之前设置PATH，把需要的路径放在前面
SetEnvironmentVariableA("PATH", "C:\\Python36-32\\Lib\\site-packages\\zmq;C:\\Python36-32;%PATH%");

或者在Python代码里添加sys.path：

import sys
sys.path.append("C:\\Python36-32\\lib\\site-packages")

3. 完善Python解释器初始化 #

Py_InitializeEx(0)可能没有完全初始化Python的运行环境，比如没正确识别Python的安装路径，导致无法加载site-packages里的模块。

解决方法：
在Py_InitializeEx之前，先设置Python的程序名称，让解释器能找到自己的安装目录：

// 必须是你实际的32位Python.exe路径
Py_SetProgramName(L"C:\\Python36-32\\python.exe");
Py_InitializeEx(0);

4. 排除代码字符串拼接问题 #

你用QString拼接Python代码，会不会有转义或者换行的问题？可以尝试直接运行你的test.py文件，而不是用PyRun_SimpleString：

FILE* fp = fopen("test.py", "r");
if (fp) {
    PyRun_SimpleFile(fp, "test.py");
    fclose(fp);
}

如果这样运行没问题，那就是字符串拼接时的格式问题，需要检查你的QString拼接后的Python代码是否和test.py完全一致。

5. 检查zmq版本兼容性 #

确认你安装的pyzmq版本支持Python3.6.10：在直接运行的Python里执行import zmq; print(zmq.__version__)，如果版本是18.x或19.x（这两个版本完美支持Python3.6）就没问题；如果版本太新或太旧，建议重新安装对应版本：

pip install pyzmq==19.0.2

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