1. 环境准备：Windows下搭建OpenHarmony开发环境
作为一名长期从事鸿蒙生态开发的工程师，我深知环境配置是开发的第一步，也是最容易踩坑的环节。下面我将分享在Windows系统下搭建OpenHarmony开发环境的完整流程，包含这些年积累的实用技巧。
1.1 Python安装与配置
OpenHarmony的repo工具依赖Python 3环境，推荐使用3.8及以上版本。官网下载时有个细节需要注意：务必勾选"Add Python to PATH"选项，这能避免后续环境变量配置的麻烦。
安装完成后，验证是否成功：
bash复制python --version
pip --version
注意：如果系统同时存在Python 2和3，可能需要使用python3和pip3命令。建议通过
py -0命令查看已安装的Python版本。
1.2 Git环境部署
Git是代码管理的核心工具，我推荐使用Git for Windows（原msysgit），它提供了完整的Git功能和Unix工具集。安装时需要注意：
- 选择"Use Windows' default console window"以便与后续TortoiseGit配合
- 行尾转换选择"Checkout as-is, commit as-is"避免换行符问题
- 建议勾选"Enable file system caching"提升性能
安装后验证：
bash复制git --version
1.3 TortoiseGit图形化工具
虽然命令行足够强大，但TortoiseGit提供的图形界面能显著提升日常开发效率。安装时建议：
- 选择与Git相同的SSH客户端（默认为OpenSSH）
- 安装完成后右键菜单会出现Git相关选项
- 首次使用需要配置用户名和邮箱（与后续git config一致）
2. 代码托管平台准备
2.1 GitCode账号注册
OpenHarmony官方代码托管在GitCode（类似国内的GitHub）。注册时建议：
- 使用常用邮箱注册，便于后续密钥管理
- 完成邮箱验证确保账户安全
- 建议开启双重认证（2FA）
2.2 SSH密钥生成与管理
安全访问代码库的关键步骤，我推荐使用4096位RSA密钥：
bash复制ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
实际操作中的经验技巧：
- 密钥保存路径建议保持默认（~/.ssh/id_rsa）
- 密码设置可选，但团队开发强烈建议设置
- 多账号管理时，可通过
-f参数指定不同密钥文件
查看公钥内容：
bash复制cat ~/.ssh/id_rsa.pub
2.3 GitCode公钥配置
将公钥添加到GitCode的"SSH公钥"设置中：
- 标题建议包含设备标识（如"WorkPC-RSA-4096"）
- 有效期根据安全要求设置（默认永久）
- 添加后测试连接：
bash复制
ssh -T git@gitcode.com
3. 开发工具链配置
3.1 Git全局设置
这些配置会影响提交记录中的作者信息：
bash复制git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global credential.helper store # 保存认证信息
重要：公司开发建议使用工作邮箱，个人项目使用个人邮箱
3.2 Repo工具安装
Repo是Google开发的Git仓库管理工具，OpenHarmony采用其管理数百个子仓库。安装步骤：
-
创建bin目录并下载repo：
bash复制mkdir ~/bin curl https://raw.gitcode.com/gitcode-dev/repo/raw/main/repo-py3 -o ~/bin/repo chmod a+x ~/bin/repo -
添加到环境变量：
bash复制echo 'export PATH=~/bin:$PATH' >> ~/.bashrc source ~/.bashrc -
验证安装：
bash复制
repo --version
4. 代码下载实战
4.1 初始化仓库
推荐使用SSH方式（需提前配置好公钥）：
bash复制repo init -u git@gitcode.com:openharmony/manifest.git -b master --no-repo-verify
参数说明：
-u：指定manifest仓库URL-b：选择分支（master为最新开发分支）--no-repo-verify：跳过证书验证（国内网络环境建议添加）
4.2 同步代码
这个过程会下载数十GB数据，建议：
- 使用稳定的网络连接
- 避开高峰时段
- 遇到失败可重复执行：
bash复制repo sync -c -j4 # -j4表示4线程下载
4.3 LFS大文件下载
OpenHarmony使用Git LFS管理二进制文件，需要额外执行：
bash复制repo forall -c 'git lfs pull'
常见问题处理：
- 速度慢：可配置LFS代理或更换镜像源
- 空间不足：至少需要50GB可用空间
- 中断恢复：重新执行sync命令会自动续传
5. 代码结构解析
成功下载后，目录结构如下：
code复制openharmony/
├── applications # 应用层代码
├── base # 基础服务
├── build # 构建系统
├── docs # 文档
├── domains # 领域层
├── drivers # 驱动框架
├── foundation # 核心基础库
├── kernel # 内核
├── prebuilts # 预编译工具
├── test # 测试框架
├── third_party # 第三方库
└── vendor # 厂商适配
重点目录说明：
base/global：包含分布式任务调度等核心机制kernel/liteos_m：轻量级物联网内核drivers/framework：驱动开发框架
6. 开发环境验证
完成代码下载后，建议执行以下验证：
-
检查仓库状态：
bash复制
repo status -
尝试编译（需先配置编译环境）：
bash复制
./build.sh --product-name ohos-sdk -
运行简单demo：
bash复制cd applications/sample/hello_world hb build && hb flash
7. 常见问题排查
7.1 网络连接问题
症状：repo init或sync失败
解决：
- 检查代理设置（如有）
- 尝试HTTPS方式：
bash复制
repo init -u https://gitcode.com/openharmony/manifest.git
7.2 权限被拒绝
症状：SSH方式操作失败
解决：
- 确认公钥已正确添加到GitCode
- 检查SSH agent是否运行：
bash复制eval $(ssh-agent) ssh-add ~/.ssh/id_rsa
7.3 磁盘空间不足
症状：同步过程中断
解决：
- 清理临时文件：
bash复制repo forall -c 'git clean -dfx' - 扩大交换文件或使用更大容量磁盘
7.4 代码更新策略
建议每日开发前执行：
bash复制repo sync -c
repo forall -c 'git lfs pull'
git rebase # 如有本地修改
8. 效率优化技巧
-
使用
--depth=1参数减少下载量（适合只读开发）：bash复制
repo init --depth=1 -
配置repo镜像源加速同步：
bash复制
repo init -u git@gitcode.com:openharmony/manifest.git --repo-url=git@gitcode.com:gitcode-dev/repo.git -
使用ccache加速编译：
bash复制export USE_CCACHE=1 ccache -M 50G -
选择性同步（仅下载指定子系统）：
bash复制repo sync base foundation # 只同步base和foundation
经过这些年的鸿蒙开发实践，我认为环境配置的规范性直接影响后续开发效率。特别是在大型项目如OpenHarmony中，正确的代码管理方式能节省大量调试时间。建议新开发者严格按照官方推荐流程操作，遇到问题时优先查阅社区解决方案。