2. Git环境搭建：在Windows/Linux下安装Git，配置用户信息与SSH密钥，连接远程仓库

说实话，很多嵌入式工程师对Git的态度是「能用就行」。我以前也这么想，直到有一次项目组三个人同时改了同一个头文件，结果合并时乱成一锅粥，最后不得不手动比对了一整天代码。嗯，从那以后我彻底老实了。

这一节，咱们就把Git环境彻底搞定。不管是Windows还是Linux，我带你一步步走通。

2.1 在Windows下安装Git

Windows下的安装其实很简单。去Git官网下载安装包，双击运行就行。但我个人习惯在安装时注意几个关键选项：

• 选择默认编辑器：我建议选VSCode或者Notepad++，别用Vim（除非你真的很熟）
• 调整PATH环境变量：选「Git from the command line and also from 3rd-party software」
• 换行符转换：选「Checkout Windows-style, commit Unix-style line endings」——这个对嵌入式跨平台开发特别重要

安装完成后，打开CMD或PowerShell，输入 git --version 验证一下。看到版本号就说明装好了。

2.2 在Linux下安装Git

Linux下就更快了。我常用的几个发行版命令：

# Ubuntu/Debian
sudo apt update
sudo apt install git

# CentOS/RHEL/Fedora
sudo yum install git
# 或者
sudo dnf install git

# 验证安装
git --version

你可能会问：「为什么不用源码编译安装？」其实没必要。包管理器里的版本足够稳定，除非你要尝鲜最新特性。我在项目中一直用系统自带的版本，从来没出过问题。

2.3 配置用户信息

装好Git后，第一件事就是配置用户名和邮箱。这个信息会嵌入到每次提交中，说白了就是你的「代码签名」。

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

这里有个坑——一定要用真实的邮箱。我曾经见过有人用「test@test.com」提交代码，结果后来想联系他改bug，根本找不到人。你想想看，这多尴尬。

查看配置是否生效：

git config --global --list

2.4 配置SSH密钥

为什么要用SSH？说白了就是为了安全又方便。每次推送代码不用输密码，而且通信是加密的。我在项目中一直用SSH方式连接远程仓库，从来没换过。

生成密钥的步骤：

# 生成RSA密钥对（推荐4096位）
ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"

执行后，系统会问你保存位置和密码短语（passphrase）。我个人习惯：

• 保存位置：默认路径 ~/.ssh/id_rsa，直接回车
• 密码短语：建议设置一个，但别太复杂。我设了个简单短语，防止密钥文件被盗用

生成完成后，你会看到两个文件：

文件名	用途	注意事项
id_rsa	私钥，自己留着	绝对不能泄露，谁拿到谁就能冒充你
id_rsa.pub	公钥，可以公开	需要添加到远程仓库平台

查看公钥内容：

cat ~/.ssh/id_rsa.pub

复制输出的全部内容，准备添加到远程仓库。

2.5 连接远程仓库

以GitHub为例，把公钥添加进去：

1. 登录GitHub，点右上角头像 → Settings
2. 左侧找到「SSH and GPG keys」
3. 点「New SSH key」，标题随便写（比如「我的笔记本」）
4. 把公钥粘贴到Key文本框里，点保存

验证连接是否成功：

ssh -T git@github.com

如果看到类似 Hi xxx! You've successfully authenticated... 的提示，就说明搞定了。

2.6 克隆远程仓库到本地

连接成功后，就可以拉取代码了：

# 用SSH方式克隆（推荐）
git clone git@github.com:用户名/仓库名.git

# 或者用HTTPS方式（不推荐，每次要输密码）
git clone https://github.com/用户名/仓库名.git

我个人强烈建议用SSH方式。你想想看，每次推送都要输用户名密码，多影响效率。而且嵌入式项目经常要频繁提交测试，输密码的时间都够编译一次了。

2.7 验证环境是否就绪

最后，跑一遍这个命令，确认所有配置都正确：

# 查看全局配置
git config --global --list

# 查看SSH密钥是否加载
ssh-add -l

# 测试远程连接
ssh -T git@github.com

如果三条命令都正常输出，恭喜你，Git环境搭建完成。接下来就可以正式开始版本管理了。