OpenHarmony开发者专属：Windows Git安装配置全流程避坑手册
如果你正准备踏入OpenHarmony开源生态，却在Windows上配置Git环境时被各种选项搞得晕头转向——该选哪个SSH后端？行尾格式怎么设置？为什么我的分支名和社区规范不一致？别担心，这份指南就是为你量身定制的。我们将从OpenHarmony社区协作的实际需求出发，帮你避开那些新手常踩的"雷区"。
1. 为什么OpenHarmony开发者需要特别关注Git配置？
大多数通用Git教程只会告诉你"下一步该点哪里"，却不会解释每个选项对开源协作的影响。而OpenHarmony作为大型开源项目，对代码提交、分支管理有着严格的规范要求。一个不当的安装选项可能导致后续出现：
- 分支命名冲突（master vs main）
- 行尾符混乱（CRLF vs LF）
- 证书验证失败
- LFS大文件支持异常
去年就有开发者因为安装时勾选了开源版git-lfs，导致后续无法正常同步华为提供的组件库，不得不重装整个环境。类似的"血泪史"告诉我们：初始安装的每个选项都值得认真对待。
2. 安装前的关键准备工作
2.1 获取正确的安装包
访问Git官网下载页面时，你会看到多个版本选项。对于OpenHarmony开发，请确保选择：
# 推荐版本（截至2023年10月） Git-2.41.0-64-bit.exe为什么不是最新版？某些实验性功能可能与OpenHarmony工具链存在兼容性问题。2.41.x版本经过社区广泛验证，稳定性最佳。
2.2 组件选择：这些选项必须谨慎对待
安装过程中最易出错的环节就是组件选择。参考OpenHarmony官方推荐配置，建议采用以下方案：
| 组件选项 | 推荐操作 | 原因说明 |
|---|---|---|
| Git Bash Here | ✔️ 必选 | OpenHarmony编译脚本依赖Bash环境 |
| Git GUI Here | ❌ 可选 | 纯命令行操作更符合开发者习惯 |
| Git LFS | ❌ 必须取消 | 使用华为提供的定制版本而非开源版 |
| 每日更新检查 | ❌ 建议取消 | 避免自动更新导致环境变化 |
重要提示：千万不要勾选"Add a Git Bash Profile to Windows Terminal"，这会导致终端环境变量与OpenHarmony编译工具冲突。
3. 影响深远的配置选项解析
3.1 分支命名规范：main还是master？
在"Initial branch name"设置界面，你会看到两个选项：
Let Git decide
- 新建仓库默认分支：master
- 问题：与OpenHarmony社区的main分支规范不符
Override the default branch name
- 建议填写：main
- 优势：与开源社区标准一致，减少后续 rebase 操作
# 安装后验证分支配置 git config --global init.defaultBranch # 正确应返回：main3.2 行尾符设置：跨平台协作的关键
Windows和Unix系统对换行符的处理差异，曾是无数开发者的噩梦。对于参与OpenHarmony这种跨平台项目的开发者，正确的选择是：
- 勾选"Checkout as-is, commit Unix-style line endings"
- 配置解释：
- 本地检出：保留原始行尾（兼容Windows编辑器）
- 代码提交：统一转换为LF（符合Linux规范）
实际案例：某开发者使用默认配置提交代码后，导致编译脚本因CRLF报错，团队花了3天排查才发现是行尾符问题。
4. 高级配置：为OpenHarmony优化的环境设置
4.1 SSH连接优化配置
虽然安装程序默认使用bundled OpenSSH，但对于国内开发者，建议额外配置：
# 在Git Bash中执行： cat >> ~/.ssh/config <<EOF Host gitee.com HostName gitee.com User git PreferredAuthentications publickey IdentityFile ~/.ssh/openharmony_rsa EOF4.2 凭证管理策略
避免每次push都输入密码的正确姿势：
- 安装时选择"Git Credential Manager"
- 后续首次操作时会自动弹出凭证存储界面
- 建议选择"永久存储"选项
# 验证凭证是否生效 git push origin main # 首次需要输入账号密码，后续不再提示5. 安装后必须的验证步骤
完成安装后，不要急着开始coding，先运行这套检查清单：
版本验证：
git --version # 应显示：git version 2.41.0.windows.1配置检查：
git config --list | grep -E "core.autocrlf|init.defaultbranch" # 正确输出应包含： # core.autocrlf=input # init.defaultbranch=mainSSH连通性测试：
ssh -T git@gitee.com # 成功时会显示你的Gitee用户名代理设置（如需要）：
# 如有网络访问限制，需配置： git config --global http.proxy http://proxy.example.com:8080
6. 常见问题现场救援
Q：已经安装错了配置怎么办？
A：无需重装，多数设置可通过命令修改：
# 修正分支默认名 git config --global init.defaultBranch main # 更改行尾处理方式 git config --global core.autocrlf inputQ：误装了开源版git-lfs如何补救？
A：执行以下清理步骤：
# 卸载现有LFS git lfs uninstall # 安装华为提供版本 curl -O https://repo.huaweicloud.com/openharmony/tools/git-lfs/2.13.3/git-lfs.exe mv git-lfs.exe /mingw64/bin/Q：Git Bash中文显示乱码？
A：右键窗口标题 → Options → Text → 字符集选择"UTF-8"
