Git 入门到推送 GitHub 完整教程#

基于 D:\desktop\double_car\ 项目的实战记录远程仓库：git@github.com:forest-wang-sunshine/double_car.git 整理时间：2026-05-04

📑 目录#

阶段 0：前置检查
阶段 1：理解 Git 的核心概念
阶段 2：本地仓库操作
阶段 3：推送到 GitHub
阶段 4：日常工作流
日常命令速查表
新手常见坑
本项目实际操作记录

阶段 0：前置检查#

在开始之前，确认下面 3 件事：

1
git --version                              # 1. Git 是否安装
2
git config --global user.name              # 2. 全局用户名
3
git config --global user.email             # 3. 全局邮箱
4
ls -la ~/.ssh/                             # 4. SSH 密钥是否存在（id_rsa / id_rsa.pub）
5
ssh -T git@github.com                      # 5. 测试 SSH 连接 GitHub

测试 SSH 成功的标志：返回类似 Hi <你的GitHub用户名>! You've successfully authenticated...（虽然 exit code 是 1，但消息是成功的）。

如果还没有 Git 用户配置，初次配置：

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

阶段 1：理解 Git 的核心概念#

在敲任何指令之前，必须先建立这张图的概念，否则后面会迷路：

1
   ┌─────────────────┐    git add    ┌─────────────────┐
2
   │   工作区         │ ────────────► │   暂存区         │
3
   │ (Working Dir)   │               │  (Staging Area) │
4
   │                 │               │                 │
5
   │ 你看到的文件夹   │               │ 准备打包的快照   │
6
   └─────────────────┘               └─────────────────┘
7
                                              │
8
                                              │ git commit
9
                                              ▼
10
   ┌─────────────────┐   git push    ┌─────────────────┐
11
   │  远程仓库        │ ◄──────────── │   本地仓库       │
12
   │ (GitHub)        │               │ (.git 文件夹)    │
13
   │                 │   git pull    │                 │
14
   │ 别人能访问到的   │ ────────────► │ 完整的版本历史   │
15
   └─────────────────┘               └─────────────────┘

4 个区的角色#

工作区：就是你看到的项目文件夹本身，写代码、改代码都在这里。
暂存区：临时托盘。修改了 100 个文件，但只想把其中 5 个打包成一次提交，就用 git add 把这 5 个挑到暂存区。
本地仓库：藏在项目根目录的 .git/ 文件夹里。git commit 会把暂存区的快照永久存进去，每次提交都有一个唯一 ID（哈希值）。
远程仓库：GitHub 上的那份。和本地仓库结构几乎一样，靠 git push 上传、git pull 下载。

3 个核心动作 = 3 个箭头#

命令	作用
`git add 文件名`	工作区 → 暂存区
`git commit -m "说明"`	暂存区 → 本地仓库
`git push`	本地仓库 → GitHub

文件的 4 种状态#

1
                  git add 它们后
2
  Untracked   ──────────────────►   Staged（已暂存）
3
  (未追踪)                              ↑          │ git commit
4
                                       │          ▼
5
  Modified    ◄──────  改文件  ──────  Committed（已提交）
6
  (已修改)                                 (已提交，干净状态)

阶段 2：本地仓库操作#

第 1 步：初始化 Git 仓库#

1
git init

作用：

在当前目录创建一个隐藏的 .git/ 文件夹（就是”本地仓库”）
只需要做一次，以后这个项目永远是 Git 仓库
删除 .git/ = 抹掉所有 Git 历史，但代码本身还在

第 2 步：写 `.gitignore`（极其重要！）#

.gitignore 是一个告诉 Git “请假装看不见这些文件” 的清单。

为什么这一步比 git init 还重要？

如果跳过这步直接 git add .，会有 4 个灾难：

大压缩包进仓库 → 仓库爆肥
Debug/、.elf、.hex、.map 进仓库 → 每次编译都产生几十 MB 改动
.settings/、.cproject 进仓库 → 别人 clone 后 IDE 会冲突
Windows 的 Thumbs.db、*.bak 进仓库 → 又脏又没用

本项目的 `.gitignore` 模板（AURIX + Eclipse + Windows）#

1
# ===== 编译产物（TASKING / GCC）=====
2
*.o
3
*.d
4
*.elf
5
*.hex
6
*.bin
7
*.map
8
*.lst
9
*.src
10
*.a
11
*.lib
12

13
# ===== 构建输出目录 =====
14
Debug/
15
Release/
16
External GCC - Debug/
17
build/
18

19
# ===== Eclipse / AURIX Studio IDE 文件 =====
20
.settings/
21
.metadata/
22
.recommenders/
23
*.launch
24

25
# 注意：.cproject / .project 是 Eclipse 项目描述文件
26
# 团队协作时通常需要保留，这里先保留
27
# .cproject
28
# .project
29

30
# ===== VSCode / Cursor / Kiro 编辑器配置 =====
31
.vscode/
32
.cursor/
33
.kiro/
34

35
# ===== 临时文件 =====
36
*.tmp
37
*.temp
38
*.log
39
*.bak
40
*~
41

42
# ===== 系统垃圾文件 =====
43
.DS_Store
44
Thumbs.db
45
desktop.ini
46

47
# ===== 项目自带脚本（不需要进版本控制）=====
48
删除临时文件.bat
49

50
# ===== 大文件 / 备份压缩包 =====
51
*.zip
52
*.7z
53
*.rar
54

55
# ===== 运行时输出 =====
56
outputs/runtime/
57

58
# ===== Claude Code 本地配置 =====
59
.claude/settings.local.json

⚠️ 顺序铁律：.gitignore 必须先于 git add 写好。如果已经 add 进去了再写 .gitignore，那个文件不会被忽略，需要 git rm --cached 文件名 才能撤销。

第 3 步：查看状态#

1
git status

输出关键字解读：

1
On branch master              ← 当前分支名
2
No commits yet                ← 还没有任何提交
3
Untracked files:              ← "未追踪文件" = Git 还不管这些文件
4
  .gitignore
5
  CLAUDE.md
6
  ...

第 4 步：把分支名 `master` 改成 `main`#

1
git branch -M main

为什么改？

老版本 Git 默认分支叫 master，新版本（GitHub 也一样）默认叫 main
如果本地是 master 但 GitHub 上是 main，推送时会一团糟
统一改成 main 是现在的标准

-M = “rename + force”（重命名 + 强制覆盖）。

让以后新建的仓库默认就用 main：

1
git config --global init.defaultBranch main

第 5 步：把文件加到暂存区（`git add`）#

命令	作用	何时用
`git add 文件名`	加单个文件	只想提交某个具体文件
`git add 文件夹/`	加整个文件夹（递归）	加某个模块所有改动
`git add .`	加当前目录及子目录所有改动	最常用
`git add -A`	加整个仓库所有改动（包括删除）	和 `.` 几乎一样，更彻底

关于 `LF will be replaced by CRLF` 警告#

Windows 用 CRLF (\r\n)，Linux/Mac 用 LF (\n)。Git 默认会自动转换换行符，这只是警告，不是错误。

让 Git 不再刷一堆警告：

1
git config --global core.autocrlf true   # Windows 推荐

让 Git 正确显示中文文件名#

1
git config --global core.quotepath false

否则中文文件名会显示成 \345\217\202\346... 八进制乱码。

第 6 步：提交到本地仓库（`git commit`）#

1
git commit -m "提交说明"

部分	含义
`git commit`	把暂存区的内容打包成一个永久快照存进 `.git/`
`-m`	message 的缩写，后面跟提交说明
`"..."`	提交说明（必填，越清晰越好）

每次 commit 后会发生：

生成一个唯一的 40 位哈希 ID（如 a3f5b8...），作为这次提交的指纹
记录：谁提交的、什么时候、改了什么
以后能用 git log 查、git checkout 回到任意一次提交

Conventional Commits 提交信息规范#

格式：<类型>(<范围>): <简述>

类型	含义	例子
`feat`	新功能	`feat(front): 添加斑马线识别`
`fix`	修 bug	`fix(back): 修正卡尔曼滤波收敛问题`
`refactor`	重构（不改功能）	`refactor(common): 提取 PID 通用接口`
`chore`	杂项（构建、依赖、初始化等）	`chore: 初始化仓库`
`docs`	文档	`docs: 更新 README`
`style`	格式调整（空格、缩进）	`style: 格式化代码`
`test`	测试相关	`test: 添加单元测试`
`perf`	性能优化	`perf(back): 加速图像处理`

第 7 步：查看历史#

1
git log                  # 完整版（信息很多，按 q 退出）
2
git log --oneline        # 简洁版（一行一条）
3
git log --oneline -5     # 只看最近 5 条
4
git log --graph          # 带分支图

阶段 3：推送到 GitHub#

第 1 步：在 GitHub 网页创建空仓库#

打开 https://github.com/new
Repository name 填仓库名（如 double_car）
Public（公开）/ Private（私有）二选一
⚠️ 下面 3 个勾全部不要勾！
- ❌ 不要勾 Add a README file
- ❌ 不要勾 Add .gitignore
- ❌ 不要勾 Choose a license
原因： 本地仓库已经有这些文件。如果 GitHub 也创建，第一次 push 会报”两边历史不一致”的冲突，处理起来很烦。先建一个完全空的仓库最干净。
点 Create repository
复制提示页里的 SSH 地址：git@github.com:用户名/仓库名.git （注意是以 git@ 开头，不是 https://）

第 2 步：关联远程仓库（`git remote add`）#

1
git remote add origin git@github.com:用户名/仓库名.git

部分	含义
`git remote add`	添加一个远程仓库的引用
`origin`	远程仓库的别名，习惯叫 `origin`。可以叫别的，但 99% 的人都叫 origin
`git@github.com:...`	SSH 地址

这条命令做了什么？

不下载任何东西、不上传任何东西
只在 .git/config 文件里记一笔：“以后说 origin 就指这个 GitHub 地址”
之后 git push origin main 就等价于 git push git@github.com:用户名/仓库名.git main

查看已配置的远程仓库：

1
git remote -v

输出会显示两行 (fetch) 和 (push)，正常的：

(fetch) = 拉取代码时用这个地址
(push) = 推送代码时用这个地址

改 / 删 / 加远程：

1
git remote remove origin                     # 删除
2
git remote set-url origin <新地址>            # 改地址
3
git remote add backup git@github.com:...     # 加第二个远程

第 3 步：首次推送（`git push -u`）#

1
git push -u origin main

部分	含义
`git push`	推送本地提交到远程仓库
`-u`	`--set-upstream` 缩写。只在第一次需要，建立”本地 main ↔ origin/main”的追踪关系
`origin`	远程仓库别名
`main`	推送哪个分支

-u 的重要性：

没加：以后每次都要写完整 git push origin main
加了：以后只要敲 git push 就够了，Git 知道你要推 main → origin/main

所以首次推送一定要加 -u。

推送成功的标志：

1
branch 'main' set up to track 'origin/main'.
2
To github.com:用户名/仓库名.git
3
 * [new branch]      main -> main

阶段 4：日常工作流#

4 步循环#

1
   1. 改代码 / 写新文件
2
        ↓
3
   2. git add .              （把改动加到暂存区）
4
        ↓
5
   3. git commit -m "..."    （提交到本地仓库）
6
        ↓
7
   4. git push               （推送到 GitHub，注意：首次之后不需要 -u）

完整示例#

1
# 你刚改完了 PID.c，想提交
2
git status                            # 看看改了什么
3
# 输出: modified: Front_Car-main/code/PID.c
4

5
git diff                              # 看具体改了哪几行
6

7
git add Front_Car-main/code/PID.c     # 加到暂存区（也可以 git add .）
8

9
git status                            # 再看一眼，确认是 "Changes to be committed"
10

11
git commit -m "fix(front): 修正PID积分饱和"
12

13
git push                              # 推到 GitHub

日常命令速查表#

必备命令（90% 时间在用这 4 个）#

1
git status              # 看现在改了什么、有没有未提交的东西
2
git add .               # 把所有改动加到暂存区
3
git commit -m "..."     # 提交
4
git push                # 推到 GitHub

常用查看命令#

1
git log --oneline       # 简洁版提交历史
2
git log --oneline -5    # 只看最近 5 条
3
git log --graph         # 带分支图的历史
4
git diff                # 看工作区改了什么（还没 add 的）
5
git diff --staged       # 看暂存区改了什么（已 add 待 commit 的）
6
git diff HEAD           # 看从最后一次 commit 至今的全部改动
7
git remote -v           # 看远程仓库配置
8
git branch              # 看本地所有分支
9
git branch -a           # 看本地+远程所有分支
10
git show <提交哈希>      # 看某次提交的详细改动

撤销 / 后悔药#

1
git restore 文件名              # 撤销工作区的修改（恢复到上次提交的样子）
2
git restore --staged 文件名     # 把已 add 的文件从暂存区拿出来
3
git commit --amend -m "新说明"  # 改最后一次 commit 的说明（仅在 push 之前用！）
4
git reset HEAD~1               # 撤销最后一次 commit，但保留改动到工作区
5
git reset --hard HEAD~1        # 撤销最后一次 commit，且丢弃所有改动（危险！）
6
git rm --cached 文件名          # 把误 add 的文件从暂存区移除（保留本地文件）

⚠️ 铁律：已经 push 到 GitHub 的提交，不要轻易 reset 或 --amend，会让别人很麻烦。

多人协作（以后用）#

1
git pull                # 从 GitHub 拉最新代码到本地
2
git pull --rebase       # 拉取并把你的本地提交"垒"到最新代码上面（更干净）
3
git fetch               # 只下载，不合并（先看再决定）

配置类（一次性）#

1
git config --global user.name "你的名字"
2
git config --global user.email "你的邮箱"
3
git config --global init.defaultBranch main          # 默认分支用 main
4
git config --global core.autocrlf true               # Windows 自动换行符转换
5
git config --global core.quotepath false             # 中文文件名正常显示
6
git config --list                                    # 查看所有配置

新手常见坑#

坑 1：忘了 add 直接 commit#

1
git commit -m "..."   # 报错: nothing to commit

原因：没有 git add 过的改动不会被 commit。解药：先 git add . 再 commit。或者用 git commit -am "..."（-a 会自动 add 已追踪文件，但不会加新文件）。

坑 2：commit 信息写错了#

1
git commit -m "fxi typo"  # 拼错了"fix"

解药（push 前）：

1
git commit --amend -m "fix typo"

解药（push 后）：算了，下次注意。强行改会让别人 pull 时混乱。

坑 3：`git status` 看到一堆”幽灵文件”#

改了某文件后 git status 一直显示有改动，但你没改。

原因：换行符问题（CRLF/LF）。解药：

1
git config --global core.autocrlf true

坑 4：误把大文件 / 编译产物 commit 了#

最坏情况是已经 push 到 GitHub 了，仓库变得很大。

解药（仅本地）：

1
# 把误加的文件从暂存区/历史里清除，但保留本地文件
2
git rm --cached 大文件名
3
echo "大文件名" >> .gitignore
4
git add .gitignore
5
git commit -m "chore: 排除大文件"

已 push 到 GitHub 的彻底清除：用 git filter-repo 或 BFG Repo-Cleaner（进阶话题）。

坑 5：第一次 push 报错 `rejected`#

1
! [rejected] main -> main (fetch first)

原因：GitHub 仓库里有内容（比如创建仓库时勾了 README），跟本地不一致。

解药：

1
git pull origin main --allow-unrelated-histories   # 强行合并两边历史
2
# 解决冲突（如果有），然后
3
git push -u origin main

根治：创建 GitHub 仓库时别勾任何 README/.gitignore/license。

坑 6：`git push` 卡住不动#

可能是首次 push 的大量数据正在传输（项目大时正常）。

如果几分钟还没动静，按 Ctrl+C 终止，检查网络
SSH 推送在国内可能慢，可以考虑临时换 HTTPS 推送

本项目实际操作记录#

下面是 D:\desktop\double_car\ 项目从零推送到 GitHub 的完整命令序列（按时间顺序）：

1
# ===== 阶段 0：检查 =====
2
git --version                                  # git version 2.42.0.windows.1
3
git config --global user.name                  # forest
4
git config --global user.email                 # 2551021093@qq.com
5
ssh -T git@github.com                          # Hi forest-wang-sunshine!
6

7
# ===== 阶段 2：本地仓库 =====
8
cd D:\desktop\double_car
9
# 写 .gitignore（见上面模板）
10
git init                                       # Initialized empty Git repository in D:/desktop/double_car/.git/
11
git config --global core.quotepath false       # 中文文件名正常显示
12
git config --global init.defaultBranch main    # 默认分支用 main
13
git branch -M main                             # 把当前分支重命名为 main
14
git config --global core.autocrlf true         # Windows 换行符自动转换
15
git status                                     # 确认 .gitignore 生效（看不到 zip / Debug 等）
16
git add .                                      # 加 1365 个文件
17
git commit -m "chore: initial commit - 双车协作 AURIX 项目首次提交
18

19
包含两个独立的 TC264D 固件项目：
20
- Front_Car-main: 前车（车道跟随、环岛/十字/斑马线状态机）
21
- back_car-main: 后车（双目标连通域追踪、姿态+速度耦合）
22
以及项目级文档与设计推导笔记。"
23
# [main (root-commit) 95ac857]
24
# 1365 files changed, 892321 insertions(+)
25

26
git log --oneline                              # 95ac857 chore: initial commit ...
27

28
# ===== 阶段 3：推送到 GitHub =====
29
# （先在 https://github.com/new 创建空仓库 double_car，不勾任何选项）
30

31
git remote add origin git@github.com:forest-wang-sunshine/double_car.git
32
git remote -v                                  # 确认 fetch / push 地址
33
git push -u origin main
34
# branch 'main' set up to track 'origin/main'.
35
# To github.com:forest-wang-sunshine/double_car.git
36
#  * [new branch]      main -> main

进阶学习路径#

按优先级，下面这些是接下来该学的：

分支（branch）和合并（merge） —— 同时开发新功能不影响主线
- git branch feature/xxx 创建分支
- git checkout feature/xxx 或 git switch feature/xxx 切换分支
- git merge feature/xxx 合并分支回 main
- git branch -d feature/xxx 删除已合并分支
Pull Request 工作流 —— 团队协作的核心
- 在分支上开发 → push 分支 → 在 GitHub 网页发 PR → 别人 review → merge
.gitkeep —— 让 Git 追踪空文件夹的小技巧
- Git 不追踪空文件夹，在里面放一个 .gitkeep 空文件即可
git stash —— 临时存放未提交的改动
- git stash 暂存当前改动并清空工作区
- git stash pop 恢复刚暂存的改动
- 适合：要紧急切分支修 bug 但当前改动还没改完
git rebase —— 整理提交历史（进阶但很有用）
- git rebase -i HEAD~3 交互式合并/修改最近 3 次提交
- 让历史看起来更线性、清晰
.gitattributes —— 比 .gitignore 更细致的属性控制
GitHub 工作流进阶：
- Issues 和 Projects 管理任务
- GitHub Actions 自动化 CI/CD
- Releases 发布版本

一页纸总结（贴墙上）#

1
┌──────────────────────────────────────────────────────────────┐
2
│                    Git 日常工作流                              │
3
├──────────────────────────────────────────────────────────────┤
4
│                                                              │
5
│   改代码  →  git add .  →  git commit -m "..."  →  git push  │
6
│                                                              │
7
├──────────────────────────────────────────────────────────────┤
8
│  查看：  git status  /  git log --oneline  /  git diff       │
9
│  撤销：  git restore <文件>  /  git restore --staged <文件>   │
10
│  拉取：  git pull                                             │
11
└──────────────────────────────────────────────────────────────┘
12

13
提交说明格式：<类型>(<范围>): <简述>
14
  feat   新功能       refactor  重构
15
  fix    修 bug       chore     杂项
16
  docs   文档         perf      性能优化
17
  style  格式         test      测试

本教程基于 2026-05-04 推送 double_car 项目到 GitHub 的真实记录整理。

风过无痕