如何分离Django应用，实现GitHub仓库中Python工具文件私有化？

嘿，这个需求我刚好帮朋友处理过类似的，结合你的Python/Django/GitHub/Heroku技术栈，给你几个靠谱的解决方案：

这个方法核心是把你的Python工具文件单独放在私有GitHub仓库里，再将这个私有仓库作为子模块嵌入给承包商的主项目仓库（公开/半公开均可）。承包商能正常访问主项目，但因为子模块仓库是私有的，他们没有权限的话根本拉取不到工具文件内容，完美隔离私有代码。

具体步骤：

• 先创建一个私有GitHub仓库（比如叫python-tools），把所有工具文件移进去并提交推送。
• 回到你的Django主项目仓库，执行命令添加子模块：

  git submodule add git@github.com:你的用户名/python-tools.git project_root/tools
  

  这里的project_root/tools是工具文件在Django项目里的存放路径，后续Django代码正常导入即可（记得把这个路径加到Python的sys.path或者Django的配置里）。
• 提交主项目里生成的.gitmodules文件和子模块引用，推送到主仓库。
• 给承包商主仓库的访问权限，但绝不提供私有工具仓库的权限。他们拉取主项目时，子模块目录会显示为空或提示权限不足，完全看不到你的私有代码。
• 部署到Heroku时，你自己拉取代码要记得初始化子模块：

  git submodule update --init --recursive
  

  如果是自动部署，也可以把这条命令加到Heroku的构建脚本里——因为你有权限，能正常拉取私有子模块内容。

如果觉得子模块的.gitmodules维护有点麻烦，Git Subtree是个更轻量化的选择。它会把私有仓库的内容直接合并到主项目的指定目录，但只有你能管理私有仓库的更新，承包商只能看到合并后的静态内容，无法触及私有仓库本身。

具体步骤：

• 同样先把工具文件放到私有仓库python-tools。
• 在主项目仓库里，将私有仓库作为subtree拉取到目标目录：

  git subtree add --prefix=project_root/tools git@github.com:你的用户名/python-tools.git main
  

• 你自己更新工具文件时，可直接在主项目的对应目录修改，然后推送到私有仓库：

  git subtree push --prefix=project_root/tools git@github.com:你的用户名/python-tools.git main
  

• 给承包商主仓库权限后，他们看到的工具目录是你合并过去的内容，但无法推送到私有仓库，也看不到私有仓库的提交历史。后续你更新工具后，重新合并到主仓库，承包商拉取就能看到更新，但依然碰不到私有代码。
• Heroku部署和正常项目完全一致，因为subtree内容已经在主仓库里了，不需要额外操作。

如果实在不想拆分两个仓库，可以试试GitHub的精细目录权限——不过这个需要你用GitHub Team或Enterprise付费计划（免费版不支持）。你可以把主仓库设为私有，给承包商添加协作者，然后通过GitHub的权限设置限制他们只能访问指定目录。不过这个方式不如前两个方案稳妥，免费版也用不了，所以更推荐前两种拆分仓库的方式。

• 确保Django项目能正确导入工具文件，比如在settings.py里添加工具目录到sys.path：

  import sys
  import os
  sys.path.append(os.path.join(BASE_DIR, 'project_root/tools'))
  

• 用子模块部署到Heroku时，要确保Heroku能访问你的私有仓库：可以把SSH密钥添加到Heroku账户，或者用GitHub个人访问令牌（PAT）来拉取子模块。
• 拆分仓库前，一定要用git filter-repo清理主仓库的历史，彻底删除工具文件的提交记录——不然承包商可能通过历史记录挖到私有代码。

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