主题
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 # 或者放弃这次合并,回到操作前六、撤销与修改
按「改到哪一步了」选命令:
| 场景 | 命令 | 说明 |
|---|---|---|
| 改了文件还没 add | git checkout -- 文件名 | 丢弃工作区改动(新版:git restore 文件名) |
| add 了还没 commit | git 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 exists | git 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。