git配置

1
情景：你同时修改了 3 个文件
2
  - docs/weekly/2026-W26.md    ← 这周的周报，写完了
3
  - src/main.py                ← 正在写的功能，还没完成
4
  - README.md                  ← 随手改了一个错别字
5

6
理想方案：把周报和 README 分两个 commit 提交，src/main.py 先不提交
7

8
操作：
9
git add docs/weekly/2026-W26.md
10
git commit -m "docs: 新增 2026-W26 周报"
11

12
git add README.md
13
git commit -m "fix: 修正 README 错别字"
14

15
# src/main.py 继续在工作区，不影响上面两个 commit

1
# 基本提交（-m 后跟 commit message）
2
git commit -m "docs: 添加 2026-W26 周报"
3

4
# 提交时查看暂存区内容（进入编辑器写多行 message）
5
git commit
6

7
# 修改最近一次 commit message（只改信息，不改代码）
8
# ⚠️ 注意：只能改本地还未 push 的 commit
9
git commit --amend -m "docs: 修正周报标题格式"
10
#--amend` 会改变 commit 的 hash，push 过的 commit 被修改后，和远端历史不一致，会导致 push 失败甚至历史混乱。
11

12
#实战
13
# 1. 新建练习分支
14
git switch main
15
git pull
16
git switch -c feat/commit-practice
17

18
# 2. 新建一个练习文件
19
New-Item docs\practice-commit.txt
20
Add-Content docs\practice-commit.txt "这是一个练习文件"
21

22
# 3. 完整提交流程
23
git status
24
git add docs\practice-commit.txt
25
git status
26
git commit -m "docs: 添加 commit 练习文件"
27

28
# 4. 查看提交结果
29
git log --oneline -3
30

31
# 5. 清理（切回 main 删分支）
32
git switch main
33
git branch -d feat/commit-practice

1
✅ 好的 commit message：
2
  docs: 新增 2026-W26 周报
3
  docs(weekly): 添加唐玲欣第26周周报
4
  fix: 修复用户名显示为 undefined 的问题
5
  feat: 新增按日期筛选任务的功能
6
  chore: 升级 fastapi 依赖到 0.115.0
7

8
❌ 不好的 commit message：
9
  update
10
  修改
11
  fix bug
12
  改了点东西
13
  123
14
  asdfgh
15
  test

1
┌──────────────────────────────────────────────────────────┐
2
│                         你的电脑                          │
3
│                                                          │
4
│  ┌─────────────┐   git add   ┌──────────────┐           │
5
│  │  Working    │ ──────────► │   Staging    │           │
6
│  │  Tree       │ ◄────────── │   Area       │           │
7
│  │  工作区     │  git restore │   暂存区     │           │
8
│  └─────────────┘             └──────┬───────┘           │
9
│                                     │ git commit         │
10
│                                     ▼                    │
11
│                              ┌──────────────┐           │
12
│                              │  Repository  │           │
13
│                              │  本地仓库    │           │
14
│                              └──────────────┘           │
15
└──────────────────────────────────────────────────────────┘
16
         ↕  git push / git pull / git fetch
17
┌──────────────────────────────────────────────────────────┐
18
│                    GitHub（远端）                         │
19
└──────────────────────────────────────────────────────────┘

1
# 第一步：新建一个文件
2
# 此时文件状态：Untracked（未追踪，Git 不认识它）
3
New-Item docs\weekly\2026-W26.md
4

5
# 查看状态
6
git status
7
# 输出：Untracked files: docs/weekly/2026-W26.md
8

9
# 第二步：git add 把文件放入暂存区
10
# 此时文件状态：Staged（已暂存）
11
git add docs\weekly\2026-W26.md
12

13
# 查看状态
14
git status
15
# 输出：Changes to be committed: new file: docs/weekly/2026-W26.md
16

17
# 第三步：git commit 把暂存区的内容打包成提交
18
# 此时文件进入本地仓库
19
git commit -m "docs: 新增 2026-W26 周报"
20

21

22
# 查看状态
23
git status
24
# 输出：nothing to commit, working tree clean
25

26
# 还可以5. 从暂存区取出（不提交这个测试文件）
27
git restore --staged test-staging.txt
28

29

30
# 查看历史
31
git log --oneline -3
32

33

34
# 7. 删除这个测试文件（清理）
35
Remove-Item test-staging.txt

1
# 查看所有本地分支（当前分支前有 * 标记）
2
git branch
3

4
feat/weekly-tanglx-report（）
5
# 查看所有分支（含远端）
6
git branch -a
7

8
* master
9
  remotes/origin/HEAD -> origin/master
10
  remotes/origin/master
11

12
# 切换到已有分支
13
git switch main
14

15
fix/login-error
16

17
# 新建分支（从当前位置）
18
git switch -c feat/weekly-tanglx-report
19

20
# 新建分支（从指定分支）
21
git switch -c feat/my-task origin/main
22

23
# 删除本地分支（安全版，只有已合并才能删）
24
git branch -d feat/weekly-tanglx-report
25

26
# 强制删除本地分支（谨慎使用）
27
git branch -D feat/weekly-tanglx-report

1
# 1. 确认当前在 main 分支
2
git switch main
3
git pull
4

5
# 2. 新建一个练习分支
6
git switch -c feat/practice-tanglx
7

8
# 3. 确认分支创建成功
9
git branch
10

11
# 4. 查看包含远端的所有分支
12
git branch -a
13

14
# 5. 切回 main
15
git switch main
16

17
# 6. 删除刚才的练习分支
18
git branch -d feat/practice-tanglx
19

20
# 7. 确认分支已删除
21
git branch

1
# 状态1：干净状态
2
git switch main
3
git status
4

5
# 状态2：制造 modified
6
# （用编辑器改任意一个已有文件的内容，保存）
7
git status
8

9
# 状态3：制造 untracked
10
New-Item docs\test-untracked.txt
11
git status
12

13
# 状态4：制造 staged
14
git add docs\test-untracked.txt
15
git status
16

17
# 状态5：查看 ahead（需要先 commit）
18
git commit -m "test: 临时测试文件"
19
git status   # 应该看到 ahead
20

21
# 清理
22
git switch main
23
git branch -d 当前分支  # 如果不是 main 上操作的
24
git checkout -- .      # 丢弃 main 上的修改（见11节危险命令，这里用于清理）
25
Remove-Item docs\test-untracked.txt -ErrorAction SilentlyContinue

1
# 保存当前所有未提交改动（工作区 + 暂存区）
2
git stash
3

4
# 保存时附加说明
5
git stash push -m "feat/A 写到一半，临时切去修紧急 bug"
6

7
# 查看 stash 列表
8
git stash list
9
# 输出：
10
# stash@{0}: On feat/A: feat/A 写到一半，临时切去修紧急 bug
11
# stash@{1}: WIP on main: 3a7b1d9 docs: 上次的改动
12

13
# 恢复最近一次 stash（并从列表删除）
14
git stash pop
15

16
# 恢复但不删除（保留在列表里）
17
git stash apply stash@{0}
18

19
# 删除某个 stash
20
git stash drop stash@{0}
21

22
# 清空所有 stash
23
git stash clear

1
# Python
2
__pycache__/
3
*.pyc
4
.venv/
5
.env
6

7
# Node.js
8
node_modules/
9
dist/
10
.env.local
11

12
# 编辑器
13
.vscode/
14
.idea/
15
*.swp
16

17
# 系统文件
18
.DS_Store
19
Thumbs.db
20

21
# 日志
22
*.log
23
logs/
24

25

26
# 检查某个文件是否被 ignore
27
git check-ignore -v .env
28

29
# 如果文件已经被追踪，需要先移除追踪再 ignore
30
git rm --cached .env
31
# 然后把 .env 加进 .gitignore

1
# 工作区 vs 暂存区（改了但还没 add 的内容）
2
git diff
3

4
# 暂存区 vs 最近一次 commit（已 add 但还没 commit 的内容）
5
git diff --staged
6

7
# 比较两个分支的差异
8
git diff main feat/weekly-tanglx-w26
9

10
# 比较某个文件的差异
11
git diff docs/weekly/2026-W26.md
12

13
# 比较两个 commit
14

15
git diff abc1234 def5678
16
diff --git a/docs/weekly/2026-W26.md b/docs/weekly/2026-W26.md
17
index 3a7b1d9..f2e8c1a 100644
18
--- a/docs/weekly/2026-W26.md    ← 旧版本
19
+++ b/docs/weekly/2026-W26.md    ← 新版本
20
@@ -1,3 +1,5 @@
21
 # 2026-W26 周报
22
+
23
+## 本周完成
24
+- 学习了 Git 基础操作    ← + 号是新增的行
25
-旧内容                          ← - 号是删除的行

1
# 第一步：切换到 main
2
git switch main
3

4
# 第二步：拉取最新代码
5
git pull
6

7
# 输出示例（有新内容时）：
8
# Updating 3a7b1d9..f2e8c1a
9
# Fast-forward
10
#  docs/weekly/2026-W25.md | 45 +++++++++++
11
#  1 file changed, 45 insertions(+)
12

13
# 输出示例（没有新内容时）：
14
# Already up to date.
15

16
# 第三步：新建功能分支
17
git switch -c feat/weekly-tanglx-w26