一、开发环境准备

1. 工具安装要求

   • DevEco Studio 5.0.5+（需JDK 17+环境）
   • Git 2.40+版本（支持LFS大文件管理）
   • 配置Node.js 18+与HarmonyOS 5.0 SDK

2. 初始化Git全局配置

   git config --global user.name "开发者名称"
   git config --global user.email "账号邮箱"
   git config --global init.defaultBranch main
   

二、项目创建与Git集成

1. 新建鸿蒙5工程

   • 选择Empty Ability模板
   • 配置参数示例：

   Project Name: GitDemo  
   Language: ArkTS  
   Compile SDK: HarmonyOS 5.0.5  
   Device Type: Phone + Tablet
   
   

2. 启用Git版本控制

   • 通过IDE菜单操作：VCS > Enable Version Control Integration > Git
   • 自动生成.gitignore文件（示例内容）： 

     .idea/
     build/
     *.hprof
     local.properties
     

三、基础Git操作实战

1. 提交首个功能模块

   // entry/src/main/ets/pages/LoginPage.ets
   @Entry
   @Component
   struct LoginPage {
     @State username: string = ""
     @State password: string = ""
   
     build() {
       Column() {
         TextInput({ placeholder: "用户名" })
           .onChange((value) => this.username = value)
         TextInput({ placeholder: "密码" })
           .type(InputType.Password)
           .onChange((value) => this.password = value)
         Button("登录")
           .onClick(() => this.handleLogin())
       }
     }
   
     private handleLogin() {
       console.log("登录请求发送")
     }
   }
   

   提交操作命令：

   git add src/main/ets/pages/LoginPage.ets
   git commit -m "feat: 实现基础登录页面"
   

2. 分支管理实践

   • 创建功能分支： 

     git checkout -b feature/news-list
     

   • 合并到主分支： 

     git checkout main
     git merge feature/news-list
     
     

四、团队协作规范

1. 远程仓库配置

   • 关联华为云代码托管平台：

   git remote add origin https://codehub.cn-north-4.myhuaweicloud.com/项目ID
   git push -u origin main
   
   

2. 冲突解决方案

   • 使用IDE的Merge Changes可视化工具
   • 关键命令： 

     git fetch origin
     git rebase origin/main
     
     

五、进阶技巧

1. HAP构建版本管理
   在build-profile.json5中配置编译参数：

   "buildOption": {
     "arkOptions": {
       "obfuscation": true,
       "branchElimination": true
     }
   }
   
   

2. 分布式开发支持
   在module.json5中添加分布式权限声明：

   "abilities": [{
     "permissions": [
       "ohos.permission.DISTRIBUTED_DATASYNC"
     ]
   }]
   
   

六、常见问题排查

1. 大文件提交失败

   • 安装Git LFS并配置追踪规则：

   git lfs track "\*.mp4"
   git add .gitattributes
   

2. 证书冲突处理

   • 清除本地缓存签名： 

     rm -rf $HOME/.deveco/keystore
     
     

学习建议：

1. 使用DevEco Studio内置的CodeGenie自动生成Git操作指令
2. 结合《ArkTS鸿蒙团队开发规范》文档实践模块化提交
3. 定期执行git gc --aggressive优化仓库性能