Git 使用指南 - youki的笔记

安装与配置#

安装#

Windows：git-scm.com 下载安装包，按向导完成
macOS：brew install git 或安装 Xcode Command Line Tools

用户信息配置#

1
git config --global user.name "你的名字"
2
git config --global user.email "你的邮箱"

SSH Key 配置#

1
# 生成密钥对
2
ssh-keygen -t ed25519 -C "你的邮箱"
3

4
# 查看公钥，复制到 GitHub/GitLab 的 SSH Keys 设置中
5
cat ~/.ssh/id_ed25519.pub
6

7
# 测试连接
8
ssh -T git@github.com

基础工作流#

1
# 初始化仓库
2
git init
3

4
# 克隆远程仓库
5
git clone git@github.com:user/repo.git
6

7
# 查看状态
8
git status
9

10
# 添加到暂存区
11
git add .                # 所有文件
12
git add file.txt         # 指定文件
13

14
# 提交
15
git commit -m "提交说明"
16

17
# 推送到远程
18
git push origin main
19

20
# 拉取远程更新
21
git pull origin main
22

23
# 查看提交历史
24
git log --oneline

分支管理#

1
# 查看分支
2
git branch
3

4
# 创建并切换分支
5
git checkout -b feature/xxx
6
# 或用新版命令
7
git switch -c feature/xxx
8

9
# 切换分支
10
git checkout main
11

12
# 合并分支（在 main 上合并 feature）
13
git merge feature/xxx
14

15
# 删除分支
16
git branch -d feature/xxx

解决合并冲突#

合并时如果出现冲突，手动编辑冲突文件，保留需要的内容，然后：

1
git add .
2
git commit -m "解决合并冲突"

常用技巧#

.gitignore#

在仓库根目录创建 .gitignore 文件，列出不需要跟踪的文件：

1
# 依赖目录
2
node_modules/
3
__pycache__/
4

5
# 编辑器配置
6
.vscode/
7
.idea/
8

9
# 系统文件
10
.DS_Store
11
Thumbs.db
12

13
# 构建产物
14
dist/
15
build/

移除跟踪但保留本地文件#

1
# 从 Git 跟踪中移除（不会删除本地文件）
2
git rm --cached .obsidian/app.json
3

4
# 或移除整个目录
5
git rm --cached -r .obsidian/
6

7
# 加入 .gitignore 防止再次跟踪
8
echo ".obsidian/" >> .gitignore
9
git add .gitignore
10
git commit -m "移除配置文件跟踪"

stash 暂存工作区#

1
# 暂存当前修改
2
git stash
3

4
# 恢复暂存
5
git stash pop
6

7
# 查看暂存列表
8
git stash list

撤销操作#

1
# 撤销工作区修改（未 add）
2
git checkout -- file.txt
3

4
# 撤销暂存（已 add 未 commit）
5
git reset HEAD file.txt
6

7
# 撤销最近一次提交（保留修改）
8
git reset --soft HEAD~1

图形化工具#

PyCharm 集成：内置 Git 支持，VCS 菜单直接操作
VSCode 集成：左侧源代码管理面板，支持 diff、提交、推送