Linux环境下ThinkPHP的版本控制实践
一 基础配置与仓库初始化
- 安装并初始化版本控制工具：在 Linux 终端执行安装 Git（如发行版仓库安装），进入项目根目录后执行：git init。随后添加远程仓库：git remote add origin <仓库URL>，首次推送使用：git push -u origin main（或 master，取决于你的默认分支名）。建议开启命令行颜色与自动换行以提升可读性：git config --global color.ui auto 与 git config --global core.autocrlf input（Linux 环境）。以上流程适用于将 ThinkPHP 项目纳入 Git 管理的通用做法。
二 关键文件与忽略规则
- 必须纳入版本控制的文件与目录：框架与业务代码、配置文件模板、依赖清单与锁文件、静态资源构建产物（如前端打包后的资源）。
- 必须忽略的文件与目录：运行时缓存与日志、第三方依赖本体、用户上传、本地环境配置、IDE/编辑器配置。
- 推荐的 .gitignore 示例（ThinkPHP 6 常见实践）：
/runtime/
/vendor/
/public/uploads/
.env
.env.local
.idea/
.vscode/
*.log
npm-debug.log*
yarn-error.log*
.DS_Store
- 依赖与环境管理要点：提交 composer.json 与 composer.lock，确保团队成员执行 composer install 时依赖版本一致；将 .env 加入忽略，提供 .env.example 作为模板，便于统一配置项与本地填写。
三 分支策略与发布流程
- 分支策略建议：
- GitHub Flow（中小型、持续交付优先）：以 main 为主分支，特性在 feature/* 分支开发，经 Code Review 后以 PR/MR 合并，合并后可自动部署。
- Git Flow（中大型、版本周期明确）：main/master 保持可发布，develop 为集成分支；功能在 feature/，版本在 release/，线上紧急修复在 hotfix/*。
- 标签与发布：使用语义化版本打标签，便于回溯与发布管理。
# 打标签并推送
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
- 协作规范：特性分支开发、小步快跑、频繁同步主干、合并前通过测试与审查，降低冲突与回滚成本。
四 回溯与冲突处理
- 安全撤销已推送的提交：优先使用 git revert 生成“反向提交”，避免改写公共历史；仅在本地私有分支上使用 git reset --hard，且务必先备份。
- 单文件历史恢复：git checkout – path/to/file 可将单个文件恢复到指定提交。
- 冲突处理流程：git status 查看冲突文件 → 手动编辑冲突区域并删除冲突标记 → git add → git commit 完成合并。必要时借助 IDE 图形化冲突解决工具提升效率。
五 与 API 版本控制的区分
- 本文的“版本控制”指代码与发布管理（Git、分支、标签、发布）。若你还需要管理“API 版本”（如 /v1/user、/v2/user），这属于路由与中间件层面的设计，常见做法是基于 URL 前缀与中间件校验版本号，为不同版本提供独立的控制器命名空间与实现。