在 CentOS 上为 ThinkPHP 项目搭建 Git 版本控制，其实不算复杂，但有些细节一旦忽略，后面部署协作就会踩坑。下面按实际流程一步步拆解，顺便把常见的坑点也挑明。
一、环境准备与基础配置
先把基础软件装好。服务器和开发机上都跑一遍 sudo yum install git -y，没什么难度。装完后设置全局身份信息，这步很多人随手一写，结果提交历史里全是“unknown”或者乱七八糟的邮箱——后面查问题会很头疼。
git config --global user.name "Your Name"git config --global user.email "your_email@example.com"
同时建议一并安装 Composer。ThinkPHP 的依赖全靠它管理，CentOS 上可以通过系统软件源或者官方安装脚本搞定。装好之后，标准的 init、clone、add、commit、push、pull 等操作就没任何障碍了。
二、初始化仓库与 ThinkPHP 专属 .gitignore
进入项目根目录（就是有 app、config、public 这些文件夹的地方），执行 git init。然后必须马上创建并配置 .gitignore，否则运行时的缓存、敏感配置、第三方依赖一股脑全提交上去，那画面太美。
至少把下面这些加进去：
/runtime/—— ThinkPHP 运行缓存/vendor/—— Composer 依赖包/public/uploads/—— 用户上传文件.env—— 数据库密码等敏感配置.idea/、.vscode/—— IDE 配置npm-debug.log、yarn-error.log
这里多说一句：ThinkPHP 本身不内置版本管理，完全依赖 Git 作为普通代码仓库。依赖用 Composer 管理，咱们只把 composer.json 和 composer.lock 提交到仓库里，团队成员拉取后执行 composer install 就能还原依赖，避免把整个 vendor 目录塞进版本库——这是行业共识，也是保持仓库干净的关键。
三、首次提交与远程协作
配置好 .gitignore 之后，首次提交就是常规操作了：
git add .git commit -m "Initial ThinkPHP project setup"
然后关联远程仓库（GitHub、GitLab、Gitee 都行）：git remote add origin <你的远程仓库URL>。推送到远程时注意默认分支名，可能是 main 也可能是 master，按实际替换 git push -u origin main 或 git push -u origin master。
日常协作流程也不复杂：
- 拉取更新：
git pull --rebase（用 rebase 能保持提交历史线性整洁） - 推送变更：
git push - 分支开发：
git checkout -b feature/x或git checkout -b hotfix/x，开发完走 PR 或者代码审查再合并回主干。
这套流程在实际团队协作中跑得很稳，无论是 CentOS 服务器还是日常开发机都适用。
四、在服务器上搭建私有 Git 裸仓库（可选）
如果不想把代码放到第三方平台，直接在 CentOS 上架一个私有 Git 裸仓库也是可行的。做法如下：
- 创建专用用户和仓库目录：
sudo adduser git，然后sudo mkdir -p /var/git && sudo chown -R git:git /var/git - 初始化裸仓库：
sudo -u git git init --bare /var/git/your-project.git - 客户端通过 SSH 克隆：
git clone git@<服务器IP>:/var/git/your-project.git
权限和安全方面，只允许 git 用户访问其主目录和仓库目录（可以用 chmod 700 或 755），然后把开发者的公钥添加到 /home/git/.ssh/authorized_keys，就能实现免密推送。这种方式很适合团队内部私用，且与 ThinkPHP 项目代码可以完全分离管理。
五、与部署流程的配合建议
版本控制最终要跟部署联动起来，这里有几个实践要点：
- 生产环境拉取更新： 在站点目录（比如
/var/www/your-tp）执行git pull origin main，然后立刻执行composer install --optimize-autoloader --no-dev，保证依赖版本一致并优化自动加载。 - 环境配置与安全： 生产环境一定要用
.env.production之类的专用配置。千万别把含有数据库密码的.env提交到远程仓库——这是安全底线。可以通过部署脚本或者 CI，在拉取代码后自动生成或替换环境配置文件。 - 版本回退与标签： 发布前打标签：
git tag -a v1.0.0 -m "Release v1.0.0"。如果线上出问题需要回退，可以用git checkout或者git reset --hard（后者要谨慎，确保先做好备份）。 - 代码版本与 API 版本的区别： Git 管理的是“代码版本”；如果真正需要的是“API 接口版本”，可以在 ThinkPHP 6 中通过中间件和路由前缀（比如
/v1/user、/v2/user）来实现。两者职责完全不同，可以并行使用，别搞混。
总而言之，把 Git 和 ThinkPHP 项目在 CentOS 上搭好并不难，难的是从一开始就把上述细节想清楚。只要 .gitignore 写对了、依赖用 Composer 管理好了、生产环境配置隔离了，后面团队协作和部署都会顺畅很多。
