1. STM32项目Git管理入门指南
作为一名从事嵌入式开发多年的工程师,我深知版本控制对于STM32项目的重要性。刚开始接触Git时,我也曾因为不熟悉操作流程而丢失过代码。本文将分享我在STM32项目中实践Git管理的完整经验,特别适合刚入门的嵌入式开发者。
Git作为分布式版本控制系统,能完美解决STM32开发中的三大痛点:代码版本混乱、团队协作困难、历史修改难以追溯。通过本教程,你将掌握从零开始建立Git仓库、配置STM32专属忽略规则、处理常见错误的全套方法。不同于通用Git教程,我会重点讲解嵌入式开发特有的注意事项。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础环境搭建
2.1 Git安装与基础配置
首先需要安装Git for Windows(包含Git Bash工具链)。建议从官网下载最新稳定版,安装时注意勾选"Use Git and optional Unix tools from the Command Prompt"选项,这样可以在普通CMD中使用Git命令。
安装完成后,在任意目录右键选择"Git Bash Here"打开终端,执行以下基础配置:
bash复制git config --global user.name "YourName"
git config --global user.email "your.email@example.com"
git config --global core.autocrlf false # 避免Windows换行符问题
git config --global core.ignorecase false # 确保文件名大小写敏感
特别注意:STM32项目中的头文件路径对大小写敏感,必须设置
ignorecase为false
2.2 GitHub仓库创建
在GitHub创建仓库时,嵌入式项目有特殊注意事项:
- 仓库名建议采用
stm32-<项目名称>的格式 - 必须取消勾选"Initialize this repository with a README"
- License建议选择MIT或Apache-2.0
- 创建后立即进入"Settings→Branches",将默认分支改名为
main
3. STM32专属Git配置
3.1 .gitignore深度配置
STM32项目会产生大量中间文件,必须精心配置.gitignore。以下是经过多个项目验证的优化配置:
gitignore复制# Keil MDK生成文件
*.uvproj*
*.uvopt*
*.axf
*.crf
*.d
*.o
*.lst
*.map
*.lnp
*.dep
*.iex
*.htm
*.sct
*.bak
# IAR生成文件
*.ewp
*.eww
*.ewd
*.dep
*.ewt
*.lst
*.map
*.out
# CubeMX生成文件
/.mxproject
/.cproject
/.project
# 调试文件
*.elf
*.bin
*.hex
*.srec
# VSCode相关
.vscode/
*.code-workspace
# 系统文件
.DS_Store
Thumbs.db
3.2 仓库初始化最佳实践
在STM32CubeMX生成的项目基础上初始化Git仓库时,建议按以下流程操作:
bash复制# 1. 进入CubeMX生成的项目目录
cd path/to/stm32-project
# 2. 初始化仓库
git init
# 3. 创建.gitignore
touch .gitignore
# 将上述内容写入.gitignore
# 4. 分阶段添加文件(避免误加生成文件)
git add Drivers/ C
