1. 安装Git
在Linux系统上,首先需要安装Git(若未预装)。对于Ubuntu/Debian系统,执行以下命令:
sudo apt update && sudo apt install git
对于CentOS/RHEL系统,使用:
sudo yum install git
安装完成后,通过git --version
验证是否安装成功。
2. 初始化Git仓库
进入Laravel项目的根目录(包含composer.json
、app/
等核心文件的目录),执行以下命令初始化Git仓库:
cd /path/to/your/laravel/project
git init
这会在项目根目录下创建一个隐藏的.git
文件夹,用于存储版本控制的所有元数据(如提交历史、分支信息等)。
3. 配置Git全局信息
为确保提交记录的可追溯性,需设置Git的全局用户名和邮箱(这些信息会伴随每次提交):
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
可通过git config --list
查看当前配置是否生效。
4. 添加文件到暂存区
将项目中的所有文件(或特定文件)添加到Git的暂存区(暂存区是提交前的中间区域,用于筛选需要版本控制的文件):
git add . # 添加所有文件
若只需添加特定文件(如app/Http/Controllers/HomeController.php
),可使用:
git add app/Http/Controllers/HomeController.php
建议通过.gitignore
文件排除无需版本控制的文件(如vendor/
、node_modules/
、.env
等),避免将敏感信息或第三方依赖纳入版本库。
5. 提交更改到本地仓库
将暂存区的文件提交到本地Git仓库,并附上清晰的提交信息(描述本次提交的内容,如“添加登录功能”):
git commit -m "Initial commit" # 初始提交
后续修改后,重复git add
和git commit
步骤即可保存新的更改。
6. 关联远程仓库(可选但推荐)
若需要团队协作或多设备同步代码,需将本地仓库与远程仓库(如GitHub、GitLab)关联。首先在远程平台创建一个空仓库(如your-laravel-project
),然后在本地执行:
git remote add origin https://github.com/your-username/your-laravel-project.git
关联后,将本地master
分支(或其他分支)的代码推送到远程仓库:
git push -u origin master # 首次推送需用`-u`关联分支
后续可直接使用git push
推送更改。
7. 常用版本控制操作
git status
(显示未提交的更改、暂存区状态等);git log
(显示所有提交的哈希值、作者、时间及信息);git pull origin master
(从远程仓库获取最新代码并合并到本地);git checkout -- filename
(撤销指定文件的未暂存修改);git reset --hard HEAD
(撤销所有未暂存的修改)。8. 分支管理与标签(高级用法)
feature/login
),避免主分支(master
)被破坏。创建分支:git checkout -b feature/login
;切换分支:git checkout master
;合并分支:git merge feature/login
(将feature/login
的更改合并到master
)。v1.0.0
),便于回溯。创建标签:git tag -a v1.0.0 -m "Release version 1.0.0"
;推送标签到远程:git push origin --tags
。注意事项
.env
包含数据库密码、API密钥等敏感信息,需将其添加到.gitignore
文件中(避免泄露)。可通过cp .env.example .env
生成本地.env
文件,并手动配置。vendor/
目录无需提交到版本库(可通过composer install
在目标环境中重新安装依赖)。