如何拆分Laravel仓库以实现前端/API/管理员权限分离

结论：完全可以实现 #

针对你的需求，有多种成熟的Git方案可以实现核心开发者访问全量代码、新前端仅能操作指定模块，同时保留主仓库完整提交历史，以下是具体实现方式：

方案1：稀疏检出（Sparse Checkout）+ 权限分组 #

无需拆分物理仓库，通过Git的稀疏检出功能限制新开发者拉取的目录范围，配合仓库权限管控：

• 给核心开发者分配主仓库的全量读写权限，正常克隆、操作全量代码
• 给新前端开发者配置主仓库的读写权限，但指导他们使用稀疏检出仅拉取SPA模块目录：

  # 克隆时启用稀疏检出（仅拉取元数据，节省带宽）
  git clone --filter=blob:none --sparse <主仓库地址>
  cd <仓库名称>
  # 设置仅包含SPA模块所在目录（替换为实际路径）
  git sparse-checkout set spa/
  # 拉取对应目录的代码
  git pull
  

• 额外配置仓库钩子（如pre-receive），限制新开发者的提交只能修改SPA目录，防止其手动修改稀疏配置访问敏感代码

方案2：Git Subtree 拆分独立子仓库 #

将SPA模块从主仓库拆分出独立的子仓库，同时保留该模块的完整提交历史，实现物理隔离：

• 在主仓库中拆分SPA模块为独立分支：

  # 从主仓库拆分spa目录为独立分支
  git subtree split --prefix=spa/ --branch=spa-module
  # 创建新的子仓库，将拆分出的分支推送到新仓库
  git remote add spa-subrepo <子仓库远程地址>
  git push spa-subrepo spa-module:main
  

• 核心开发者继续使用主仓库，可通过git subtree pull/push同步主仓库与子仓库的提交
• 新前端开发者仅需克隆这个独立的SPA子仓库，拥有该子仓库的读写权限，完全无法访问主仓库的管理端与API代码
• 主仓库的全量提交历史完整保留，子仓库也继承了原SPA模块的所有提交记录

方案3：分支权限控制 + 目录保护 #

适合临时权限管控的轻量方案，无需拆分仓库：

• 在主仓库中创建专门的前端开发分支
• 在仓库管理后台（如GitLab/GitHub）配置权限：
  • 核心开发者可访问所有分支，拥有全量读写权限
  • 新前端开发者仅能访问前端开发分支，同时设置目录保护规则，禁止修改管理端（如admin/）、API（如app/Http/Controllers/API/）相关目录
• 配合你的在线开发服务器，新开发者在前端分支上开发，无法触及敏感代码范围

注意事项 #

• 稀疏检出方案需配合钩子限制提交范围，否则存在绕过风险；子仓库方案是物理隔离，安全性更高
• 远程办公场景下，优先推荐子仓库或分支权限控制方案，前者适合长期权限隔离，后者配置成本更低

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