如何在更新依赖时保留Golang项目vendor依赖的自定义修改？

碰到这种改了vendor依赖又没法推上游的情况，我之前帮好几个开发者梳理过可行的方案，你可以根据自己的修改规模和维护周期来选：

如果你的改动只是几行代码的小修复或者适配，补丁是最轻量化的方案，步骤很清晰：

• 先把你的自定义修改生成补丁文件：进入vendor目录下的目标依赖文件夹，执行git diff > ../../patches/my-custom-fix.patch，把补丁文件放在项目根目录专门的patches文件夹里（没有就新建一个）。
• 当你需要更新vendor依赖时，先确保补丁已经保存好，然后执行dep ensure -update拉取上游最新代码。
• 更新完成后，回到项目根目录，执行patch -p1 < patches/my-custom-fix.patch重新应用你的修改。如果出现冲突，手动解决冲突后保存即可。
• 记得把patches文件夹和补丁文件一起提交到你的项目仓库，这样团队其他成员也能复用你的修改。

如果你的修改比较大，或者需要长期维护这些自定义逻辑，fork依赖仓库是更稳妥的选择：

• 先把上游的依赖仓库fork到你自己的代码托管账号（比如GitHub/GitLab）下，然后把你的自定义修改提交到fork仓库的一个专属分支（比如custom-adaptation）。
• 修改项目根目录的Gopkg.toml，把这个依赖的来源指向你的fork仓库，同时指定你修改后的分支或commit：

  [[constraint]]
    name = "github.com/upstream-org/upstream-repo"
    branch = "custom-adaptation"
    source = "github.com/your-username/your-fork-repo"
  

• 执行dep ensure，dep就会从你的fork仓库拉取带有自定义修改的代码。后续要更新上游依赖时，只需要把上游仓库的最新代码merge到你的fork分支里，解决冲突后，再更新Gopkg.toml里的分支或commit，重新执行dep ensure即可。

如果你的修改很小，且短期内完全不需要更新这个依赖，可以临时锁定版本来避免修改丢失，但不推荐长期用：

• 在Gopkg.toml里把该依赖的版本锁定到你修改后的commit哈希：

  [[constraint]]
    name = "github.com/upstream-org/upstream-repo"
    revision = "abc123def4567890" # 替换成vendor里该依赖当前的commit hash
  

• 这个方法的弊端很明显：你没法获取上游的任何更新，除非手动把上游代码merge到这个指定的commit里，所以只适合临时应急场景。

额外提醒 #

• 不管用哪种方案，一定要把和修改相关的文件（补丁、Gopkg.toml的修改、fork仓库的分支）同步到你的项目仓库，避免本地修改丢失。
• 用补丁方案时，每次更新依赖后都要检查补丁是否能正常应用，上游可能修改了相关代码导致冲突，提前解决能避免后续问题。
• 用fork方案时，记得定期同步上游仓库的更新，不然你的fork和上游差距太大，后续merge会非常麻烦。

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