如何验证GitLab CI任务未修改已追踪文件并检查生成文件一致性？

一、验证CI任务未修改Git已追踪文件 #

核心是确保CI执行过程中不会意外改动仓库内已被Git追踪的文件（比如误改源码、配置，或编译产物覆盖原文件等），直接通过Git命令在CI任务中校验即可：

CI Job 配置 #

verify-no-modified-tracked-files:
  stage: check
  before_script:
    # 忽略文件权限变化（部分CI环境会自动调整权限，避免误判）
    - git config core.fileMode false
  script:
    # 先执行你的核心构建/测试逻辑，示例：
    # - npm install
    # - npm run test
    # 校验工作区未暂存的修改
    - git diff --no-ext-diff --exit-code
    # 校验暂存区已暂存但未提交的修改
    - git diff --cached --no-ext-diff --exit-code
  allow_failure: false

逻辑说明 #

• git diff --exit-code：对比工作区与HEAD的差异，若存在未暂存修改，返回非0值触发CI任务失败。
• git diff --cached --exit-code：对比暂存区与HEAD的差异，防止CI流程中出现偷偷暂存修改的情况。
• core.fileMode false：规避CI环境自动调整文件权限导致的误报。

二、检查生成文件与Git已提交文件的差异 #

用于确保构建生成的文件（比如编译后的前端资源、自动生成的文档）和仓库已提交版本完全一致，避免本地生成与仓库版本不符的问题：

CI Job 配置 #

check-generated-files-consistency:
  stage: check
  script:
    # 执行生成文件的命令，示例：
    - npm run build # 生成前端静态资源
    # 校验指定生成文件与仓库已提交版本的差异
    - git diff --no-ext-diff --exit-code -- dist/ docs/
  allow_failure: false

逻辑说明 #

• 先执行生成命令，确保生成最新版本的目标文件。
• git diff --exit-code -- <路径>：仅对比指定路径下的文件与HEAD的差异，若存在不一致则返回非0，CI任务失败。
• 如果生成文件包含动态内容（比如时间戳、随机ID），需在生成脚本中固定这些变量（比如用环境变量指定版本号），否则会导致误判。

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