应统一git分支命名、清理runtime缓存、安全回滚时清除thinkphp缓存、慎用revert处理配置变更：强制使用main/release/feature/fix前缀；执行git rm -r --cached runtime/并提交；回滚后运行php think clear；配置变更优先cherry-pick而非revert。
Git 分支命名不统一，导致多人协作时频繁混淆
ThinkPHP 项目里常有人用 dev、develop、feature-login、feat/login 混着来，结果 git checkout dev 切到的不是预期分支，git merge 时还容易误合错版本。
建议强制约定三类分支前缀，并写进团队 .gitignore 同级的 CONTRIBUTING.md：
-
main：仅接受已发布稳定版（对应线上public/部署状态） -
release/vX.Y.Z：从develop切出，仅做 Bug 修复和版本号提交，合并回main后打 tag -
feature/xxx或fix/xxx：必须小写+短横线，如feature/user-auth、fix/think-model-save，禁止用下划线或斜杠嵌套
顺便在 thinkphp 项目根目录加个 git hooks/pre-commit 脚本，用 git branch --show-current 校验当前分支名是否匹配正则 ^(main|release/|feature/|fix/)，不匹配直接退出并提示。
ThinkPHP 缓存文件未忽略，git status 总显示大量脏文件
ThinkPHP 默认把模板编译、日志、运行时缓存全塞进 runtime/，而这个目录一旦被 git 跟踪过，后续加 /runtime/ 到 .gitignore 也无效——这是 Git 的常见陷阱。
执行以下三步清理：
- 确认
.gitignore已含/runtime/和/public/static/（前端构建产物） - 运行
git rm -r --cached runtime/，清空 Git 缓存但保留本地文件 - 再执行
git commit -m "ignore runtime dir"，之后新增的runtime/文件就不会再进暂存区
漏掉第二步的话，每次 git pull 后 runtime/ 下的 log/ 或 cache/ 变更仍会持续报红，尤其在 CI 环境触发部署失败。
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
回滚线上 ThinkPHP 版本时，只 git reset 但没清缓存，页面白屏或报错
ThinkPHP 的模板编译、配置缓存、路由缓存都依赖 runtime/ 目录，git reset --hard HEAD~1 回退代码后，若不手动清空缓存，旧版代码可能加载新版编译后的模板，引发 ParseError 或 ClassNotFoundException。
安全回滚必须连带清理：
- 先停服务或切流量（避免请求中写入新缓存）
- 执行
git reset --hard <commit-hash></commit-hash> - 立刻运行
php think clear（ThinkPHP 6+）或php think cache:clear（ThinkPHP 8） - 检查
runtime/下log/是否有残留的 PHP Fatal 错误，有则说明缓存未清干净
CI/CD 流水线里建议把 php think clear 写进部署脚本末尾，别依赖人工操作。
使用 git revert 处理线上 Bug，却导致 ThinkPHP 路由或中间件注册异常
git revert 是反向提交，适合已推送到远程的 commit。但 ThinkPHP 的路由定义（route/route.php）、中间件绑定（app/middleware.php）这类全局配置文件，如果 revert 的是“增删中间件”的 commit，很容易因顺序错乱导致 Middleware not found 或路由 404。
比 revert 更稳妥的做法是：
- 优先用
git cherry-pick <hotfix-commit></hotfix-commit>把修复单独提出来，合并到main，再同步到develop - 若必须 revert，先检查被 revert 的 commit 是否修改了
config/或route/下的文件，有则手动校验 revert 后的内容是否语法合法（比如少了个逗号、多了一层数组） - 本地用
php think route:list验证路由是否完整加载，再用php think middleware:list确认中间件链无缺失
ThinkPHP 不像纯 API 框架那样对配置变更宽容，任何配置类文件的 revert 都得当心语法结构断裂。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
