我给客户维护的 Tigshop 项目基本都做过二开所以每次官方发新版我从来不敢直接git pull覆盖上去。早年吃过一次亏自己改过的 Service 被官方版本盖掉排查了大半天从那以后就养成一套固定动作。先看官方到底改了什么别急着合。进到php/目录把上游拉下来对一遍日志心里有数再动手cdphpgitfetch origingitlog HEAD..origin/master--oneline一屏 commit 扫下来是修 bug、加功能还是动了数据库结构大致能看出来。如果 release 说明里提到表结构变更这次升级就得格外小心。官方仓库在 https://github.com/tigshop/Tigshop.git配成 upstream 拉就行。备份两样都要数据库导一份代码打个 tag缺一不可gittag before-merge-20260721出事了能秒回退别嫌麻烦。用 merge不用覆盖我用 merge 不用 pull 覆盖就是要让冲突显式暴露出来自己一处处过gitmerge origin/mastercomposerinstallphp thinkclear如果 release 里带了迁移脚本按它的说明补一句php think migrate别自己瞎猜命令。冲突高发就三个地方php/app/service/里你自己改过的业务类、根目录的.env、装修保存的那些 JSON 配置。合并时重点盯这几处逐行看清楚再决定留谁的。.env尤其别被官方的示例配置盖掉数据库密码、Redis、支付密钥都在里面。二开量大的项目长期开一条自己的分支官方 master 只当上游来 merge别在 master 上直接改代码不然每次升级都是灾难。合完先在测试环境跑主线合并完别直接上生产。先在测试环境把下单、支付、后台这三条主线各点一遍没问题再发。还有个习惯Tigshop 每次发版社区里都有讨论帖先升的人会把坑贴出来。我一般等个一两天扫完帖子再动手比自己闷头 merge 稳当。