Django项目集成Pipeline执行collectstatic时路径正确仍报FileNotFoundError

云原生阿岚

2026-8-8

Django Pipeline collectstatic 报 WinError 2（FileNotFoundError）解决方案

以下是针对问题的排查和修复方向：

1. 统一路径分隔符为正斜杠

Windows下的反斜杠\\在Django和Pipeline中可能引发路径解析异常，将settings.py中PIPELINE配置里的路径全部替换为正斜杠/：

PIPELINE = {
    'PIPELINE_ENABLED': True,
    'STYLE': {
        'base': {
            'source_filenames': (
                'css/core/header.css',
                'css/core/reset.css',
                'css/core/style.css'
            ),
            'output_filename': 'css/core/base.css'
        },
    }
}

2. 安装对应压缩工具

Pipeline处理CSS压缩依赖第三方工具，默认使用cssmin，先确保它已安装：

pip install cssmin

如果配置了其他压缩器（如YUI Compressor），需确保工具已安装并添加到系统环境变量PATH中，否则subprocess会因找不到可执行文件抛出FileNotFoundError。

3. 修正STATIC_ROOT配置

确保STATIC_ROOT是绝对路径，且不要与源静态文件目录同名（避免collectstatic时覆盖或混淆）：

from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
STATIC_ROOT = BASE_DIR / "staticfiles"  # 改用staticfiles作为收集目录，而非源静态目录static
STATICFILES_DIRS = [
    BASE_DIR / "static",  # 指定源静态文件所在目录
]

4. 显式配置Pipeline压缩器

在PIPELINE配置中明确指定压缩器，避免默认查找失败：

PIPELINE = {
    'PIPELINE_ENABLED': True,
    'CSS_COMPRESSOR': 'pipeline.compressors.cssmin.CSSMinCompressor',
    'STYLE': {
        'base': {
            'source_filenames': (
                'css/core/header.css',
                'css/core/reset.css',
                'css/core/style.css'
            ),
            'output_filename': 'css/core/base.css'
        },
    }
}