使用流程
0. 从远程已有仓库开始（只需一次）
场景：GitHub 上已经有仓库了，本地还没有代码。
Shell / Bash
Git 日常开发工作流与提交命名规范
Git 在日常开发中的标准工作流程，包括初始化、功能开发及合并步骤。详细阐述了分支命名规范（如 feature、fix、hotfix）和提交信息规范（遵循 Conventional Commits）。此外，还涵盖了查找历史、版本回退、文件恢复及差异对比等进阶操作，并解决了常见的 CRLF 换行符报错问题。
Git 在日常开发中的标准工作流程，包括初始化、功能开发及合并步骤。详细阐述了分支命名规范（如 feature、fix、hotfix）和提交信息规范（遵循 Conventional Commits）。此外，还涵盖了查找历史、版本回退、文件恢复及差异对比等进阶操作，并解决了常见的 CRLF 换行符报错问题。
场景：GitHub 上已经有仓库了，本地还没有代码。
| 目标 | 命令示例 | 注释 |
|---|---|---|
| 1. 克隆远程仓库 | git clone <your-repo-url> | 如：git clone https://github.com/123awsd/smart_watch.git |
| 2. 进入项目目录 | cd smart_watch | 进入刚克隆下来的项目文件夹。 |
| 3. 检查远程是否正常 | git remote -v | 确认 origin 显示正常即可。 |
| 目标 | Windows (Git Bash) 命令 | 注释 |
|---|---|---|
| 1. 终端进入项目 | cd /path/to/your/project （或右键 → Git Bash Here） | 确保终端路径正确。 |
| 2. 初始化仓库 | git init | 在当前目录创建 .git 文件夹。 |
| 3. 创建忽略文件 | touch .gitignore | 创建忽略文件。 |
4. 暂存 .gitignore | git add .gitignore | 仅暂存忽略文件。 |
| 5. 首次 Commit | git commit -m "chore: Init repository structure" | 使用 chore 类型。 |
| 6. 关联远程仓库 | git remote add origin <your-repo-url> | 绑定您的远程仓库 URL。 |
| 7. 推送主分支 | git push -u origin master | 首次使用 -u 建立跟踪关系。 |
| 步骤 | Git Bash 命令 | 关键原则与注释 |
|---|---|---|
| 1. 准备 | git checkout mastergit pull origin master | 在切分支前，确保本地 master 分支与远程同步。 |
| 2. 创建功能分支 | git checkout -b feature/temperature-sensor | 口诀： 动手前，先分支。 |
| 3. 编码与提交 | git add src/sensors/temp.cgit commit -m "feat: 添加温度传感器驱动" | 在功能分支上进行多次原子化提交。 |
| 4. 合并功能 | git checkout mastergit merge feature/temperature-sensor --no-ff -m "feat: 实现温度传感器功能 v1.1" | --no-ff 关键：保留分支历史，专业且易回溯。 |
| 5. 清理分支 | git branch -d feature/temperature-sensorgit push origin master | 口诀： 合并即删除。 |
| 6. 版本标记 (Tag) | git tag -a v1.1.0 -m "Release v1.1.0"git push origin --tags | 重要： 标记稳定版本，并推送标签到远程。 |
| 前缀 | 用途 | 示例分支名 |
|---|---|---|
feature | 新功能开发 | feature/laser-power-system |
fix | 一般 Bug 修复 | fix/oled-init-bug |
hotfix | 紧急线上 Bug | hotfix/watch-crash-on-low-battery |
refactor | 重构 | refactor/motor-control-module |
chore | 项目维护、脚手架 | chore/update-build-scripts |
experiment | 实验性质、不一定合并 | experiment/new-tracking-algorithm |
prototype | 快速 PoC / Demo | prototype/laser-gimbal-poc |
| type | 说明 | 典型场景（嵌入式） | 示例 |
|---|---|---|---|
feat | 新功能 | 新增传感器、协议、控制算法、菜单页面 | feat: add temperature sensor driver |
fix | 修 Bug | 修崩溃、逻辑错误、边界条件、初始化问题 | fix: prevent null ptr in adc init |
refactor | 重构 | 调整结构、拆分文件、提取公共函数，不改变对外行为 | refactor: extract i2c helper functions |
docs | 文档 | README、接线图说明、注释增强 | docs: add setup guide for dev board |
chore | 杂项维护 | 工程配置、依赖更新、.gitignore、重命名文件等 | chore: update keil project settings |
test | 测试 | 自检程序、单元测试、硬件回归测试 | test: add imu calibration test script |
perf | 性能优化 | 提升刷新率、减少延迟、降低功耗 | perf: reduce i2c reads in main loop |
# Keil/IAR 等工程文件 *.uvprojx binary *.uvoptx binary *.uvguix* binary # 目标文件 / 映像文件 (编译产物)
*.axf binary *.elf binary *.hex binary *.map binary # 二进制数据
*.bin binary # 编译中间文件
*.o binary *.d binary *.bak *.srec # 常见的 IDE 配置文件和日志
.vscode/ .idea/
使用图形化、简洁的方式查看提交历史，并记录您想要操作的提交的 哈希值（hash）（通常取前 7 位）。
git log --oneline --graph
📌 示例： 记录哈希值，如：
a1b2c3d
场景： 想基于旧版本重新开发，例如修复老 Bug 或进行实验性功能开发。
git checkout -b new-branch-name a1b2c3d
示例：
git checkout -b fix/old-bug a1b2c3d
场景： 某个文件被不小心改坏了，只想单独恢复它。
暂存并提交：
git add path/to/file.c
git commit -m "fix: restore file.c from a1b2c3d"
恢复文件：
git checkout a1b2c3d -- path/to/file.c
此操作会生成一个新的**'反向提交'来抵消原提交的更改。这是撤销已 push 到远程分支的提交的安全**方法。
git revert a1b2c3d
Git 会自动生成一条提交信息，类似：
Revert "<原提交信息>"
此操作会修改历史，不适用于多人协作项目。通常仅在本地分支出现无法挽救的混乱时使用。
如果远程也要一起回退（非常危险）：
git push -f origin master
本地强制回退：
git reset --hard a1b2c3d
⚠️ 风险提示：
git reset --hard+git push -f= 重写历史。请确保您了解后果，且仓库只有您自己使用，或团队已明确同意。
场景： 想确认旧版本某个文件是如何编写的，不需要恢复文件。
git show a1b2c3d:path/to/file.c
对比当前工作区与指定旧版本的差异：
git diff a1b2c3d
对比两个指定的版本：
git diff a1b2c3d b3c4d5e
LF will be replaced by CRLF the next time Git touches it
你的项目中有很多文件是 LF 换行符（Linux 格式），
但你当前的 Git 配置或 .gitattributes 规定这些文件在 checkout 时要变成 CR（Windows 格式）。因此 Git 在 add 时会提示：下次 Git 处理这些文件时，LF 将被自动替换为 CRLF。
也就是说：
\n 变成了 \r\n告诉 Git 不要自动转换换行符（最常用）
在项目根目录执行：
git config core.autocrlf false
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online