Git 详细使用说明文档(适合小白)
Git 详细使用说明文档(适合小白)
1. 什么是 Git?
Git 是一个版本控制系统,帮助你管理和跟踪代码的变更。无论是个人项目还是团队协作,Git 都能帮助你记录代码的历史版本,方便回溯和协作。
2. 安装 Git
- Windows:从 Git 官网 下载安装包并运行。
- Mac:打开终端,输入
git --version
,系统会提示安装。 - Linux:使用包管理器安装,如
sudo apt-get install git
(Ubuntu)。
安装完成后,打开终端(Windows 用户可以使用 Git Bash),输入 git --version
确认安装成功。
3. 配置 Git
首次使用 Git,需要配置用户名和邮箱,这是提交代码时的身份标识。
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
4. 创建 Git 仓库
Git 仓库(Repository)是存储代码和版本历史的地方。
- 本地创建:在项目文件夹中运行
git init
,会创建一个.git
隐藏文件夹。 - 克隆远程仓库:使用
git clone <远程仓库URL>
,如git clone https://github.com/user/repo.git
。
5. 基本操作
5.1 查看状态
git status
显示当前工作区的状态,包括哪些文件被修改、哪些文件待提交等。
5.2 添加文件
将修改的文件添加到暂存区(Staging Area)。
git add <文件名>
- 添加所有文件:
git add .
- 添加特定文件:
git add file.txt
5.3 提交更改
将暂存区的文件提交到本地仓库,并附上提交信息。
git commit -m "提交信息"
提交信息应简洁明了,描述本次提交的内容。
5.4 查看提交历史
git log
显示提交历史,包括提交者、时间、提交信息等。
6. 远程仓库
远程仓库是托管在网络上的 Git 仓库,如 GitHub、GitLab 等。
6.1 添加远程仓库
git remote add origin <远程仓库URL>
origin
是远程仓库的别名,可以自定义。
6.2 推送代码
将本地仓库的代码推送到远程仓库。
git push origin <分支名>
首次推送可能需要 -u
参数:git push -u origin master
。
6.3 拉取代码
从远程仓库拉取最新代码到本地。
git pull origin <分支名>
7. 分支管理
分支(Branch)允许你在不影响主代码的情况下开发新功能。
7.1 创建分支
git branch <分支名>
7.2 切换分支
git checkout <分支名>
或者使用 git switch <分支名>
(Git 2.23+)。
7.3 合并分支
将一个分支的更改合并到当前分支。
git merge <分支名>
7.4 删除分支
git branch -d <分支名>
8. 解决冲突
当多人修改同一文件时,可能会产生冲突。Git 会提示冲突文件,你需要手动编辑文件解决冲突,然后再提交。
9. 其他常用命令
- 撤销修改:
- 撤销工作区的修改:
git checkout -- <文件名>
- 撤销暂存区的修改:
git reset HEAD <文件名>
- 撤销工作区的修改:
- 查看差异:
- 比较工作区和暂存区:
git diff
- 比较暂存区和最后一次提交:
git diff --staged
- 比较工作区和暂存区:
- 标签:
- 创建标签:
git tag <标签名>
- 推送标签:
git push origin <标签名>
- 创建标签:
10. 学习资源
- Git 官方文档
- Pro Git 中文版
- GitHub 学习资源
希望这份文档能帮助你快速上手 Git!如果有任何问题,欢迎随时提问。