PyCharm/IntelliJ运行单测时非根路径启动引发文件路径错误问题求助

我之前用PyCharm做Python开发时也踩过一模一样的坑——单个测试用例运行时，IDE默认把工作目录设成了测试文件所在的子目录，导致硬编码的相对路径全乱套，改来改去总有场景出问题。下面给你几个实用的解决方案，从IDE配置到代码层面都覆盖到了：

方法1：修改IDE默认测试运行模板（一劳永逸） #

这个方法能让所有单个测试用例都从项目根目录启动，彻底解决路径适配问题：

• 点击IDE右上角运行按钮旁的下拉菜单，选择「Edit Configurations...」
• 在弹出的窗口里，点击左上角的齿轮图标，选择「Edit Configuration Templates...」
• 左侧列表找到「Python Tests > Unittest」，进入配置页面
• 在「Configuration」标签下，找到「Working directory」，点击右侧带$的宏按钮，选择$PROJECT_DIR$（会自动指向你的项目根目录）
• 点击「Apply」和「OK」保存模板

之后不管你右键运行单个测试方法、测试类还是整个测试文件，IDE都会自动以项目根目录作为工作路径，你的相对路径只需要从根目录开始写（比如private_key_path = 'sample/example.txt'）就行。

方法2：代码中动态计算项目根目录（更健壮） #

就算IDE配置出问题，或者用命令行运行测试，这个方法也能保证路径正确。核心是通过代码自动定位项目根目录，而非硬编码相对层级：

import os

def get_project_root():
    # 从当前文件所在目录往上遍历，找到项目标志性文件/目录（比如.git、requirements.txt）
    current_path = os.path.abspath(os.path.dirname(__file__))
    # 这里用.git目录作为判断依据，你也可以换成项目独有的文件，比如config.ini
    while not os.path.exists(os.path.join(current_path, '.git')):
        current_path = os.path.dirname(current_path)
        # 防止无限循环，到系统根目录还没找到就抛出异常
        if current_path == os.path.dirname(current_path):
            raise FileNotFoundError("无法找到项目根目录，请检查是否存在.git目录")
    return current_path

# 用os.path.join拼接路径，跨平台也能正常工作
project_root = get_project_root()
private_key_path = os.path.join(project_root, 'sample', 'example.txt')

这种方式完全不依赖运行时的工作目录，不管从哪里启动测试，都能精准定位到目标文件。

方法3：切换到pytest（可选） #

如果愿意换测试框架，pytest默认会以项目根目录作为工作路径，路径处理更灵活，很多时候不用额外配置就能避开这类问题。不过需要你把unittest的测试用例做简单适配，成本不高，看项目需求选择即可。

IntelliJ的配置逻辑和PyCharm完全一致（毕竟是同一家公司的产品），按照方法1操作就能解决同样的问题。

内容的提问来源于stack exchange，提问作者Trần Kim Dự