ubuntu中thinkphp项目如何进行版本控制

在Ubuntu环境下管理ThinkPHP项目的版本，用Git是标准做法。不过光是装个Git、敲几个命令还不够，得结合框架本身的目录结构和依赖管理方式，把整条流程理清楚。下面就把具体操作和容易踩坑的地方拆开讲讲。

一、基础环境准备

1. 先搞定Git。Ubuntu终端里跑一行命令就能装上（如果还没装的话）：

   sudo apt update && sudo apt install git

   装完别忘了配置全局用户名和邮箱——每个提交记录都会带上这个身份标识：

   git config --global user.name "Your Name"
   git config --global user.email "youremail@example.com"

2. ThinkPHP依赖Composer来管理那些第三方库和框架核心，所以它也得备好。用Composer官方脚本装一下：

   curl -sS https://getcomposer.org/installer | php
   sudo mv composer.phar /usr/local/bin/composer

   验证是否装好了？跑 composer -V 看看版本号，有输出就算成功。

二、初始化Git仓库

1. 进入你的ThinkPHP项目目录（比如 /var/www/html/my_tp_project）：

   cd /var/www/html/my_tp_project

2. 然后执行 git init，项目根目录下会生成一个隐藏的 .git 文件夹，所有版本控制信息就存在这里：

   git init

三、配置.gitignore文件（关键步骤）

ThinkPHP项目里有些东西压根不该进版本控制——比如临时文件、依赖包、环境配置。在根目录新建一个 .gitignore，把下面这些加进去：

# 运行时临时文件
/runtime/
# 依赖目录（由Composer管理）
/vendor/
# 公共上传目录
/public/uploads/
# 环境配置文件（包含敏感信息）
.env
# IDE配置目录
.idea/
.vscode/
# 日志文件
*.log
# Node.js相关（若有前端构建）
node_modules/
npm-debug.log
yarn-error.log

特别提醒：.env 文件里通常有数据库密码、App密钥这类敏感信息，绝对不能提交到仓库。正确的做法是准备一个 .env.example 模板，把结构放进去，让团队成员自己复制修改。

四、提交代码到本地仓库

1. 先把项目文件加到Git暂存区。首次提交一般用 git add .（后面可以按需选择文件）：

   git add .

2. 然后提交到本地仓库，附上一句有意义的描述信息，比如“Initial project setup”：

   git commit -m "Initial ThinkPHP project setup"

五、关联远程仓库（可选但推荐）

如果想把代码托管到GitHub、GitLab这类平台，就得和远程仓库关联。流程不复杂：

1. 先在平台上创建一个空仓库（注意不要勾选初始化README或.gitignore，否则后面推送会冲突）。
2. 拿到远程仓库的URL（像 https://github.com/yourname/my_tp_project.git 这种），然后在本地关联：

   git remote add origin https://github.com/yourname/my_tp_project.git

3. 把本地的 master 分支推上去（如果远程默认分支是 main，记得替换）：

   git push -u origin master

六、团队协作与分支管理

1. 分支策略选哪种？这要看项目规模。

   • Git Flow：大项目常用，有 master（稳定版）、develop（开发主干）、feature/*（特性分支）、release/*（预发布分支）、hotfix/*（紧急修复分支）等。
   • GitHub Flow：适合快速迭代，基于 main 创建 feature/* 分支，改完通过Pull Request合并。

   举个例子，创建并切换到新分支 feature/login：

   git checkout -b feature/login

2. 代码同步——每天开始工作前，先拉取远程的最新代码，减少冲突：

   git pull origin main

   工作完成后把本地分支推上去：

   git push origin feature/login

3. 冲突处理：多人改同一份文件，难免会“撞车”。先执行 git status 看看哪些文件冲突了，手动打开文件，找到 <<<<<<<、=======、>>>>>>> 这些标记，把双方代码合并好，删掉标记。然后：

   git add 冲突文件
   git commit -m "Resolve merge conflict"

七、依赖与环境管理

1. Composer有两个核心文件：composer.json（声明依赖列表）和 composer.lock（锁定精确版本）。这两个必须提交到仓库，这样团队里每个人装出来的依赖版本完全一致：

   git add composer.json composer.lock
   git commit -m "Add Composer dependencies"

2. 当同事克隆项目后，只需要执行 composer install 就能自动从远程拉取依赖，vendor 目录会生成在本地，不用提交到仓库。

3. 环境配置——把 .env.example 复制成 .env，然后用编辑器修改数据库连接、APP密钥等参数。注意：.env 已经在 .gitignore 里，不会被提交：

   cp .env.example .env
   vim .env
   # 编辑环境配置

八、常用操作总结

按这套流程走下来，Ubuntu下的ThinkPHP版本控制基本就稳了——代码有迹可循，协作不会乱套，敏感信息也保住了。项目越做越大，你会发现这个“底子”打得值。