Visual Studio .NET、Eclipse Java等多团队共享JSON文件的自动化方案咨询

针对多团队共用静态JSON文件、手动同步效率低的问题，结合GitHub Enterprise特性，提供以下落地方案：

第一步：统一单一数据源 #

先将这套JSON文件迁移到独立的GitHub Enterprise仓库，作为唯一的数据源仓库。所有变更仅提交到该仓库，彻底避免分散维护的混乱。

自动化同步/集成方案 #

1. GitHub Actions 自动同步到各团队仓库 #

配置工作流，当数据源仓库有更新时，自动将最新JSON文件同步到.NET、Java、Python团队的仓库指定目录，甚至可自动提交PR（如需审核）。

简化版工作流示例（可放在数据源仓库或目标仓库）：

name: Sync Static JSON Assets
on:
  push:
    branches: [ main ]
    paths:
      - 'path/to/your/static.json' # 仅在JSON文件变更时触发

jobs:
  sync-to-teams:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        target-repo:
          - 'org/dotnet-team-repo1'
          - 'org/dotnet-team-repo2'
          - 'org/java-team-repo'
          - 'org/python-team-repo'
        target-path:
          - 'src/assets/static.json' # 各仓库对应的存放路径，按需调整
    steps:
      - name: Checkout source repo
        uses: actions/checkout@v4

      - name: Checkout target repo
        uses: actions/checkout@v4
        with:
          repository: ${{ matrix.target-repo }}
          path: target-repo
          token: ${{ secrets.SYNC_PAT }} # 需要给PAT赋予目标仓库的写入权限

      - name: Copy JSON file to target
        run: cp path/to/your/static.json target-repo/${{ matrix.target-path }}

      - name: Commit and push changes
        run: |
          cd target-repo
          git config user.name "GitHub Actions Sync Bot"
          git config user.email "actions-sync@your-enterprise.com"
          git add ${{ matrix.target-path }}
          if git diff --cached --quiet; then
            echo "No changes to commit"
            exit 0
          fi
          git commit -m "Sync latest static JSON from assets repo"
          git push

• 注意：需在GitHub Enterprise中创建带仓库写入权限的个人访问令牌（PAT），作为Secrets存入触发工作流的仓库。

2. Git子模块（Submodule） #

让各团队仓库将数据源仓库作为子模块引入，拉取代码时自动同步JSON文件，适合变更频率低的场景。

操作命令（各团队仓库执行）：

# 添加子模块到指定目录
git submodule add https://your-ghe-domain/org/assets-repo.git ./static-assets

# 拉取子模块最新内容（团队成员每次拉代码后可执行）
git submodule update --remote

• 可将git submodule update --remote加入CI/CD构建流程，确保部署时使用最新文件。

3. 语言生态包管理集成 #

将JSON文件打包成对应语言的包，通过GitHub Packages托管，各团队通过依赖管理工具引入，部署时自动包含：

• Java：把JSON文件放到空的Maven项目中，打包成JAR发布到GitHub Packages，Java项目通过Maven/Gradle依赖引入，代码中读取JAR内的JSON文件。
• .NET：创建类库项目，将JSON文件设置为"嵌入资源"或"复制到输出目录"，打包成NuGet包发布到GitHub Packages，.NET项目安装该NuGet包即可获取文件。
• Python：把JSON文件放到简单的Python包中，发布到GitHub Packages，Python项目通过pip install git+https://your-ghe-domain/org/assets-repo.git或依赖配置引入。

方案选型建议 #

• 最快落地、维护成本最低：选独立数据源仓库 + Git子模块，适配静态文件不常变更的场景。
• 完全解放团队手动操作：选独立数据源仓库 + GitHub Actions自动同步，全程自动化无需人工干预。
• 贴合各团队现有开发流程：选语言包管理集成，符合Java/.NET/Python的依赖管理习惯。

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