如何在Github中阻止Shopify主题JSON文件跨分支合并？

一、阻止跨分支合并的遗漏方案 #

1. GitHub Actions 自动化拦截 #

在PR合并前用GitHub Actions检查变更文件，若包含目标JSON文件，直接阻止合并或标记为需要手动处理：

name: Block JSON Merge
on:
  pull_request:
    branches: [live]

jobs:
  check-json-files:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Check for forbidden JSON changes
        run: |
          FORBIDDEN_FILES=$(git diff origin/live...HEAD --name-only | grep -E '(.json)$' | grep -E '(templates|sections|settings)')
          if [ -n "$FORBIDDEN_FILES" ]; then
            echo "Error: Cannot merge JSON files from templates/sections/settings directories into live branch"
            echo "Files found: $FORBIDDEN_FILES"
            exit 1
          fi

这个动作会在向live分支发起PR时自动检查，只要包含指定目录的JSON文件变更，就终止PR合并流程，强制团队遵守约定。

2. Git钩子（Hook）强化 #

除了.gitattributes，可以在仓库中添加预提交钩子和预合并钩子，在本地操作时就拦截对这些JSON文件的跨分支提交：

• 预提交钩子：检查当前分支是否为live，若提交包含目标JSON文件则拒绝
• 预合并钩子：合并前检查来源分支的变更，若有目标JSON文件则终止合并

钩子需要团队成员统一配置，可通过仓库的hooks目录+脚本分发，确保所有人都启用。

二、取消JSON文件的GitHub跟踪是否会破坏Shopify主题？ #

不会。Shopify主题的运行依赖于服务器上的文件，只要Shopify后台的主题文件完整，GitHub仓库中取消跟踪这些JSON文件（用.gitignore添加规则），只会影响双向同步时的GitHub侧记录，不会导致Shopify主题功能异常。

但要注意两点：

• 取消跟踪后，主题编辑器的修改不会再同步到GitHub，需要营销团队自行记录重要的编辑器变更
• 若后续需要从GitHub重新部署主题到Shopify，要确保部署时不会覆盖Shopify上的JSON配置（可通过Shopify CLI的部署参数指定忽略这些文件）

三、保留JSON文件时的合并过滤方法 #

1. PR合并时手动选择文件 #

在GitHub的PR页面，使用**"选择特定文件合并"**功能，合并时只挑选非JSON的代码文件，跳过所有目标JSON文件的变更。这是最直接的手动控制方式，适合团队规模不大的场景。

2. 自定义Git合并策略脚本 #

编写自定义的合并脚本，在合并时自动忽略指定JSON文件的变更，替换.gitattributes中的merge=ours为自定义脚本：

1. 创建脚本.git/merge-scripts/ignore-json.sh：

#!/bin/sh
# 忽略指定JSON文件的合并变更
git checkout --ours "$1"
exit 0

2. 给脚本添加执行权限：chmod +x .git/merge-scripts/ignore-json.sh
3. 在.gitattributes中设置：

*.json merge=ignore-json

4. 配置Git识别自定义合并驱动：

git config merge.ignore-json.driver ".git/merge-scripts/ignore-json.sh %A"

这个方法能让Git在合并时自动保留当前分支的JSON文件版本，覆盖来源分支的变更，且对PR合并有效（前提是仓库配置了该驱动，可通过仓库的config文件同步给团队）

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