IDE 里配置基于 AtomGit(GitCode)的 Git
DevEco Studio 配置基于 AtomGit(GitCode)的 Git
引言 :一站式搞定 IDE 与代码托管
还在 DevEco Studio 和 Git 命令行之间反复切换,为推送代码到 AtomGit(GitCode)而手忙脚乱吗?本教程将为你提供一份清晰、无痛的图形化配置指南,让你在几分钟内就在 DevEco Studio 中无缝集成 AtomGit,实现代码的版本控制、提交与推送,彻底告别繁琐的终端命令。
你将学会:
- 两种主流配置路径:无论你是首次配置,还是为已有项目连接新仓库。
- 图形界面全流程操作:从仓库关联、提交、推拉到分支管理,全程鼠标点击即可完成。
- 常见问题即时排错:针对推送失败、分支冲突等典型问题,提供明确的解决方案。
在开始前,请准备好:
- 安装好的 DevEco Studio(建议使用较新版本)。
- 一个有效的 AtomGit(GitCode)账户,并已创建一个用于测试的远程仓库。
- 稳定的网络连接。
教程路径图(预计耗时:15 分钟):
- 环境配置:在 DevEco Studio 中正确设置 Git 路径与全局账户。
- 连接远程仓库:将你的项目与 AtomGit 上的仓库关联。
- 初始化和推送:分别掌握“全新项目”和“已有项目”的首次推送方法。
- 日常图形化操作:使用 IDE 内置的 Git 工具进行日常提交、拉取和查看历史。
- 进阶与排错:了解常用命令、分支策略和常见问题解决方法。
让我们一起开始,让你的鸿蒙项目开发流程变得更加高效和专业。
1.在 DevEco Studio 配置
1.1.方式一
启动 EevEco Studio,Windows/Linux: File → Settings,Version Control → Git,点击 ... 选择 Git 安装路径(通常自动检测),点击 Test 测试连接,显示 Git 版本


配置 AtomGit(GitCode)账户,仓库
菜单栏,git,Manage Remotes...,添加远程仓库地址,登录 AtomGit 账号

因为之前通过 Git Bash 配置过,可以直接使用下图的 Use credentials helper,使用 Git 凭据管理器。

1.2.方式二
启用版本控制,选择 Git


配置 AtomGit(GitCode)账户,仓库
菜单栏,git,Manage Remotes...,添加远程仓库地址,登录 AtomGit 账号


2.推送配置
仓库当前状态

2.1.全新项目推送设置
必须先初始化设置,要不然就会如下图所示


2.1.1 项目 Git 初始化
打开项目根目录



配置好个人信息
git config --global user.name CYXue
git config --global user.email 1234567890@qq.com

新项目配置
# 在项目根目录执行
git init
git add .
git commit -m "Initial commit"

等待配置完成,重新推送项目如下

因为远程仓库已有其他的推送,所以分支命名冲突了,修改了分支,所以下图提示分支名不一样,全新项目没有这个问题


2.2.已有项目重新配置推送
配置好后可直接推送

修改远程仓库为 text


结果对比



3.常用 Git 操作
3.1. 基础命令
# 查看状态
git status# 添加文件
git add <文件名>
git add . # 添加所有# 提交
git commit -m "提交说明"# 推送
git push origin master/main# 拉取
git pull origin master/main
3.2. 分支管理
# 创建分支
git branch <分支名>
git checkout -b <分支名> # 创建并切换# 合并分支
git merge <分支名>
4.DevEco Studio 图形界面操作
4.1. 提交代码
- 点击底部面板
Version Control →Commit - 或者菜单栏
Git →Commit - 选择文件,输入提交信息
4.2. 推送/拉取
- 工具栏
Git →Push /Pull
4.3. 查看历史
- 右键项目 →
Git →Show History
5.常见问题解决
5.1. Git 无法识别
- 检查 Git 安装路径是否正确
- 重启 DevEco Studio
5.2. 推送失败
# 先拉取最新代码
git pull origin master --rebase# 强制推送(谨慎使用)
git push -f origin master
5.3. SSH 连接问题
# 测试SSH连接
ssh -T git@github.com
ssh -T git@gitee.com
6.最佳实践建议
6.1.分支策略
-
master/main: 主分支 -
develop: 开发分支 -
feature/*: 功能分支
6.2.提交规范
- 使用有意义的提交信息
- 频繁提交,每次一个完整功能
6.3.同步频率
- 每天开始前
pull - 完成功能后
push
6.4.配置文件
- 将项目配置共享到仓库
- 忽略个人和编译文件
7.可视化工具推荐
- Git Lens(VSCode 插件)
- SourceTree(桌面客户端)
- GitKraken(跨平台工具)
配置完成后,你可以在 DevEco Studio 的右下角看到 Git 分支信息,开始版本控制你的鸿蒙项目。