如何在Python3 Wheel包中获取已打包的数据文件路径？

我来帮你解决这个问题！当你用data_files把数据文件打包进Wheel后，这些文件的安装位置和你的Python包目录是分开的，直接用相对路径肯定找不到。这里有两种靠谱的方法来获取它们的路径：

方法一：使用pkg_resources（兼容所有Python 3版本） #

pkg_resources是setuptools自带的工具，能帮你定位包的资源文件。在你的包代码（比如my_project/awesome_feature.py或者__init__.py）里可以这么写：

from pkg_resources import resource_filename

def get_data_file_path(filename):
    # 第一个参数是你的包名（必须和setup.py里的name一致），第二个是数据文件的相对路径
    return resource_filename('my_project', f'data/{filename}')

# 示例：获取config.txt的路径
config_file_path = get_data_file_path('config.txt')
# 如果有子目录里的文件，比如data/subdir/file.csv
subdir_file_path = get_data_file_path('subdir/file.csv')

这个方法会自动处理安装后的路径映射，不管你是在开发环境还是安装后的环境中运行代码，都能正确找到文件。

方法二：使用importlib.resources（Python 3.7+推荐） #

从Python 3.7开始，标准库提供了importlib.resources模块，比pkg_resources更轻量，是官方推荐的方式。代码示例如下：

import importlib.resources

def get_data_file_path(filename):
    # 这里的'my_project.data'对应安装后的data目录（因为data_files里的目标路径是'data'）
    with importlib.resources.path('my_project.data', filename) as path:
        return str(path)

# 调用方式和上面一样
config_file_path = get_data_file_path('config.txt')

如果你的数据文件有多层子目录，比如data/subdir/file.csv，可以写成：

with importlib.resources.path('my_project.data.subdir', 'file.csv') as path:
    return str(path)

注意事项 #

• 确保setup.py里的name参数和你代码里引用的包名完全一致（比如这里的my_project）。
• 如果你的data_files配置是('data', glob('data/**'))，要确保glob能正确匹配所有需要的文件（可以加上recursive=True，比如glob('data/**', recursive=True)），避免漏打包文件。

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