Python 3.8+ 默认禁用系统 DLL 搜索路径，需在 import 前调用 os.add_dll_directory 注册绝对且存在的目录，否则 DLL 加载失败；相对路径和 PATH 设置均不可靠。
为什么 import 会找不到 DLL（即使文件存在）
Python 3.8+ 默认禁用了系统 DLL 搜索路径，包括当前目录和 PATH 中的路径。哪怕 mylib.dll 就放在脚本同级目录，import mylib（或依赖它的 C 扩展）仍可能报 ImportError: DLL load failed 或更具体的 ModuleNotFoundError: No module named 'xxx' —— 实际根源常是底层 DLL 加载失败，而非 Python 模块本身缺失。
这不是 Python 脚本写错了，而是 Windows 加载器根本没去你放 DLL 的那个文件夹里找。
os.add_dll_directory 必须在 import 前调用
这个函数不是“设置一个全局偏好”，而是向 Windows 的 DLL 加载器显式注册一个搜索目录。一旦某个扩展模块开始加载（比如触发 import numpy），它内部的 DLL 依赖就会立刻按当前已注册的目录列表去查找 —— 此时再调用 os.add_dll_directory 已经晚了。
常见错误写法：
import os os.add_dll_directory(r"C:mydeps") import mypackage # ❌ 太晚！mypackage 的 __init__.py 可能已触发 DLL 加载
正确顺序：
import os os.add_dll_directory(r"C:mydeps") # ✅ 必须最前 os.add_dll_directory(r".libs") # ✅ 支持相对路径，但注意是相对于当前工作目录（不是脚本目录） import mypackage
- 必须在任何可能触发 DLL 加载的
import之前执行 - 推荐放在脚本最顶部，甚至早于
sys.path修改 - 如果用 PyInstaller 打包，需确保该路径指向解压后的资源目录（如
sys._MEIPASS + "\dlls"）
路径必须是绝对路径，且目录需真实存在
os.add_dll_directory 不接受相对路径字符串（如 "./dlls"），传入后会静默失败（不报错，但不生效）。它要求传入的是经过 os.path.abspath 处理后的绝对路径，并且该路径必须是一个真实存在的、可读的目录。
安全写法示例：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
import os
dll_dir = os.path.join(os.path.dirname(__file__), "dlls")
if os.path.isdir(dll_dir):
os.add_dll_directory(os.path.abspath(dll_dir))
else:
raise RuntimeError(f"DLL directory not found: {dll_dir}")
import myextension
- 不要硬写
r"C:xxx"—— 跨机器部署时极易失效 - 不要依赖当前工作目录（
os.getcwd()）—— IDE 运行和命令行运行可能不同 - 务必检查目录是否存在，否则
add_dll_directory会静默忽略
与 PATH 环境变量的关系
设置 os.environ["PATH"] 仍然有效，但不推荐作为主要手段：它影响整个进程，可能干扰其他库；而且从 Python 3.8 起，Windows 加载器默认不再从 PATH 查找 DLL（除非显式启用 set_default_dll_directory）。
os.add_dll_directory 是更精准、更现代的方式，它只影响后续通过 LoadLibraryEx（Python 内部使用）加载的 DLL，不污染全局环境。
如果你必须兼容旧版本 Python（PATH：
import os
os.environ["PATH"] = r"C:mydeps;" + os.environ.get("PATH", "")
import myextension
但要注意：这在多线程或嵌入式 Python 场景下可能引发不可预期行为。
真正容易被忽略的是时机和路径真实性 —— 函数调用位置错一位，或者路径少一个 os.path.abspath，问题就还在那儿，报错信息却完全不提示原因。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
