Skip to content

Git 使用 ​

从创建仓库、日常提交到分支回退。示例以 WSL2 + GitHub 为准,命令都带注释,可以直接照着敲。

一、首次配置(只做一次) ​

bash
git config --global user.name  "your-name"          # 提交记录里显示的作者名
git config --global user.email "you@example.com"    # 作者邮箱,GitHub 靠它关联账号
git config --global init.defaultBranch main         # 新仓库默认分支叫 main
git config --global core.autocrlf input             # WSL 下提交时把 CRLF 转 LF,避免整个文件显示被改
git config --list                                   # 查看当前生效的配置

SSH 免密推送 ​

bash
ssh-keygen -t ed25519 -C "you@example.com"          # 生成密钥对,一路回车(-C 只是备注)
cat ~/.ssh/id_ed25519.pub                           # 复制公钥内容
# GitHub → Settings → SSH and GPG keys → New SSH key → 粘贴 → 保存
ssh -T git@github.com                               # 出现 "Hi xxx!" 说明成功
eval "$(ssh-agent -s)"                              # 启动 ssh-agent
ssh-add ~/.ssh/id_ed25519                           # 把私钥加进 agent(重启 WSL 后可能需要重跑)

二、新建仓库并推送 ​

先在 GitHub 建一个空仓库(不要勾选「Initialize with README」),再在本地:

bash
mkdir -p ~/projects/demo && cd ~/projects/demo      # 建目录并进入
git init                                            # 初始化本地仓库,生成 .git/
printf 'build/\n*.o\n.env\n' > .gitignore           # 创建忽略规则
echo "# demo" > README.md                           # 写一个说明文件

git status                                          # 查看当前状态:红色未暂存,绿色已暂存
git add .                                           # 把当前目录所有改动放进暂存区
git commit -m "initial: 项目初始化"                  # 提交到本地仓库,-m 写提交说明
git branch -M main                                  # 把当前分支强制改名为 main
git remote add origin git@github.com:you/demo.git   # 给远程地址起别名 origin
git push -u origin main                             # 首次推送,-u 建立本地 main 与远程的追踪关系
git remote -v                                       # 确认远程地址

-u 的作用:之后直接 git push / git pull 就行,不用每次写 origin main。

项目放 WSL2 原生文件系统(~/...),别放 /mnt/c/...:跨文件系统读写慢,还容易出现权限和换行符问题。

三、日常三部曲 ​

bash
git status                        # 先看改了什么
git diff                          # 看未暂存的具体改动(工作区 vs 暂存区)
git diff --staged                 # 看已暂存、待提交的改动
git add .                         # 全部暂存;也可以 git add src/main.cpp 只加某个文件
git commit -m "fix: 修复登录超时"  # 提交,说明写清楚「改了什么」
git push                          # 推到远程(已建立追踪关系时)
git log --oneline --graph --all   # 图形化看提交历史

提交说明约定(团队协作常用):feat: 新功能 · fix: 修 bug · refactor: 重构 · docs: 文档 · test: 测试 · chore: 杂项。

四、分支 ​

bash
git branch                        # 列出本地分支,* 表示当前分支
git branch -a                     # 连远程分支一起列
git checkout -b dev               # 新建 dev 并切换过去(等效 git switch -c dev)
git switch main                   # 切回 main(新版命令,语义更清楚)
git merge dev                     # 把 dev 合并进当前分支
git branch -d dev                 # 删除已合并的 dev(-D 强制删除未合并的)
git push -u origin dev            # 把 dev 推到远程并建立追踪

典型流程:

bash
git switch -c feature/login       # 1. 从 main 开一条功能分支
# ... 改代码 ...
git add . && git commit -m "feat: 登录页"   # 2. 在分支上提交
git switch main                   # 3. 切回 main
git merge feature/login           # 4. 合并(无冲突时自动完成)
git push                          # 5. 推送

五、解决冲突 ​

git pull 或 git merge 报 CONFLICT 后:

bash
git status                        # 列出冲突文件(both modified)
# 打开文件,会看到三段标记:
#   <<<<<<< HEAD        当前分支的内容
#   =======             分隔线
#   >>>>>>> dev         要合并进来的内容
# 手动删掉标记,保留最终想要的内容
git add 冲突文件                   # 标记为已解决
git commit                        # 完成合并提交
git merge --abort                 # 或者放弃这次合并,回到操作前

六、撤销与修改 ​

按「改到哪一步了」选命令:

场景命令说明
改了文件还没 addgit checkout -- 文件名丢弃工作区改动(新版:git restore 文件名)
add 了还没 commitgit reset 文件名从暂存区撤回,改动仍在工作区
刚 commit 想改说明git commit --amend -m "新说明"只改说明,不改内容
想退回上一版git reset --hard HEAD^丢弃工作区,慎用
已推送但想撤销git revert 提交ID生成一个反向提交,安全,团队可用
临时存一下改动git stash / git stash pop切分支前把没提交的改动收起来
bash
git reset --soft HEAD^     # 撤销提交,改动留在暂存区(想重新提交时用)
git reset --mixed HEAD^    # 撤销提交和暂存,改动留在工作区(默认)
git reset --hard HEAD^     # 撤销提交、暂存、工作区改动(不可恢复)
git revert abc1234         # 撤销某次已推送的提交,历史保留

七、.gitignore ​

永远不要提交密码、密钥、虚拟环境、编译产物:

text
build/             # 编译输出目录
*.o                # 目标文件
*.so               # 动态库
bin/               # 可执行文件
.env               # 环境变量(常含密钥)
node_modules/      # 依赖目录
__pycache__/       # Python 缓存
.idea/ .vscode/    # 编辑器配置(团队约定不提交时)

已跟踪的文件再加进 .gitignore 不会生效,需要先 git rm --cached 文件名。

八、其他高频操作 ​

bash
git tag v1.0.0                        # 打轻量标签
git tag -a v1.0.0 -m "release"        # 打带说明的标签
git push origin v1.0.0                # 推送单个标签
git push --tags                       # 推送全部标签

git clone git@github.com:you/demo.git # 克隆仓库
git pull --rebase                     # 拉取并把本地提交挪到远程之后,历史更线性
git fetch --prune                     # 拉取远程更新并清理已删除的远程分支

git log -p 文件名                      # 看某个文件的修改历史
git blame 文件名                       # 逐行看是谁、哪次提交改的
git show 提交ID                        # 查看某次提交的完整 diff

九、常见问题 ​

报错处理
remote origin already existsgit remote remove origin 后重新 add
Permission denied (publickey)ssh-add ~/.ssh/id_ed25519;仍不行检查公钥是否贴到 GitHub
fatal: not a git repository当前目录不是仓库,cd 到项目根目录或先 git init
Updates were rejected远程有你本地没有的提交:先 git pull --rebase 再 push
detached HEAD切到了某个提交而不是分支,git switch -c 新分支 保存工作
换行符整片变红git config core.autocrlf input,或加 .gitattributes

也完全可以不用命令行:项目目录执行 code .,在 VS Code 的「源代码管理」面板完成 add / commit / push。