1. 写在前面:为什么Day2就急着搞远程同步
如果你也是跟着React Native for OpenHarmony这条路在走,大概率Day1的流程是这样的:装环境、初始化一个RN项目、跑通Hello World、然后在模拟器或RK3568开发板上看到界面亮起来。那一刻确实挺激动,但冷静下来之后,一个很现实的问题马上摆在面前——代码全在本地,万一硬盘挂了、系统崩了、或者我想换个电脑继续写,怎么办?
我Day1结束的时候就是这个状态。项目文件夹躺在D:\RNProject\AwesomeProject里,里面一堆node_modules、build目录、各种缓存,真要备份起来又大又乱。当时我意识到,继续往下写代码之前,最该做的是先把Git工作流跑通,把项目推到远程仓库去,这样后面不管在哪台机器上都能拉下来接着写。所以Day2没有急着去研究新的RN组件或者OpenHarmony的API,而是老老实实把"本地项目与AtomGit远程同步"这条链路彻底打通。
这一篇就把Day2的完整过程记录下来,适合正在折腾React Native for OpenHarmony、同时对Git操作还不算太熟的朋友。内容不光是命令的罗列,我会把每一步为什么要这么做、踩了哪些坑、最后怎么解决的都写清楚。包括Git在Windows上的安装细节、AtomGit仓库的创建、SSH免密配置、首次推送的完整过程,以及后面平常写代码时最常用的那套提交推送节奏。
先说结论,这套流程走通之后,你的RN for OpenHarmony项目就算有了一个安全的"云端备份",而且AtomGit在国内访问速度还不错,配合Gitee或者GitHub作为双远程备份,基本上不会再有丢代码的焦虑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:Windows上装Git最容易忽略的三个细节
2.1 下载安装其实不难,难的是安装选项理解
Git的安装包从官网或者镜像站下载都很方便,Windows下就是一个.exe,一路Next就能装上。但我发现很多人在这一步会埋下隐患,主要是安装过程中的几个选项没有认真看。我自己第一次装的时候也是无脑Next,后来用着用着才意识到问题。
安装过程中有几个关键选项需要留意。第一个是"Select Components"页面,这里默认的选项够用,但有两个建议勾上:Git Bash Here和Git GUI Here,这两个会右键菜单里加入Git入口,日常使用非常方便。第二个是"Default editor"选项,默认是Vim,如果你不熟悉Vim的操作,建议直接选Notepad++或者VS Code,不然每次commit写备注的时候被困在Vim里出不来,那种感受我相信不少人都经历过。
第三个是"Adjusting your PATH environment"页面,这里建议选中间那项Git from the command line and also from 3rd-party software。这个选项会把Git加入系统PATH,之后你在任何终端窗口里都能直接敲git命令,包括VS Code自带的终端、Windows Terminal等。如果选了第一项Use Git from Git Bash only,那在CMD或者PowerShell里是找不到git命令的,很多新手卡在"无法将git项识别为cmdlet"这个报错,多半就是这个原因。
2.2 安装完先做三件事:验证版本、配用户名、配邮箱
安装完成后,打开Git Bash,依次执行下面的命令确认环境正常:
bash复制git --version
能输出类似git version 2.43.0.windows.1这样的信息就说明安装成功了。
接下来是全局配置用户信息,这一步很多人会跳过,但涉及后面提交记录里的作者信息,必须做。我见过有人不配直接提交,结果AtomGit仓库里的提交记录显示的是乱码或者一个奇怪的默认用户名。
bash复制git config --global user.name "your_name"
git config --global user.email "your_email@example.com"
这里有两个建议:user.name尽量用英文或者拼音,不要用中文,避免某些终端环境编码问题;user.email建议和你AtomGit注册邮箱保持一致,这样提交记录能更准确地关联到你的账号。
配置完了可以用下面的命令检查一下:
bash复制git config --global --list
2.3 关于换行符和提交规范,趁早定好规矩
Windows环境下还有一个容易被忽略的坑:换行符(Line Ending)。Windows用的是CRLF,而Linux和macOS用的是LF。如果不管这个差异,项目文件里一旦混入两种换行符,Git在diff的时候会提示整个文件都被修改了,非常烦人。
我建议在全局配置中明确设置core.autocrlf:
bash复制git config --global core.autocrlf true
这个设置的意思是在提交时把CRLF转换成LF,检出时再转换回CRLF。对于Windows用户来说,这是最省心的方案。如果你和团队协作,建议在项目根目录加一个.gitattributes文件来统一规范,但自己写个人项目的话,全局配置这一个就够用了
