在嵌入式项目迭代中，代码版本混乱、多人修改冲突、或者因为改错一个宏定义导致固件跑飞——这些场景基本每周都会遇到。
相比纯软件项目，嵌入式开发涉及交叉编译环境、硬件依赖以及大量的本地配置，一旦代码管理不规范，复现Bug和版本回退的成本极高。
Git 是目前最常用的版本管理工具，但很多新手（甚至部分老手）在面对复杂的回滚需求或冲突处理时，往往因为记混参数导致误删代码。
本文基于灵眸科技研发日常工作整理，剔除不常用的冷门指令，只保留我们在日常开发板调试中最常用到的核心命令和异常处理逻辑。
PART.01——模型部署与性能实测
在开始敲命令前，必须先理解Git的工作逻辑。很多新手觉得Git难，是因为没搞懂文件在这三个区域间的流转。
为了让读者更直观地理解，我们将其类比为“工程师的书桌工作流”：
- 工作区 (Workspace)：你的书桌
就是你电脑里的项目文件夹（如 Lingmou_SDK）。在这里写代码、改配置，就像在书桌上摊开图纸和零件。
- 暂存区 (Staging Area)：书桌旁的篮子
改完一个模块后，先把文件放进篮子。这是一个缓冲地带，用于检查本次提交的内容是否精准，避免误提交临时日志或编译垃圾。
- 仓库 (Repository)：储物柜（本地+远程）
确认无误后，将篮子里的东西归档进储物柜。本地仓库在你电脑，远程仓库（如Gitee/GitHub）则在云端，是我们灵眸科技团队跨地域协作、备份核心代码资产的地方。
PART.02——核心命令速查表：从入门到精通
我们按使用场景分类，剔除了晦涩的冷门参数，留下最实用的“干货”。
1. 基础配置与环境初始化
2. 提交与差异对比
3. 版本回滚与撤销（救命指令）
4. 远程协作与分支管理
5. 临时存储与清理
PART.03——避坑指南：灵眸工程师的5个实战锦囊
在论坛的日常维护中，我们发现以下问题出现频率极高：
- 配置身份报错：Please tell me who you are
这是新手第一课。首次安装Git需配置用户信息，否则无法提交。
git config --global user.name "你的用户名" git config --global user.email "你的邮箱@xxx.com"- 推送失败：fatal: could not read Username...
通常是HTTPS地址复制错误或凭证缓存失效。建议检查远程地址，或在终端重新登录。
git remote set-url origin <新地址>- 提交备注写错怎么改？
仅限修改最后一次提交，切勿修改历史提交（会打乱协作记录）。
git commit --amend- 误加文件到暂存区？
只要还没提交就是有救的。
# 撤销单个文件# 撤销单个文件 git reset <文件名> # 撤销所有暂存 git reset- 分支名写错？
若未推送到远程，直接重命名；若已推送，需删除远程旧分支再建新分支。
git branch -m old_name new_name git push origin --delete old_name git push origin new_name写在最后
总结下来，Git 操作有几个容易翻车的点：
一是 reset --hard， 只要敲下去，工作区和暂存区的修改直接清零，所以在按回车之前一定要确认当前状态；
二是 commit --amend， 只能修改最后一次提交，千万不要试图用它去修改已经推送到远程的历史记录，否则会导致团队成员的代码基准不一致；
三是分支管理， 在嵌入式开发中，我们经常需要维护多个硬件版本的并行分支，合并前务必确认当前所在的分支，避免把开发中的实验性代码合进了主分支。
本文中的命令均经过灵眸科技工程师开发环境长期验证。社区内同系列还有开发环境搭建、视觉开发等相关笔记，均为一线工程师的实操记录。更多技术细节，欢迎前往灵眸开发者社区交流。
