Python包文件加载路径问题：fr.json未从包所在目录加载

这个问题我之前开发Python包时也碰到过——硬编码路径确实会在移动包结构或部署到不同环境时翻车，核心是要基于包的内部结构定位资源，而非依赖外部工作目录或导入上下文。下面给你几个靠谱的解决方案：

方法1：利用模块的__file__属性构建可靠路径 #

这是兼容所有Python版本的通用方案，核心是通过当前模块文件的绝对路径，推导出资源文件的相对位置：

假设你的包结构大概是这样（可根据实际情况调整）：

my_word_package/
├── fr.json       # 你的单词列表文件
├── bin/
│   └── Parser/
│       ├── __init__.py
│       └── parser.py  # 定义Parser类的文件
└── __init__.py

在parser.py里可以这么写：

import os
import json

class Parser:
    def __init__(self):
        # 获取当前parser.py文件的绝对路径
        module_path = os.path.abspath(__file__)
        # 获取parser.py所在的目录
        module_dir = os.path.dirname(module_path)
        # 从module_dir回溯到包根目录，拼接fr.json的路径
        # 这里的../../根据目录层级调整，若fr.json和parser.py同目录则直接写'fr.json'
        json_file_path = os.path.normpath(os.path.join(module_dir, '../../fr.json'))
        
        with open(json_file_path, 'r', encoding='utf-8') as f:
            self.word_list = json.load(f)

os.path.normpath会自动清理路径里的../符号，只要包内部的文件相对结构不变，不管你把包移到哪里，这个路径都能正确找到资源。

方法2：用importlib.resources（Python 3.9+推荐） #

从Python 3.9开始，标准库提供了importlib.resources模块，专门处理包内资源，用法更简洁，无需手动拼接路径：

还是基于上面的包结构，在parser.py里：

import importlib.resources
import json

class Parser:
    def __init__(self):
        # 第一个参数是资源所在的包名（这里fr.json在根包my_word_package下）
        with importlib.resources.open_text('my_word_package', 'fr.json', encoding='utf-8') as f:
            self.word_list = json.load(f)

如果fr.json在bin.Parser目录下，就把第一个参数改成'my_word_package.bin.Parser'即可。这个方法会自动处理包的安装路径（比如安装到site-packages的情况），完全不需要关心包的物理位置。

额外提示：打包发布时的资源配置 #

如果你打算把这个包打包发布（比如用pip安装），记得在setup.py或pyproject.toml里配置package_data，确保资源文件被包含到安装包里：

在setup.py中添加：

from setuptools import setup, find_packages

setup(
    name='my_word_package',
    packages=find_packages(),
    package_data={
        # 键是包名，值是资源文件的相对路径列表
        'my_word_package': ['fr.json'],
        # 若资源在子包则写：'my_word_package.bin.Parser': ['fr.json']
    },
)

这样用户安装你的包后，上面两种方法都能正常访问到fr.json文件。

内容的提问来源于stack exchange，提问作者Pascal de Sélys