Git 命令完全指南：从入门到日常够用的所有指令

1
2

git config --global user.name "你的名字"
git config --global user.email "you@example.com"

1

git init

1
2

git clone https://github.com/user/repo.git
git clone https://github.com/user/repo.git my-folder   # 克隆到指定目录

1

git status

1
2
3
4

git add file.py          # 暂存单个文件
git add .                # 暂存当前目录所有改动（新增/修改/删除，受 .gitignore 约束）
git add -A               # 暂存整个工作树所有改动
git add -p               # 交互式暂存，按代码块选择

1
2

git commit -m "feat: 新增登录功能"
git commit -am "fix: 修复空指针"   # 自动暂存已跟踪文件的修改并提交

1
2

git push origin main
git push -u origin main   # 首次推送并关联上游，之后直接 git push

1
2
3

git diff              # 工作区 vs 暂存区
git diff --staged     # 暂存区 vs 最近一次提交
git diff main backup  # 两个分支之间的差异

1
2
3
4

git log
git log --oneline        # 一行一条，简洁
git log --oneline -5     # 最近 5 条
git log --graph --all    # 图形化展示分支关系

1

git show <commit-id>

1

git blame file.py

1
2
3
4

git branch              # 列出本地分支
git branch feature      # 新建分支
git branch -d feature   # 删除已合并的分支
git branch -D feature   # 强制删除（未合并也删）

1
2
3

git switch main              # 切到 main
git switch -c feature        # 新建并切换到 feature
git checkout main            # 老写法，等价 switch

1
2

git switch main
git merge feature     # 把 feature 合并进当前分支

1
2

git switch feature
git rebase main      # 把 feature 的提交"挪到" main 最新提交之后

1
2
3

git remote -v                         # 查看已关联的远程
git remote add backup <url>          # 添加第二个远程
git remote remove backup             # 删除远程

1

git fetch origin

1
2

git pull origin main
git pull --rebase origin main   # 用 rebase 方式拉取，历史更干净

1
2
3
4

git stash              # 把未提交的改动藏起来
git stash pop          # 恢复最近一次储藏并删除
git stash list         # 查看所有储藏
git stash apply        # 恢复但不删除

1
2

git restore file.py          # 撤销单个文件的工作区修改
git restore --staged file.py # 把文件从暂存区移出（取消 add）

1
2
3

git reset --soft HEAD~1   # 回退到上一次提交，改动留在暂存区
git reset --mixed HEAD~1  # 回退，改动留在工作区（默认行为）
git reset --hard HEAD~1   # 彻底回退，丢弃所有改动（危险！）

1

git revert <commit-id>

1
2
3

git tag v1.0                          # 轻量标签
git tag -a v1.0 -m "发布版本 1.0"     # 附注标签
git push origin v1.0                  # 推送标签到远程

1
2
3
4

.env            # 密钥/环境变量，禁止提交
node_modules/
__pycache__/
*.log

1

git remote set-url --add --push origin https://github.com/你的/AgentLearn.git

1
2
3

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.lg "log --oneline --graph"

1
2
3
4

git status
git add .
git commit -m "feat: xxx"
git push

1
2
3
4
5

git clone https://github.com/你的/fork.git
git remote add upstream https://github.com/原作者/repo.git
git fetch upstream
git merge upstream/main
git push origin main

1
2
3
4
5
6

git stash
git switch -c hotfix
# 修复、提交……
git switch main
git merge hotfix
git stash pop

1
2
3

git log --oneline             # 找到目标 commit 的 id
git reset --hard <commit-id>  # 工作区/暂存区/版本库全部回到该版本
git reset --hard HEAD~3       # 回退最近 3 个提交

1
2

git revert <commit-id>          # 生成一个反向提交，抵消该次改动
git revert HEAD~2..HEAD         # 批量撤销最近 2 个提交

1
2

git checkout <commit-id>        # 进入 detached HEAD 查看旧代码
git switch -                    # 看完切回原分支

1

git push --force-with-lease origin main

1
2

git reflog                     # 查看 HEAD 移动记录，定位丢失的 commit id
git reset --hard <commit-id>   # 恢复

1
2
3

git remote -v                                          # 查看当前关联
git remote set-url origin https://github.com/新用户名/新仓库名.git
git remote -v                                          # 确认已更新

1

git remote set-url origin <新地址>

1

git remote rename origin github

1
2
3
4
5

# HTTPS → SSH
git remote set-url origin git@github.com:用户名/仓库名.git

# SSH → HTTPS
git remote set-url origin https://github.com/用户名/仓库名.git

1
2
3
4

ssh-keygen -t ed25519 -C "you@example.com"   # 生成密钥对，一路回车
cat ~/.ssh/id_ed25519.pub                     # 复制公钥内容
# 到 GitHub → Settings → SSH and GPG keys 粘贴添加
ssh -T git@github.com                         # 测试连接，看到成功提示即可

1

git credential-manager reject https://github.com

1
2

git remote -v                  # URL 是 https:// 还是 git@ 一目了然
ssh -T git@github.com         # 单独验证 SSH 是否连通

1
2
3

cat .gitignore                   # 直接查看文件内容
code .gitignore                  # 用编辑器打开（VS Code）
git status --ignored             # 查看当前被忽略的文件列表

1
2

git check-ignore -v node_modules   # 显示匹配的规则及其所在行
git check-ignore .env              # 有输出 = 被忽略；无输出 = 未被忽略

1
2
3
4

# 方式一：直接编辑文件（记事本 / VS Code / vim）
# 方式二：命令行追加一条规则
echo "*.log" >> .gitignore
echo ".env"  >> .gitignore

1
2
3
4
5

.env                  # 忽略名为 .env 的文件
.env.*                # 忽略 .env.local 等变体
*.log                 # 忽略所有 .log
node_modules/         # 忽略目录
/build                # 忽略根目录下的 build

1
2

git rm --cached .env          # 从版本库/暂存区移除，但保留本地文件
git commit -m "stop tracking .env"

1

git add -f important.log      # -f 强制添加，即使被 .gitignore 忽略

1
2

git config --global core.excludesfile ~/.gitignore_global
# 之后编辑 ~/.gitignore_global 写入规则，对当前用户所有仓库生效