嵌入式Python中sys.path无法通过sitecustomize.py可靠设置的技术问询

问题1：sys.path设置的启动选项及优先级 #

按优先级从高到低排列（高优先级配置会覆盖/调整低优先级的路径）：

• 命令行直接修改：通过-c参数执行代码直接改写sys.path，比如python -c "import sys; sys.path=['.', './Lib']"，这是临时最高优先级，会直接覆盖所有默认路径。
• 嵌入式专属._pth文件：与python.exe同目录的python._pth文件（对应pythonw.exe则为pythonw._pth），会直接定义初始sys.path，默认不加载site.py（除非文件内包含import site行），完全覆盖Python默认路径规则。
• sitecustomize.py：放置在Lib目录下，Python加载site.py时会优先执行该文件，可在此处永久重置sys.path。
• PYTHONPATH环境变量：系统/用户级环境变量，会将指定路径追加到sys.path前端（在默认路径之前）。
• site.py内置逻辑：自动添加系统级site-packages、PYTHONUSERBASE对应的用户级site-packages，并解析site-packages下的*.pth文件路径。
• usercustomize.py：放置在用户级site-packages目录，site.py最后执行该文件，仅对当前用户生效，优先级最低。
• Python默认路径：若以上配置均无，Python会使用编译时定义的默认路径（如嵌入式版默认的['.', './pythonXX.zip']）。

问题2：site.py的作用、包优先级及全局配置 #

• site.py核心作用：负责初始化站点级路径配置，具体包括：
  1. 识别并添加系统级site-packages到sys.path；
  2. 解析site-packages下的*.pth文件，将文件内路径追加到sys.path；
  3. 加载全局自定义的sitecustomize.py和用户自定义的usercustomize.py；
  4. 设置PYTHONUSERBASE对应的用户级site-packages路径。
• 用户包与站点包的优先级：默认顺序为PYTHONPATH路径 > 系统site-packages > 用户site-packages，但如果通过sitecustomize.py或代码直接修改sys.path，则以代码定义的顺序为准。
• 更高优先级的全局配置：嵌入式环境下，._pth文件优先级最高，其次是sitecustomize.py，这两个都是全局生效的配置，优先级高于PYTHONPATH、用户级配置等。

问题3：彻底隔离嵌入式环境的配置方案 #

要让嵌入式Python完全不受外部环境（系统PYTHONPATH、全局Python配置等）影响，按以下步骤操作：

1. 用._pth文件锁定初始路径
   在python.exe同目录创建python._pth文件，内容如下：

   .
   ./python310.zip
   ./Lib
   ./Lib/site-packages
   import site
   

   • 前四行是你需要的固定路径，顺序决定包查找优先级；
   • 最后一行import site用于触发site.py加载，确保sitecustomize.py生效（若不需要site.py功能，可去掉此行，但sitecustomize也会被跳过）。
     该文件会完全覆盖Python默认路径，且自动忽略PYTHONPATH环境变量。

2. 确保sitecustomize.py生效并强化隔离
   将sitecustomize.py放在./Lib目录，代码如下：

   import sys
   # 完全自定义sys.path，覆盖所有默认配置
   sys.path = ['.', './python310.zip', './Lib', './Lib/site-packages']
   # 强制忽略环境变量（可选，._pth已处理，但进一步确保隔离）
   sys.flags.ignore_environment = True
   

3. 清空启动时的外部环境变量
   在启动Python的脚本（如bat脚本）中，先清空相关环境变量：

   set PYTHONPATH=
   set PYTHONUSERBASE=
   start python.exe your_script.py
   

   彻底避免外部环境变量的干扰。

4. 验证隔离效果
   启动Python后执行以下代码，确认sys.path完全符合预期：

   import sys
   print(sys.path)
   

   若输出仅包含你指定的路径，说明隔离成功。

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