前言：从“代码乱象”到“协作高效”的转变

在 Ubuntu 上敲打 ThinkPHP 的时候， 你可能会感受到代码仓库像一片杂草丛生的原野——临时文件、日志、依赖目录随手乱扔，团队成员每次 pull 都要手动解决冲突。如果再加上一杯咖啡的香气，似乎还能忍受，但长期下来效率会像被绊倒的自行车，原来如此。。

本文不只是列出几个命令， 而是用情感化的案例和实战技巧帮助你把 ThinkPHP 项目变成一条清晰、 我们一起... 可追溯、易协作的流水线。让每一次提交都像一次温暖的握手，而不是一次惊心动魄的“合并地狱”。

一、为什么在 Ubuntu 上必须为 ThinkPHP 引入 Git 版控？

• 平安感：每一次代码改动都有快照，可随时回滚。
• 协作透明：分支、 Pull Request、Code Review 把“谁改了什么”写得清清楚楚。
• 持续交付：配合 CI/CD， 自动化测试、部署不再是梦想。
• 环境一致性：通过 .env 示例文件和 Composer lock，确保本地与生产环境“一致”。

小贴士：别忘了给自己留点喘息空间

在紧张的开发节奏里 有时候停下来喝口水、眺望窗外会让你更专注于代码本身。把这些碎碎念写进 commit message， 我天... 也是一种人性化的记录方式。

二、 Ubuntu 环境准备——Git 与 Composer 同行

打开终端，一键搞定：

# 更新软件源
sudo apt update
# 安装 Git
sudo apt install git -y
# 安装 Composer
php -r "copy;"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
# 验证安装
git --version          # 如：git version 2.34.1
composer --version    # 如：Composer version 2.5.8

如果出现 “Permission denied”，别慌——只需要在前面加上 sudo 再试一次，泰酷辣！。

三、 初始化仓库与 .gitignore 的艺术配置

1️⃣ 创建本地仓库

开倒车。 进入你的 ThinkPHP 项目根目录，施行：

2️⃣ 编写 .gitignore —— 把噪声踢出视野

.gitignore 完成后 施行：

四、分支策略——让团队合作像指挥交响乐一样和谐

Git Flow

• Main——正式发布分支；每次上线都从这里打标签。
• Develop——日常开发主线；所有 feature 分支到头来合并到此。
• Feature/xxx——新功能开发；完成后 PR 合并至 develop。
• Release/x.x.x——准备上线；仅做 bug 修复和小幅度优化。
• Hotfix/x.x.x——线上紧急修复；直接基于 main 创建。
\endul

从 main 创建 feature 分支，比方说 feature/user-login。 完成后提交 Pull Request，邀请同事审阅。 I PUA。 f all checks pass → merge → delete branch. Main 合并后马上触发 CI 部署到生产环境。 \endol

温馨提醒：即使你是单兵作战， 也请坚持走 PR 流程，这样可以留下完整的决策痕迹， 我比较认同... 日后回顾会发现自己成长了不少。

在 Ubuntu 上搭建 Jenkins 或 GitLab CI 并不难，只要把上面的脚本放进 .gitlab-ci.yml 或 Jenkinsfile 即可。 搞起来。 关键是保持脚本简洁否则每次调试都会像爬山一样耗时。 顺便说一句， 我今天午饭吃了炸酱面那味道竟然让我想到“代码整洁”这件事——辣味刺激，让人忍不住想把所有错误都剔除干净！ © 2026 思考技术博客 | 本文采用 CC BY-NC-SA 4.0 协议发布 如需转载，请注明出处。"Git stash" 是临时保存未完成工作的好帮手， 当你被紧急 bug 打断时它能让你快速切换分支去处理，又不会丢失正在进行中的实验性代码，谨记...。 TIPS: 如果你对上述步骤仍有疑惑， 可以参考官方文档或加入国内 PHP 开发者社区，那里总有热情的大佬帮你排查细节。 祝你在 Ubuntu + ThinkPHP 的旅程中，一路顺风，代码永远保持「干净」与「可爱」！ A/B 测试与灰度发布可以结合 tag 与 CI，实现「渐进式上线」而不是“一键全炸”。这也是现代互联网产品对质量负责的一种姿态。 "Git reset --hard" 虽然强大， 但请务必先确认没有未保存的重要工作，否则可能会出现「心疼」场面。最好的办法是先创建一个 backup 分支再操作。 "Git blame" 能帮你追溯是谁写了哪行代码，但不要用来指责，而是帮助大家一起改进代码质量。 记住： 每一次 git push 前， 都先跑一遍 composer validate && composer test；若有警告，就算是「小问题」也请及时修正，主要原因是它们往往是潜伏的 bug。 PULL REQUEST 是沟通桥梁，不是断案台。用积极正面的语言给同事反馈，让团队氛围更轻松、更高效。 ✔ Docker 镜像已推送至私有仓库 * 保证生产环境使用相同镜像避免 “本机跑得通”。 七、 ：让每一次提交都充满仪式感 当你站在 Ubuntu 的终端前，看见那条闪烁的分支树，你会发现版本控制已经不再是枯燥的命令行，而是一套帮助团队「共同呼吸」的仪式。ThinkPHP 本身没有内置版控， 但它非常友好地配合 Composer 与 .env，使得我们可以轻松把业务代码抽离出来只专注于业务逻辑本身。 总结一下。 ✔ Commit 信息遵循约定式规范 * 如 feat:, fix:, docs:, chore:, refactor:. 可配合 husky 检查。 ✔ PULL REQUEST 必须 * 包括单元测试和代码风格检查。 ✔ tag 标记正式发布版本 * 推荐使用语义化版本号 v1.2.3，并在 CHANGELOG 中记录变更，物超所值。。 六、 最佳实践清单 —— 一目了然的检查表 ✔︎ 检查项 备注 ✔ .gitignore 已覆盖 runtime、vendor、logs 等临时目录 * 每次新增工具或插件记得同步更新 ignore 列表。 火候不够。 ✔ .env.example 已提交且保持最新 * 不要把真实密码泄露进去，用占位符如 DBPASSWORD=yourpassword，还行。。