为什么嵌入式Python会搜索用户空间的库？如何禁止该行为？

核心原因是Python默认site模块会优先将用户目录下的site-packages加入模块搜索路径，且用户站点路径的优先级高于PYTHONPATH环境变量，因此此前的修改无法生效，可通过以下任意一种方式解决：

方案1：启动时添加 -s 参数 #

调用嵌入式Python执行脚本时，加上s参数即可直接禁用用户站点目录搜索，示例命令如下：

path\to\emb\python\python.exe -s your_script.py

如果是C++应用通过创建子进程调用python.exe，直接在启动参数里添加-s即可生效。

方案2：修改嵌入式Python专属的._pth配置文件（最稳定，不受环境变量影响） #

Windows嵌入式Python包会自带python39._pth配置文件，该文件的路径配置优先级高于所有系统环境变量，修改方式如下：

• 打开嵌入式Python根目录下的python39._pth文件
• 按顺序写入你需要的模块搜索路径，参考配置如下：

  python39.zip
  .
  Lib
  Lib\site-packages
  

• 确保文件中不存在import site这一行（如有直接删除或注释），此时Python不会初始化site模块，完全不会读取用户目录下的依赖，只会从你配置的路径中搜索模块，不受用户本机Python环境影响。

方案3：C++调用Python C API时直接禁用用户站点 #

如果你的C++应用是直接通过Python C API初始化解释器，而非调用python.exe可执行文件，可以在初始化前设置全局变量禁用用户站点：

// 引入Python头文件前定义宏，确保变量可访问
#define Py_NO_ENABLE_SHARED
#include <Python.h>

int main()
{
    // 初始化前设置禁用用户站点目录
    Py_NoUserSiteDirectory = 1;
    Py_Initialize();
    // 后续执行你的Python脚本逻辑
}

内容的提问来源于stack exchange，提问作者G. Batuchenko