Appearance
附录：常用命令与工具汇总
1. Git 核心常用命令（按场景分类，方便查询）
仓库操作
| 命令 | 功能 | 示例 |
|---|---|---|
git init | 初始化新仓库 | git init |
git clone | 克隆远程仓库 | git clone <远程仓库地址> |
git remote | 管理远程仓库 | git remote -v |
git remote add | 添加远程仓库 | git remote add origin <远程仓库地址> |
git remote set-url | 修改远程仓库地址 | git remote set-url origin <新地址> |
基础操作
| 命令 | 功能 | 示例 |
|---|---|---|
git add | 添加文件到暂存区 | git add . |
git commit | 提交到版本库 | git commit -m "提交信息" |
git status | 查看仓库状态 | git status |
git log | 查看提交历史 | git log --oneline |
git diff | 查看文件修改 | git diff |
分支操作
| 命令 | 功能 | 示例 |
|---|---|---|
git branch | 查看分支 | git branch -a |
git branch <name> | 创建分支 | git branch feature |
git checkout <branch> | 切换分支 | git checkout develop |
git checkout -b <branch> | 创建并切换分支 | git checkout -b feature |
git merge <branch> | 合并分支 | git merge feature |
git branch -d <branch> | 删除分支 | git branch -d feature |
远程操作
| 命令 | 功能 | 示例 |
|---|---|---|
git push | 推送到远程仓库 | git push origin main |
git pull | 拉取远程代码 | git pull origin main |
git fetch | 查看远程更新 | git fetch origin |
git push -f | 强制推送 | git push -f origin main |
版本管理
| 命令 | 功能 | 示例 |
|---|---|---|
git reset | 回滚版本 | git reset HEAD~1 |
git reset --hard | 强制回滚 | git reset --hard <commit> |
git revert | 撤销提交 | git revert <commit> |
git stash | 暂存修改 | git stash |
git stash pop | 恢复暂存 | git stash pop |
git tag | 创建标签 | git tag -a v1.0.0 -m "版本1.0.0" |
2. Git 图形化工具使用指南（SourceTree/VS Code Git）
SourceTree 使用指南
安装与配置：
- 下载并安装 SourceTree：https://www.sourcetreeapp.com/
- 首次启动时，登录 GitHub/GitLab 账号（可选）
- 配置 Git 用户名和邮箱
基本操作：
- 克隆仓库：点击「克隆」按钮，输入远程仓库地址
- 提交代码：在「工作副本」视图中，选择要提交的文件，填写提交信息
- 推送代码：点击「推送」按钮，选择要推送的分支
- 拉取代码：点击「拉取」按钮，选择要拉取的分支
- 分支管理：在「分支」视图中，可以创建、切换、合并分支
高级功能：
- 冲突解决：当遇到合并冲突时，SourceTree 会显示冲突文件，点击「解决冲突」按钮进行可视化解决
- 历史查看：在「历史」视图中，可以查看详细的提交历史和分支合并情况
- 暂存管理：在「暂存」视图中，可以管理暂存的修改
VS Code Git 工具使用指南
启用 Git 功能：
- VS Code 内置 Git 功能，无需额外安装
- 打开包含 Git 仓库的文件夹，VS Code 会自动识别
基本操作：
- 查看修改：在左侧边栏的「源代码管理」图标中，可以查看所有修改的文件
- 暂存修改：点击文件旁边的「+」按钮，将文件添加到暂存区
- 提交代码：在输入框中填写提交信息，点击「√」按钮提交
- 推送代码：点击「...」按钮，选择「推送」
- 拉取代码：点击「...」按钮，选择「拉取」
高级功能：
- 分支管理：点击分支名称，可以创建、切换分支
- 冲突解决：当遇到合并冲突时，VS Code 会显示冲突文件，提供可视化的冲突解决界面
- 历史查看：点击「...」按钮，选择「查看历史」，可以查看详细的提交历史
3. 常见报错与解决方案对照表（新手速查）
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
fatal: not a git repository | 当前目录不是 Git 仓库 | 执行 git init 初始化仓库 |
fatal: remote origin already exists | 远程仓库 origin 已存在 | 修改远程仓库地址：git remote set-url origin <新地址> |
error: failed to push some refs | 远程仓库有新提交 | 先拉取最新代码：git pull |
conflict: merge conflict in <file> | 合并时产生冲突 | 手动编辑冲突文件，解决冲突后提交 |
fatal: Authentication failed | 身份验证失败 | 检查用户名和密码，或使用 SSH 密钥 |
git: 'command' is not a git command | 命令拼写错误 | 检查命令拼写，使用 git help 查看正确命令 |
error: pathspec 'branch' did not match any file(s) known to git | 分支不存在 | 检查分支名称是否正确 |
fatal: refusing to merge unrelated histories | 两个仓库历史不相关 | 使用 git merge --allow-unrelated-histories |
4. Git 命令行快捷键（提高开发效率）
Bash/Zsh 快捷键
| 快捷键 | 功能 |
|---|---|
Tab | 自动补全命令和文件名 |
Ctrl + A | 移动到命令行开头 |
Ctrl + E | 移动到命令行结尾 |
Ctrl + U | 清空当前命令行 |
Ctrl + L | 清屏 |
↑ | 查看历史命令 |
↓ | 查看历史命令 |
Git 别名配置
bash
# 全局配置别名
git config --global alias.st status
git config --global alias.ci commit
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.unstage "reset HEAD --"
git config --global alias.last "log -1 HEAD"常用组合命令
| 命令组合 | 功能 |
|---|---|
git add . && git commit -m "提交信息" | 一键添加并提交 |
git checkout -b <branch> | 创建并切换分支 |
git pull origin <branch> && git push origin <branch> | 拉取并推送代码 |
git log --oneline -n 10 | 查看最近 10 次提交 |
git branch -D <branch> | 强制删除分支 |
通过本附录，你可以快速查询 Git 常用命令和工具使用方法，解决常见问题，提高 Git 使用效率。