Git使用教程

git --version

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

git config --list              # 查看所有配置
git config user.name           # 查看指定配置项

git config --global core.editor "code --wait"   # 指定默认编辑器
git config --global init.defaultBranch main      # 新仓库默认分支名为 main
git config --global core.autocrlf true           # Windows 下处理换行符
git config --global core.autocrlf input          # macOS / Linux 下处理换行符

mkdir runoob-git
cd runoob-git
git init

git add README.md      # 添加指定文件
git add src/          # 添加指定目录
git add .             # 添加当前目录下的所有修改（包括新文件）
git add -A            # 添加整个仓库的所有修改（包括删除）
git add -p            # 交互式选择文件中的部分修改后再暂存

git commit -m "添加 README 文件"
git commit -am "修改登录逻辑"      # 对已跟踪的文件执行 add 并提交（新文件不会被包含）
git commit --amend                 # 修改最近一次提交（信息或内容）

git status

git diff                     # 工作区 与 暂存区 的差异
git diff --staged            # 暂存区 与 最近一次提交 的差异（--cached 同义）
git diff HEAD                # 工作区 与 最近一次提交 的差异
git diff HEAD~1 HEAD         # 两次提交之间的差异
git diff --stat              # 只显示变更文件的统计信息

git log                              # 显示完整提交历史
git log --oneline                    # 每个提交显示一行
git log -3                           # 只显示最近 3 次提交
git log -p                           # 显示每次提交的具体改动
git log --author="Your Name"         # 按作者过滤
git log --graph --oneline --all      # 以图形方式显示所有分支
git show <commit-id>                 # 查看某次提交的详细内容

git reset --soft HEAD~1      # 回退到上一版本，修改保留在暂存区
git reset --mixed HEAD~1     # 回退到上一版本，修改保留在工作区（默认模式）
git reset --hard HEAD~1      # 回退到上一版本，修改全部丢弃
git reset --hard 3628164     # 回退到指定的版本

git reflog
# 输出示例：
# 3628164 HEAD@{0}: reset: moving to HEAD^
# 9e8f7a1 HEAD@{1}: commit: 修改登录逻辑
 
git reset --hard 9e8f7a1     # 恢复到该版本

git revert 9e8f7a1

git restore README.md          # 新版写法
git checkout -- README.md      # 旧版写法，效果相同

git restore --staged README.md   # 新版写法：仅取消暂存
git reset HEAD README.md         # 旧版写法：仅取消暂存

git rm old.txt                 # 删除文件并将删除操作加入暂存区
git rm --cached secret.txt     # 只从 Git 中移除跟踪，保留本地文件
git mv old.txt new.txt         # 重命名或移动文件

ssh-keygen -t ed25519 -C "you@example.com"
cat ~/.ssh/id_ed25519.pub     # 复制输出内容，添加到代码托管平台的 SSH Keys 设置中
ssh -T git@github.com         # 测试连接

git remote add origin git@github.com:username/runoob-git.git
git remote -v                  # 查看远程仓库地址
git remote show origin         # 查看远程仓库的详细信息
git remote rename origin upstream
git remote remove upstream

git push -u origin main        # 首次推送，并建立本地 main 与远程 main 的关联
git push                       # 关联后直接推送
git push origin dev            # 推送指定分支
git push --force-with-lease    # 安全的强制推送（会覆盖远程历史，谨慎使用）

git clone git@github.com:username/runoob-git.git
git clone https://github.com/username/runoob-git.git
git clone -b dev git@github.com:username/runoob-git.git   # 克隆并直接切换到 dev 分支

git fetch origin
git pull origin main
git pull --rebase origin main

git branch                     # 查看本地分支（当前分支前有 * 标记）
git branch -a                  # 查看所有分支（包括远程分支）
git branch dev                 # 创建 dev 分支
git switch dev                 # 切换到 dev 分支（新版写法）
git checkout dev               # 切换到 dev 分支（旧版写法）
git switch -c feature/login    # 创建并切换到新分支（新版写法）
git checkout -b feature/login  # 创建并切换到新分支（旧版写法）
git branch -d dev              # 删除已合并的分支
git branch -D dev              # 强制删除未合并的分支
git branch -m old new          # 重命名分支

git switch main
git merge dev

git merge --no-ff -m "合并 dev 分支的新功能" dev

git stash                      # 保存当前未提交的修改
git stash list                 # 查看保存的列表
git stash pop                  # 恢复最近一次保存的内容，并从列表中删除
git stash apply stash@{1}      # 恢复指定的保存内容，但保留在列表中
git stash drop stash@{0}       # 删除指定的保存内容
git stash -u                   # 同时保存未跟踪的新文件

git clone git@github.com:team/project.git
git switch -c feature/payment origin/dev    # 基于远程 dev 创建功能分支
# ...编写代码...
git add . && git commit -m "实现支付接口"
git push -u origin feature/payment          # 推送功能分支
# 在代码托管平台发起 Pull Request / Merge Request，审核通过后合并
git switch dev
git pull                                     # 同步团队最新代码

git switch feature/login
git rebase main

git tag                                  # 查看所有标签
git tag v1.0                             # 创建轻量标签（只记录提交编号）
git tag -a v1.0 -m "正式版本 1.0"        # 创建附注标签（包含标签者、日期和说明）
git tag -a v0.9 -m "测试版" 3628164      # 为指定提交打标签
git show v1.0                            # 查看标签信息
git tag -d v1.0                          # 删除本地标签
git push origin v1.0                     # 推送单个标签到远程
git push origin --tags                   # 推送所有标签到远程
git push origin --delete v1.0            # 删除远程标签

git check-ignore -v build/app.js

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --graph --oneline --all --decorate"

# 1. 创建并初始化项目
mkdir hello-git && cd hello-git
git init
 
# 2. 创建文件并提交
echo "# Hello Git" > README.md
git add README.md
git commit -m "初始化项目"
 
# 3. 创建功能分支并开发
git switch -c feature/greet
echo "print('Hello, Git!')" > hello.py
git add hello.py
git commit -m "添加问候脚本"
 
# 4. 切回主分支并合并
git switch main
git merge --no-ff -m "合并 feature/greet" feature/greet
 
# 5. 删除已合并的分支
git branch -d feature/greet
 
# 6. 添加远程仓库并推送
git remote add origin git@github.com:username/hello-git.git
git push -u origin main
 
# 7. 打标签发布
git tag -a v1.0 -m "第一个版本"
git push origin v1.0