pkgutil.get_data() 是用于读取包内资源文件的函数，返回字节串，要求传入完整包名且资源文件须在该包目录下，依赖 __init__.py 识别包结构，否则返回 None 或抛 ValueError；Python 3.7+ 推荐改用 importlib.resources 获取更安全、类型明确的文本或二进制内容。
pkgutil.get_data() 是最直接的方案，但它只返回 bytes，且对包结构有硬性要求——资源文件必须和 Python 模块在同一个包目录下，不能放在子包外或顶层目录。
为什么 pkgutil.get_data() 会返回 None 或抛出 ValueError
常见原因是传入的包名不匹配实际导入路径。比如模块路径是 myapp.utils.config，但你调用时用了 pkgutil.get_data("utils", "data.json") —— 这里第一个参数必须是完整包名（如 "myapp.utils"），不是相对名或文件夹名。
另一个高频错误是资源文件没被识别为包的一部分：文件所在目录缺少 __init__.py（哪怕为空），导致 Python 不认为它是包，__name__ 就不会包含该路径。
- 确认资源文件与调用代码在同一包内，或明确指定其所属包的完整名称
- 检查目录是否都有
__init__.py；缺失会导致pkgutil.iter_modules()找不到子模块，get_data()也查不到文件 - 不要用
os.path.join()拼接资源路径；第二个参数是相对于包根目录的正斜杠路径，例如"templates/base.html"，不是r"templates\base.html"
pkgutil.get_data() 和 importlib.resources 怎么选
Python 3.7+ 推荐用 importlib.resources，它比 pkgutil 更安全、类型更明确，还能自动处理文本编码：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
-
pkgutil.get_data(__name__, "config.yaml")→ 返回bytes，需手动.decode("utf-8") -
importlib.resources.read_text(__name__, "config.yaml")→ 直接返回str -
importlib.resources.files(__name__).joinpath("img/logo.png").read_bytes()→ 更现代的 API，支持路径操作
注意：importlib.resources 在 Python importlib_resources，而 pkgutil 全版本内置，但已不推荐用于新项目。
动态加载包内模块时怎么顺便读资源
当你用 pkgutil.iter_modules() 发现插件模块后，不能直接用那个模块对象去调 get_data() —— 因为 get_data() 第一个参数是包名字符串，不是模块对象。
- 假设你遍历
plugins包得到模块名"auth"，正确写法是：pkgutil.get_data("plugins.auth", "schema.json") - 如果插件模块本身定义了
__package__，可复用它：pkgutil.get_data(module.__package__, "meta.toml") - 避免硬编码路径字符串；若模块结构不确定，优先用
importlib.resources.files(module.__name__)获取资源根路径
真正容易被忽略的是：pkgutil.get_data() 在 zip 导入（如 egg 或某些打包格式）下能工作，但在冻结包（frozen executable）中可能失效——PyInstaller 等工具会绕过标准导入机制，此时应改用 sys._MEIPASS 或 importlib.resources 的兼容层。
