Git 闯关手记从 GitHub 登录到烧录回主分支IDE 用户避坑指南本文记录我在用 VSCode / IDE 做嵌入式项目时从零接触 Git、GitHub 到版本切换、烧录的完整踩坑过程。按「场景 → 原因 → 解法」整理方便同样用 IDE 的同学对照。一句话概括从GitHub 登录与上传起步搞懂仓库根目录、.git、文件颜色状态、提交与 Vim再到签出 / 分支 / 回退提交最后补上IDE 显示延迟和切回main前要先git restore的嵌入式工作流——核心是把 Git 的「文件状态」和编辑器的「界面显示」分开理解。目录Git 闯关手记从 GitHub 登录到烧录回主分支IDE 用户避坑指南一句话概括一、入门与仓库结构二、VSCode 里的「绿色」不等于报错三、提交与 Vim高频卡点四、签出、分支与回到历史版本五、IDE 延迟VSCode 变了别的 IDE 没变六、嵌入式烧录切版本后如何回到 main七、自己总结的仅供参考八、完整问题对照表速查写在最后一、入门与仓库结构场景遇到的问题本质原因解决思路GitHub 登录登不进去提示需要验证GitHub 开启了双重验证 2FA用腾讯身份验证器完成登录验证GitHub 上传代码不知道怎么把代码传到 GitHub不熟悉网页上传和命令行上传的区别网页端可Add file命令行git add→git commit→git push新建code文件夹想把项目放进统一的代码文件夹本地文件夹和 Git 仓库路径关系不清楚有.git的目录才是 Git 仓库去掉 Git 仓库想把某文件夹里的 Git 去掉存在隐藏的.git文件夹删除.git后该目录不再受 Git 管理二、VSCode 里的「绿色」不等于报错场景遇到的问题本质原因解决思路VSCode 文件变绿文件全部变成绿色Git 认为是「新文件 / 未跟踪文件」绿色不是错误只是 Git 状态提示已提交但还是绿色已经 commit界面仍发绿打开的目录不是仓库根或状态未刷新在正确的项目根目录打开 VSCode必要时刷新打开路径问题不是在code里打开 VSCodeVSCode 识别的 Git 范围与打开文件夹有关直接打开 Git 仓库根目录三、提交与 Vim高频卡点场景遇到的问题本质原因解决思路提交时进入 Vimgit commit突然进入黑色编辑界面Git 默认用 Vim 写提交说明按i编辑 →Esc→ 输入:wq保存退出Vim 中误操作按了d后界面变化不知道怎么办Vim 是模式编辑器按键不是普通输入不熟 Vim 时用git commit -m 提交说明Claude Code 提示不知道提示是否代表编译失败工具提示和 Git 状态容易混在一起很多提示只是「是否执行 / 是否改文件」不一定代表编译错误推荐日常提交直接用-m少进 Vimgit commit -m 修复某某问题四、签出、分支与回到历史版本场景遇到的问题本质原因解决思路点击「签出」更改不能保存 / 状态变了Checkout 会切换工作区到某分支或某次提交签出不是普通打开文件是切换版本状态想回到某次提交想回到某次提交且不要后面改动需区分「临时查看」和「彻底回退」临时git checkout commit彻底git reset --hard commit慎用回到 initial commit想回到最初状态烧录试一下往往只需临时用旧版本checkout 到 initial commit烧完再切回main回到 main 后代码没回来切回main后 IDE 里函数没显示IDE / VSCode 缓存或索引未刷新磁盘上已恢复刷新 IDE 后显示会跟上分支理解不太理解 branch分支概念比较抽象可理解为游戏支线在某次提交上继续改不挡主干checkout 和 switch不清楚两者区别老命令与新命令功能重叠switch偏切分支checkout还能切某次提交 / 单文件状态嵌入式 checkout 后能否烧录担心旧版本能不能编译烧录旧提交是否包含完整工程与配置旧提交里工程文件完整即可编译、烧录分支类比main是主线任务branch是在某次存档commit上开的支线改坏了也不一定要毁主线。命令对照# 临时查看某次提交看完后切回 main git checkout commit-hash git switch main # 专用于切分支更直观 git switch main git switch 某分支名五、IDE 延迟VSCode 变了别的 IDE 没变我主要用 IDE 做嵌入式。当 checkout 到某次历史提交时VSCode里的文件已经变了另一套 IDE里看起来还是旧的。这不是 Git 坏了而是IDE 索引 / 缓存有延迟需要手动刷新或重新打开工程。文件夹里的内容其实已经对上了。这里明显缺少了spwm文件refresh一下就好了六、嵌入式烧录切版本后如何回到main弄清 IDE 延迟之后我总结了一套切换版本再回主分支的流程先签出到目标提交例如 initial commit编译、烧录验证烧录往往会重新编译生成Debug等目录里的文件Git 会认为工作区被修改不能直接git switch main先丢弃这些编译产物带来的改动再切回主分支git restore Debug/ git switch main若还有其他被改动的路径可对应用git restore 路径或git status查看后再处理。七、自己总结的仅供参考看颜色 → 想 Git 状态别想成编译报错 开文件夹 → 对准含 .git 的仓库根 写提交 → 不熟 Vim 就用 git commit -m 说明 玩历史 → 临时看用 checkout真删历史用 reset --hard慎用 切分支 → 先清编译产物改动restore再 switch main 对不上 → 先信磁盘里的文件再刷新 IDE八、完整问题对照表速查时间/场景遇到的问题本质原因解决思路GitHub 登录登不进去要验证2FA身份验证器完成验证GitHub 上传不知道怎么传不熟悉两种上传方式网页 Add file 或 add/commit/push新建 code 文件夹想统一放项目不懂仓库路径含.git即仓库去掉 Git 仓库想去掉 Git有隐藏.git删除.gitVSCode 变绿文件全绿未跟踪文件绿色是状态不是错提交后仍绿已 commit 还绿根目录错或未刷新开对根目录并刷新打开路径没在 code 里开识别范围与打开目录有关开仓库根目录git commit 进 Vim黑屏编辑器默认 Vimi/Esc/:wq或-mVim 误按 d界面乱了模式编辑用commit -mClaude Code 提示不知是否编译错提示与 Git 混在一起分清是确认执行还是 Git 状态点签出不能保存checkout 换版本状态签出切版本不是普通打开回到某次提交不要后面改动临时 vs 彻底回退checkout 或 reset --hardinitial commit 烧录想试最初代码只需临时checkout 后烧完切回 main回 main 函数不见IDE 没显示缓存未刷新刷新 IDEbranch不懂分支概念抽象支线任务类比checkout vs switch分不清命令重叠switch 切分支checkout 更泛checkout 后烧录能否运行旧工程是否完整提交完整即可编烧IDE 不同步VSCode 变 IDE 不变IDE 延迟刷新 / 重开工程回 main 被拦switch 失败Debug 等被改git restore Debug/再 switch写在最后Git 和 IDE 是两套系统Git 管磁盘上的版本IDE 管你看到的界面。绿色、签出、回 main 被拦多半是在对齐这两层嵌入式再加一层「编译 / 烧录会改 Debug 目录」回主分支前记得restore。如果你也是 IDE 嵌入式 刚学 Git希望这份手记能少踩几个坑。欢迎评论区补充你遇到的情况。
