Django项目存储单元测试用扁平数据文件是否有通用标准实践？

不推荐存储在STATIC或MEDIA目录的原因 #

• STATIC目录存储的是生产环境需要部署的前端静态资源，测试数据混入后会导致collectstatic收集冗余文件，甚至存在测试数据被误发布到公网的风险
• MEDIA_ROOT是运行时存储用户上传文件的目录，测试过程中可能存在写入、清空逻辑，固定测试数据放在这里容易被污染，也不符合MEDIA目录的设计定位

推荐存储方案 #

通用的社区标准实践是将测试用固定数据存储在测试专用的fixtures目录下，根据使用范围分为两种布局：

• 多app共用的全局测试数据：存放在项目根目录下的tests/fixtures/（或test_data/）目录，和manage.py、各app目录同级
• 单app专用的测试数据：存放在对应app目录下的app_name/tests/fixtures/目录，仅当前app的测试用例调用

配置方法 #

你可以在Django配置文件中添加专用路径变量，方便全局调用：

# settings.py （如果仅测试环境使用，建议放到test.py专属配置文件中）
from pathlib import Path

# 项目根路径是Django默认生成的配置，无需重复写
BASE_DIR = Path(__file__).resolve().parent.parent

# 全局测试数据目录配置
TEST_DATA_DIR = BASE_DIR / "tests" / "fixtures"

对应的项目目录结构参考：

项目根目录/
├── manage.py
├── 主配置目录/
│   ├── __init__.py
│   ├── settings.py
│   └── urls.py
├── tests/
│   ├── __init__.py
│   └── fixtures/ # 对应TEST_DATA_DIR路径
│       └── filename.csv
└── 应用目录/
    ├── __init__.py
    ├── tests/
    │   ├── __init__.py
    │   └── fixtures/ # 应用私有测试数据目录
    └── views.py

修正后的示例代码 #

from pathlib import Path 
from django.conf import settings
from django.core.files.uploadedfile import SimpleUploadedFile
from django.test import TestCase
# 此处假设你已自行实现get_content_type方法，省略对应导入

def simulate_uploaded_file(data_path: Path, filename: str):
    content_type = get_content_type(filename)
    filepath = data_path / filename
    # 推荐用with上下文管理文件句柄，避免资源泄露
    with open(filepath, 'rb') as f:
        content = f.read()
    return SimpleUploadedFile(filename, content, content_type)

class TestFileHandler(TestCase):
    @classmethod
    def setUpTestData(cls):
        test_data_path: Path = settings.TEST_DATA_DIR
        cls.valid_csv: SimpleUploadedFile = simulate_uploaded_file(test_data_path, 'filename.csv')

补充注意事项 #

• 体积较小的固定测试数据可以和代码一起提交到Git仓库，体积较大的测试数据集建议添加到.gitignore，通过其他方式同步
• 测试过程中生成的临时文件不要存储到fixtures目录，建议使用系统临时目录或Django测试自带的临时存储方案，避免污染静态测试数据

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