在 React Native for OpenHarmony（RN-OH）的开发实践中，我选择了 TortoiseGit 这个可视化工具来完成代码的提交与推送。相比纯命令行，它对 Git 新手更加友好，也能让整个过程更直观。下面我将完整记录这次操作的全过程，希望能帮到有同样需求的开发者。

一、前期准备

1. 本地项目与远程仓库就绪
   • 我已经在本地完成了 RN-OH 项目的开发与调试，代码可以正常运行。
   • 在 AtomGit 平台上创建了公开仓库 react-native-oh-training，并记录下了仓库的 HTTPS 地址：https://atomgit.com/creaDelight/react-native-oh-training.git。
   • 
   • 记录下这串地址，这是一会在TortoiseGit要填写的远端地址
2. 安装并配置 TortoiseGit
   • 确保已安装 TortoiseGit，并完成了基础配置（用户名、邮箱），这些信息会作为代码提交的作者信息。
   • 在本地项目根目录右键，选择 TortoiseGit → Settings，确认 Git 配置中的 user.name 和 user.email 与 AtomGit 账号信息一致。                                                                      这里对如何使用小乌龟也就是TortoiseGit不加赘述，有很多文章有相关教程。

二、本地仓库初始化

1. 在 RN-OH 项目根目录空白处右键，点击进入文件夹内，然后右键创建版本库

   

2. 在弹出的窗口中，不勾选 选项，点击 OK 完成本地仓库的创建。
3. 此时项目目录下会生成一个隐藏的 .git 文件夹，这是 Git 管理代码的核心目录。

三、添加远程仓库地址

1. 在项目根目录右键，选择 设置，在git凭证位置填入你注册的时候用的用户名和邮箱，
2. 
3. 在远端窗口中，将之前码云或者你github上面的那串复制的地址写入url以及推送url里面，先点击添加/保存，直接确定。
4. 在 “Remote” 输入框中填写 origin（这是 Git 默认的远程仓库别名），在 “URL” 输入框中粘贴 AtomGit 仓库的 HTTPS 地址。
5. 点击 OK 保存，这样本地仓库就和远程 AtomGit 仓库建立了关联。
6. 

四、第一次提交与推送

1. 添加文件到本地主分支
   • 在项目根目录右键，选择 TortoiseGit → 提交
   • 在弹出的窗口中，全部会选中所有文件，点击 OK，将所有代码文件添加到 Git 暂存区。PS：这里建议创建一个新分支，一般在团体协助中会在新分支创建自己的分支，待其他团队成员审核后才进行下一步合并到主分支，这里只有我一人就直接提交到主分支了。
   • 
   • 
2. 推送到 AtomGit 远程仓库
   • 在项目根目录右键，选择 TortoiseGit → Push。
   • 在 “Push” 窗口中，默认的远程仓库是 origin，分支是 master，保持默认设置，点击 OK。
   • 
   • 此时会弹出身份验证窗口，输入你的 AtomGit 账号和密码（或个人访问令牌），点击 OK 开始推送。
   • 等待推送完成，当窗口显示 “Success” 时，说明代码已成功上传到 AtomGit 仓库。
   • 

五、后续开发与版本管理

1. 日常开发提交
   • 后续开发中，每次完成一个功能或修复一个 bug，都可以通过 TortoiseGit → Commit 提交到本地仓库。
   • 建议遵循 Angular Commit Message 规范，比如：

     plaintext

     fix: 修复 Index.ets 中 logger 初始化问题
     docs: 更新 README 中的部署步骤
     

2. 同步远程仓库
   • 定期通过 TortoiseGit → Pull 拉取远程仓库的最新代码，避免冲突。
   • 如果需要开发新功能，建议创建新分支（TortoiseGit → Create Branch），开发完成后再合并到主分支。
   • 

六、总结与心得

小心得，只有提交到本地之后才能推送到远端，不要颠倒顺序。

通过 TortoiseGit 这个可视化工具，我无需记忆复杂的 Git 命令，就完成了从本地项目初始化到远程仓库推送的全流程。这对于 Git 新手来说非常友好，也让我能更专注于 RN-OH 项目的开发本身。

在 AtomGit 上的公开仓库，希望这篇记录能帮助更多开发者顺利完成代码的版本管理与推送。

也希望这篇文章能对正在尝试鸿蒙跨平台开发的同学有所帮助，也欢迎大家在评论区交流踩坑经验。
欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net