Python Unittest测试文件路径适配：PyCharm与CLI/GitHub Actions兼容方案

核心方案：基于测试脚本位置构建绝对路径 #

避免相对路径歧义的关键是不依赖当前工作目录，而是从测试脚本自身的位置出发，构建测试文件的绝对路径。以下是两种可靠实现方式：

方法1：利用__file__属性（推荐） #

这是最通用的方式，直接基于当前测试脚本的路径拼接目标文件：

import os
import unittest

class YourTestClass(unittest.TestCase):
    def setUp(self):
        # 获取当前测试脚本的绝对目录
        current_test_dir = os.path.dirname(os.path.abspath(__file__))
        # 拼接测试文件的完整路径
        self.test_file = os.path.join(current_test_dir, "files", "my_reference.txt")

• 原理：__file__返回当前测试脚本的路径，os.path.abspath确保是绝对路径，os.path.dirname提取脚本所在目录，最后用os.path.join安全拼接子目录和文件名。
• 适配场景：所有运行环境（PyCharm、本地CLI、GitHub Actions）都能正确定位文件。

方法2：基于项目根目录构建（适合复杂项目） #

如果项目层级多，可以先定位到项目根目录，再拼接测试文件路径：

import os
import unittest

class YourTestClass(unittest.TestCase):
    def setUp(self):
        # 从测试脚本向上回溯到项目根目录（假设测试脚本在tests目录下）
        project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
        # 拼接测试文件路径
        self.test_file = os.path.join(project_root, "tests", "files", "my_reference.txt")

• 原理：通过两次os.path.dirname从tests目录回到项目根目录，再明确指定tests/files路径。
• 适配场景：项目结构固定，需要统一以根目录为基准的场景。

验证方式 #

• PyCharm：直接运行测试脚本或使用unittest runner，路径自动解析正确。
• 本地CLI：在项目根目录执行python -m unittest discover -s ./tests -p "*_tests.py"，测试文件可正常访问。
• GitHub Actions：默认工作目录为项目根目录，执行上述相同命令即可正常运行测试。

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