Debian系统下Laravel项目的版本控制实践
一 环境准备与初始化
- 安装并配置 Git：在 Debian 上执行 sudo apt update && sudo apt install git，随后设置提交者身份（git config --global user.name/email），用于标识提交者信息。完成后可用 git --version 验证安装是否成功。
- 初始化仓库与首次提交：在项目根目录执行 git init，按需添加文件（git add .），提交初始版本（git commit -m “Initial commit”）。
- 关联远程仓库与推送：在 GitHub/GitLab 创建空仓库后，关联远程地址（git remote add origin ），推送至主分支（git push -u origin master/main）。如需克隆现有项目，可直接使用 git clone 并在本地继续开发。
二 忽略文件与敏感信息管理
- 使用官方推荐的 Laravel .gitignore：至少忽略 vendor/、node_modules/、.env、storage/*.key、/public/hot、/public/storage 等，避免将依赖、本地环境配置和可再生资源纳入版本控制。
- 处理已被跟踪的文件：若某文件已被 Git 跟踪，后续再写入 .gitignore 不会生效。需先移除缓存：git rm -r --cached ，再 git add . 并提交，使忽略规则生效。
- 选择性纳入被忽略目录中的个别文件：先按规则忽略父目录（如 vendor/），再用 ! 否定特定子路径（如 !/vendor/laravel/framework/src/Illuminate/Auth/TokenGuard.php）；若文件仍受上层忽略影响，可用 git add -f 强制添加。
三 分支策略与发布标签
- 分支工作流：以 main/develop 为主干，功能开发使用 feature/，修复使用 hotfix/，通过 git checkout -b 创建分支，完成后切回主干并合并（git merge），必要时使用 git push 同步到远程。
- 发布标签：对稳定版本打标签以便回溯与部署，例如 git tag -a v1.0.0 -m “Release 1.0.0”，随后推送标签到远端（git push origin --tags）。
四 数据库与部署的版本化管理
- 数据库迁移作为“数据层版本”：使用 Laravel 的迁移（migrations）管理表结构变更，保证协作与上线过程结构一致；配合 seeders 管理基础数据。
- 部署流程建议：在部署脚本中依次执行 git pull 更新代码、composer install --optimize-autoloader --no-dev 安装生产依赖、php artisan migrate --force 执行迁移、php artisan config:cache 与 php artisan route:cache 缓存配置与路由，最后重启队列或 FPM 使改动生效。
- 环境配置分离：.env 不纳入版本控制，上线时通过自动化或受控方式注入环境专属配置（如 APP_ENV、APP_KEY、DB_*、CACHE_DRIVER 等），避免泄露密钥与造成环境漂移。