应使用importlib.resources替代__file__拼路径，因其能统一处理源码运行和打包后资源读取；打包工具还需显式声明资源文件，否则资源虽可读但未被包含。
Python项目中资源文件（如图片、配置文件、模板、数据文件等）的管理与打包，常因路径处理不当导致程序在开发环境能运行、打包后却报错“File not found”。核心问题不在代码逻辑，而在资源定位方式未适配不同运行场景（源码运行 vs. 打包后执行）。解决的关键是：用 importlib.resources（Python 3.9+）或 importlib_resources（旧版本兼容），替代硬编码路径或 os.path.join(os.path.dirname(__file__), ...)。
为什么不能用 __file__ 拼路径？
当项目被 PyInstaller、cx_Freeze 或 setuptools 打包成单文件（如 .exe 或 .whl）时，资源文件通常被压缩进归档，不再以独立文件形式存在于磁盘。此时 __file__ 指向的是临时解压目录或根本不可访问的位置，os.path 系列操作会失效。
- 开发时：
myapp/icons/logo.png是真实文件路径 →os.path.join(...)可行 - 打包后（尤其是 --onefile）：
logo.png在 zip 包内 → 必须通过资源 API 读取字节流或提取到临时位置 - 使用
importlib.resources可统一处理两种情况，无需条件分支
推荐做法：用 importlib.resources 安全读取资源
假设你的项目结构如下：
myapp/
├── __init__.py
├── main.py
└── resources/
├── config.json
└── templates/
└── report.html
在 main.py 中安全读取 config.json：
立即学习“Python免费学习笔记（深入）”；
Python 3.9+（标准库）：
from importlib import resources
import json
<h1>读取 JSON 内容（返回字符串）</h1><p>with resources.files('myapp').joinpath('resources/config.json').open('r') as f:
config = json.load(f)</p><h1>或直接读取为文本（推荐用于文本类资源）</h1><p>text = resources.files('myapp').joinpath('resources/templates/report.html').read_text()
Python < 3.9（需安装 backport）：
# pip install importlib-resources from importlib_resources import files # 后续用法完全一致
打包工具需显式声明资源文件
即使代码用了正确 API，打包工具仍需知道哪些文件要包含进分发包。否则资源虽可读，但实际未被打包进去。
-
PyInstaller：用
--add-data（注意路径分隔符）
Windows：pyinstaller --add-data "myapp/resources;myapp/resources" main.py
Linux/macOS：pyinstaller --add-data "myapp/resources:myapp/resources" main.py -
setuptools（wheel / sdist）：在
setup.py或pyproject.toml中声明setup.py示例：package_data={'myapp': ['resources/**/*']},pyproject.toml示例：[tool.setuptools.package-data] "myapp" = ["resources/**/*"]
-
注意：不要把资源文件放在
data_files（那是给系统级安装用的，不进包内）
进阶：动态资源路径与临时提取
某些库（如 GUI 图片加载、FFmpeg 调用）要求传入真实文件路径（而非文件对象）。此时需将资源提取到临时目录：
from importlib import resources
import tempfile
import shutil
<p>def get_resource_path(package, resource_path):
"""获取资源的真实文件路径（自动提取到临时目录）"""
with resources.files(package).joinpath(resource_path).open('rb') as src:
with tempfile.NamedTemporaryFile(delete=False) as dst:
shutil.copyfileobj(src, dst)
return dst.name</p><h1>使用示例</h1><p>icon_path = get_resource_path('myapp', 'resources/icons/app.ico')</p><h1>传给 tkinter.PhotoImage 或 PyQt 加载</h1><p>⚠️ 注意：该函数返回的临时文件需由调用方负责清理（例如程序退出时删除），或改用 tempfile.mkstemp() + 显式 os.unlink() 控制生命周期。
