PHP代码分支合并实为Git操作，需确保工作区干净；合并后须验证逻辑、语法、测试及autoload是否正常。
PHP 本身没有分支概念，所谓“合并 PHP 代码分支”实际是 Git 对 PHP 项目源码的分支操作——不是语言特性，而是版本控制行为。
Git 合并前必须确认当前工作区干净
很多看似“合并失败”的问题，根源是未提交或未暂存的修改冲突了 git merge 流程。Git 不会自动覆盖你本地的改动。
- 运行
git status查看是否有modified、untracked文件 - 用
git add . && git commit -m "save work"提交，或git stash暂存（之后可用git stash pop恢复） - 若强行合并，Git 可能中断并提示
error: Your local changes to the following files would be overwritten by merge
merge 和 rebase 的选择取决于协作规范
二者都可把 feature 分支变更集成进 main，但历史记录形态不同，影响团队可读性与回溯效率。
-
git checkout main && git merge feature/login：保留原始提交时间线，生成一个合并提交（commit），适合公开分支（如main、develop） -
git checkout feature/login && git rebase main：把当前分支所有提交“重放”到main最新基础上，历史呈线性，适合尚未推送的私有功能分支 - 已
push到远程的分支，慎用rebase；强制推送（git push --force-with-lease）可能破坏他人本地历史
合并后务必验证 PHP 代码逻辑是否受影响
Git 能解决文本层面的冲突，但无法识别语义错误。比如两个分支都改了同一个 config.php 中的数据库端口，Git 可能自动合并成功，但最终配置值可能是错的。
立即学习“PHP免费学习笔记（深入）”；
- 检查关键文件：入口脚本（如
index.php）、配置文件（config/*.php）、路由定义、依赖注入容器注册 - 运行
php -l批量语法检查：find . -name "*.php" -exec php -l {} \; 2>/dev/null | grep -v "No syntax errors" - 如果项目有 PHPUnit，至少跑一次
vendor/bin/phpunit --testsuite=unit，重点看新增/修改路径的测试是否通过
真正容易被忽略的，不是命令怎么敲，而是合并后没验证 autoload 是否仍正常——比如两个分支各自加了新类但没更新 composer dump-autoload，或者 PSR-4 映射在 composer.json 里被覆盖了。
