thinkphp在ubuntu上如何进行版本控制

ThinkPHP 本身并不内置版本控制功能，这得靠 Git 这样的外部工具来搞定代码变更追踪、团队协作和版本回溯。下面就是在 Ubuntu 环境下，用 Git 来管理 ThinkPHP 项目的一套实操流程和需要注意的细节——全是干货，直接上手用就行。

1. 初始化 Git 仓库

在 ThinkPHP 项目的根目录（也就是包含 app、public、vendor 那些核心目录的地方）运行下面这行命令：

git init

执行之后，项目根目录里会多出一个 .git 隐藏文件夹，版本控制的所有元数据都存里面了，以后每次提交、分支切换都得靠它。

2. 配置 .gitignore 文件

有些文件（临时缓存、依赖包、环境配置）压根儿不需要放进版本库，否则仓库会变得又大又乱，还可能泄漏敏感信息。在项目根目录新建一个 .gitignore 文件，把下面这些内容贴进去：

/runtime/        # 临时运行时文件（缓存、日志等）
/vendor/         # Composer依赖目录（通过composer.json管理）
/public/uploads/ # 用户上传的文件（体积大且无需版本控制）
.env             # 环境配置文件（包含敏感信息，如数据库密码）
.idea/           # PhpStorm IDE配置目录
.vscode/         # VSCode IDE配置目录
npm-debug.log    # Node.js调试日志
yarn-error.log   # Yarn调试日志

这样配置完之后，Git 会自动忽略这些文件和目录，仓库的“身材”保持苗条，敏感信息也安全了。

3. 提交初始代码

把项目中必须保留的核心文件（比如 composer.json、composer.lock、config/、app/、public/ 等）加到暂存区，然后提交第一个版本：

git add composer.json composer.lock config/ app/ public/
git commit -m "Initial ThinkPHP project setup"

这里要特别留意：composer.json 和 composer.lock 必须纳入版本控制，因为依赖管理全靠它们；而 vendor/ 目录则完全不用提交，团队成员拉取代码后执行 composer install 就能自动恢复所有依赖。

4. 关联远程仓库（可选）

如果想备份代码到 GitHub、GitLab 或 Gitee 上，或者方便团队协作，就执行下面命令关联远程仓库（记得把 [远程仓库URL] 换成真实的地址）：

git remote add origin [远程仓库URL]

首次推送代码到远程仓库的主分支（比如 main 或 master）：

git push -u origin main

之后，日常开发只需用 git push 和 git pull 同步本地与远程的代码就行，简单重复的活交给命令就好。

5. 分支策略（团队协作必备）

分支怎么玩，直接关系到团队的协作效率。这里推荐两种主流模式，根据项目大小和迭代节奏来选：

• Git Flow：适合大型项目，分支类型比较全——master（生产环境代码）、develop（开发主干）、feature/*（特性分支）、release/*（预发布分支）、hotfix/*（紧急修复分支）。特性分支从 develop 创建，开发完合并回去就删；release 分支用来做预发布测试，通过后合并到 master 和 develop 再删；hotfix 分支从 master 拉出来修紧急 bug，修复后合并回 master 和 develop。
• GitHub Flow：适合小型、快速迭代的项目，分支简单——只有 main（生产环境代码）和 feature/*（特性分支）。特性分支从 main 创建，开发完通过 Pull Request 审核后合并回 main，合并完立刻部署。没那么复杂，但效率很高。

6. 冲突解决

多人同时改同一文件，冲突在所难免。真遇上了，按下面的步骤来处理：

1. 先跑 git status 查看哪些文件冲突了（状态会显示“both modified”）；
2. 手动打开那些冲突文件，找到 Git 插入的冲突标记（<<<<<<< HEAD、=======、>>>>>>> branch-name），删掉标记，只保留正确的代码；
3. 执行 git add 冲突文件，告诉 Git 冲突已解决；
4. 最后 git commit 完成合并提交（Git 会自动生成一条标准的合并信息）。

7. 版本回溯

如果提交了错误的代码，想回退怎么办？根据场景选不同的命令：

• 撤销本地未推送的提交：git reset --hard 提交ID（通过 git log 查看提交ID，注意这个命令会彻底删除该提交以及之后的所有提交，本地未推送时用比较方便）；
• 撤销已推送至远程的提交：git revert 提交ID（这个更安全，因为它会创建一个新的提交来“反做”指定提交的改动，历史记录不会被改写，推荐在远程分支上用）；
• 恢复单个文件的历史版本：git checkout 提交ID -- 文件路径（想把某个文件回退到某次提交的状态，就用这个，不影响其他文件）。

8. 依赖与环境管理

ThinkPHP 项目的依赖靠 Composer 管理，所以 composer.json 和 composer.lock 必须放进版本库。团队其他成员克隆项目后，只需执行 composer install，所有依赖就自动装好了（vendor/ 目录完全没有提交的必要）。

环境配置方面，建议创建一个 .env.example 文件作为模板，里面放默认配置项，不包含任何敏感信息。团队成员复制这个文件为 .env，然后填写自己的数据库连接等真实配置。而且 .env 文件一定要加进 .gitignore，防止敏感信息被误提交到仓库。

按照上面这些步骤一步步走下来，ThinkPHP 项目在 Ubuntu 环境下的版本控制就算规范起来了。代码变更可追溯、团队协作不打架，该有的都有了。