如何使用Git管理多项目共用的单元文件

一、解决当前文件未提交到远程仓库的核心问题 #

你的共用单元文件存放在Git项目目录之外，Git默认只会追踪仓库目录内的文件，所以直接把文件关联到项目里，Git也不会识别和提交。这里给你两种可行方案：

方案1：用Git子模块（推荐长期维护） #

这是处理跨项目共用代码的标准方式，把共用单元做成独立仓库，嵌入到各个项目中：

• 第一步：给共用单元单独建Git仓库
  打开命令行，进入共用单元所在的文件夹，执行：

  git init
  git add .
  git commit -m "初始化共用单元仓库"
  

  然后把这个仓库推到远程代码托管平台。
• 第二步：在现有项目中引入子模块
  回到你的项目仓库目录，执行：

  git submodule add <共用仓库的远程地址> ./shared-units
  

  这里./shared-units是你想在项目里存放共用文件的路径，可根据需求修改。
• 第三步：提交子模块配置
  执行：

  git add .gitmodules ./shared-units
  git commit -m "添加共用单元子模块"
  git push
  

  完成后远程仓库就会显示子模块的引用，其他开发者拉取项目时，执行git submodule update --init就能获取到共用文件。

方案2：硬链接到项目仓库内（临时过渡用） #

如果不想折腾子模块，可通过硬链接把外部文件映射到项目目录里，让Git能追踪到：

• 在项目仓库里新建一个目录（比如shared），然后用Windows命令创建硬链接：

  mklink /H .\shared\你的单元文件名.pas D:\外部文件的完整路径.pas
  

• 执行git add .\shared\*，提交并推送到远程，这样文件就能出现在在线仓库里。但这种方式在多项目同步时容易出问题，不推荐长期使用。

二、Delphi GUI中提交这些文件的操作方法 #

Delphi的Git集成只认仓库目录内的文件，所以按以下步骤操作：

• 如果用了子模块：先在命令行执行git submodule update --init初始化子模块，回到Delphi后，Git面板会自动识别子模块目录里的文件，你在提交界面勾选这些文件就能一起提交。
• 如果用了硬链接：只要链接文件在项目仓库内，Delphi的Git面板会直接显示这些文件，勾选后提交即可。

三、后续多项目共用的维护建议 #

以后其他项目要使用这些单元文件时：

• 用子模块的话，直接在新项目仓库执行git submodule add <共用仓库地址> ./shared-units就能引入；如果共用文件有更新，在子模块目录执行git pull，回到主项目提交子模块的更新记录，所有引入该子模块的项目都能同步更新。
• 绝对不要直接复制文件到多个项目，否则后续修改要手动同步到所有项目，维护成本会非常高。

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