如何获取GitLab分支/引用对比的原始diff或patch文件？

GitLab的分支对比页面无法像GitHub那样直接追加.diff/.patch后缀获取原始差异文件，但可以通过以下两种可靠方式获取可直接用于Composer等包管理器的URL：

方法1：使用GitLab API生成范围diff/patch #

GitLab的Repository Compare API支持直接获取任意两个分支/提交之间的diff或patch文件，返回结果可直接作为URL供包管理器调用。

构造API URL的规则： #

https://[GitLab实例域名]/api/v4/projects/[项目标识]/repository/compare?from=[起始分支/提交ID]&to=[目标分支/提交ID]&format=[diff|patch]

• 项目标识：可以是项目的数字ID，或者URL编码后的项目路径（比如drupal/core编码为drupal%2Fcore）
• format参数：指定diff获取纯差异文本，指定patch获取补丁文件格式

实例（针对git.drupalcode.org） #

比如要获取drupal/core项目1.x与2.x分支的patch文件，URL为：

https://git.drupalcode.org/api/v4/projects/drupal%2Fcore/repository/compare?from=1.x&to=2.x&format=patch

这个URL可直接填入Composer的patches配置中，无需手动下载或存储补丁文件。

注意：如果是私有项目，需要在URL中追加私有访问令牌参数（?private_token=[你的令牌]），公开项目无需额外验证。

方法2：通过Git命令生成后托管（备选） #

如果无法使用API，可通过本地Git命令生成差异文件，再将其托管到可公开访问的位置（比如GitLab的Gist或项目仓库），再获取URL：

# 克隆项目（如果未克隆）
git clone https://git.drupalcode.org/drupal/core.git
cd core
# 生成分支间的patch文件
git diff 1.x...2.x > branch-compare.patch

之后将branch-compare.patch上传到公开存储服务，得到可访问的URL即可用于Composer。

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