在 Ubuntu 上为 Laravel 建立 Git 版本控制
一 环境准备
- 安装 Git：sudo apt update && sudo apt install -y git
- 安装 Composer（全局）：sudo apt install -y composer
- 新建 Laravel 项目（示例）：composer create-project --prefer-dist laravel/laravel my-laravel-app
- 进入项目目录：cd my-laravel-app
以上步骤完成后，即可在 Ubuntu 上具备 Laravel 项目的版本控制基础环境。
二 初始化 Git 仓库与忽略规则
- 初始化仓库：git init
- 创建并配置 .gitignore（至少包含以下内容，避免将敏感与生成文件纳入版本控制）：
/node_modules
/public/storage
/vendor
.env
.env.local
.env.*.local
.storage/*.key
Homestead.yaml
Vagrantfile
npm-debug.log
yarn-error.log
.DS_Store
Thumbs.db
git add .
git commit -m "Initial commit: Laravel project scaffold"
说明：Laravel 的敏感配置与环境变量应放在 .env，该文件不应提交到仓库；各环境可用 .env.local / .env.production 覆盖，或在服务器用环境变量注入。
三 连接远程仓库与推送
- 关联远程仓库（以 GitHub 为例）：git remote add origin https://github.com/your-username/your-laravel-project.git
- 推送至远程（默认分支名以远端为准，常见为 main 或 master）：git push -u origin main
- 后续提交流程：
git add .
git commit -m "描述本次变更"
git push
提示：若克隆时提示不支持 git 协议（port 9418），请改用 HTTPS 或 SSH 地址；GitHub 已在 2021-09-01 起不再支持未认证的 git 协议。
四 服务器部署与版本切换
- 在目标服务器克隆代码：git clone https://github.com/your-username/your-laravel-project.git
- 进入目录并安装依赖：cd your-laravel-project && composer install --optimize-autoloader --no-dev
- 配置环境：cp .env.example .env，编辑 .env 设置数据库等，然后生成密钥：php artisan key:generate
- 若使用 Git 子模块或私有包，克隆时建议带上：git clone --recurse-submodules --remote-submodules your-repo-url
- 版本回退与切换（在服务器工作目录执行）：
- 查看历史：git log --oneline
- 回退到某提交（保留工作区改动）：git reset --soft
- 回退并重置暂存区（工作区改动保留为未跟踪）：git reset --mixed
- 彻底回退（丢弃工作区改动）：git reset --hard
- 切换到指定提交（分离 HEAD）：git checkout
- 切回分支：git checkout main（或 master）
以上部署与回退流程适用于在 Ubuntu 服务器上拉取指定版本并运行 Laravel 应用。
