如何配置嵌入式Python 3.10在Windows 10中正常识别pip安装的模块

配置步骤 #

1. 编辑嵌入式目录下的版本对应_pth文件
   找到解压根目录下的python310._pth文件，修改内容：

• 删除#import site前的注释符号#，启用site模块加载逻辑
• 新增一行填写第三方库的存放路径，如果你用默认pip安装路径，就填Lib\site-packages，如果是自定义路径就填绝对路径c:\users\walter\Documents\python-3.10.0-embed-win32
• 保存文件后重启Python运行环境，默认会自动加载该路径下的所有模块

2. Python4Delphi 运行时路径补充
   如果修改_pth后仍无法识别，在Delphi端初始化Python引擎后，手动注入路径到Python的sys.path变量：

• 执行代码：import sys;sys.path.insert(0, r"c:\users\walter\Documents\python-3.10.0-embed-win32")
• 如果要适配MSI打包的可变安装目录，把绝对路径换成相对路径，比如sys.path.insert(0, "./python-embed")，路径对应你的MSI内嵌入式Python的放置位置

3. 配置验证
   执行以下代码确认配置生效：

import sys
# 打印所有加载路径，确认目标目录在列表内
print("\n".join(sys.path))
# 验证模块可正常导入
import requests
print(requests.__version__)

注意事项 #

• 嵌入式Python默认不会加载系统环境变量的PYTHONPATH，所有路径必须在_pth文件或运行时手动添加
• 如果你是32位Delphi程序，必须用32位的嵌入式Python包，64位程序对应64位包，避免架构不匹配导致的模块加载失败

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