Ubuntu中ThinkPHP项目版本控制指南

在Ubuntu环境下进行ThinkPHP版本控制，使用Git是业界标准做法。不过仅安装Git并执行几个基本命令还不够，必须结合框架自身的目录结构与依赖管理方式，梳理清晰整体流程。以下详细拆解具体操作步骤与常见易错点，帮助开发者高效完成Ubuntu中ThinkPHP项目的版本控制。

一、基础环境准备

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
   # 编辑环境配置

八、常用操作总结

操作	命令示例
查看仓库状态	git status
查看提交历史	git log --oneline
创建分支	git branch feature/new-module
切换分支	git checkout feature/new-module
合并分支	git checkout main && git merge feature/new-module
撤销本地未推送提交	git reset --hard HEAD~1（慎重，会删除本地提交）
恢复单个文件	git checkout HEAD -- public/index.php

按照上述流程操作，Ubuntu下ThinkPHP项目的版本控制将稳健可靠——代码有迹可循，协作不会混乱，敏感信息也得到妥善保护。随着项目规模扩大，您会发现这个“底子”非常值得投入。