GitCode 使用指南
本文将详细介绍如何在 GitCode 平台上练习和使用 Git 命令,帮助你快速掌握代码管理的基本流程。以及在平台上找到鸿蒙,仓颉等项目参与共建。
第一步:注册账号与配置 SSH 密钥
在使用 GitCode 进行代码管理前,需要完成账号注册和 SSH 密钥配置,这是确保代码安全传输的重要步骤。
1. 注册 GitCode 账号
- 打开浏览器,访问 GitCode 官网
- 点击页面上的 "注册" 按钮,按提示填写用户名、密码及手机号码等信息完成注册
2. 生成 SSH 密钥对
SSH 密钥对由公钥(可公开)和私钥(需保密)组成,用于本地与 GitCode 服务器的安全认证。
在终端中执行以下命令生成密钥对:
css
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
将 your_email@example.com
替换为你的邮箱地址(例如:jianguo@nutpi.net),便于识别密钥用途。按提示操作,可设置密钥存储路径和密码(建议使用默认路径)。
3. 添加公钥到 GitCode 账户
- 生成成功后,在
~/.ssh
目录下会生成id_rsa
(私钥)和id_rsa.pub
(公钥)两个文件 - 打开
id_rsa.pub
文件,复制其中的全部内容 - 登录 GitCode 后,进入"个人设置"页面,找到 "SSH 公钥" 设置项
- 点击 "添加 SSH 公钥",粘贴公钥内容,填写描述信息(如 "家里"),点击 "保存"

4. 验证 SSH 密钥配置
配置完成后,在终端执行以下命令验证是否成功:
css
ssh -T git@gitcode.com
若看到 "Welcome to GitCode" 相关提示,说明配置成功。如遇 "Permission denied (publickey)" 错误,需检查公钥是否正确添加,必要时可重新生成并添加密钥。
通过 SSH 密钥认证,既能提高代码传输的安全性,又能避免每次操作都输入密码,提升使用便捷性。
第二步:创建新仓库
完成账号设置后,即可创建第一个代码仓库来托管你的项目。
1. 登录 GitCode 账号
访问 GitCode 官网,输入账号信息登录。
2. 进入新建项目页面
点击顶部导航栏的 "+" 号或相关按钮,选择"新建项目"选项。
3. 选择项目所属组织
- 在项目创建界面,选择项目路径时,建议将测试项目放在 "坚果派" 组织下
- 点击选择"坚果派"组织,便于集中管理测试项目

4. 填写仓库基本信息
- 项目名称:输入简洁明了的名称(如 "测试仓库" 或 "学习项目")
- 项目路径:将成为仓库的唯一访问地址,不可重复
- 仓库描述:简要说明仓库用途,方便他人理解
- 可见性:选择 "公开"(任何人可访问)或 "私有"(仅授权用户可访问)
填写完成后,点击 "创建项目" 按钮,系统将在几秒内完成仓库创建。
5. 验证仓库创建
- 访问"坚果派组织的项目页面",可看到新创建的仓库
- 点击仓库名称进入主页,可查看文件、提交历史等信息
- 点击 "Clone" 按钮,获取仓库的克隆地址(推荐使用 SSH 方式)
6. 克隆仓库到本地
在本地终端中执行以下命令,将远程仓库克隆到本地:
bash
git clone git@gitcode.com:nutpi/your-demo-repo.git
请将 git@gitcode.com:nutpi/your-demo-repo.git
替换为你的仓库实际 SSH 地址。
完成以上步骤后,你就可以在本地进行代码开发,并通过 Git 命令与远程仓库同步了。
第三步:推送与拉取代码
掌握代码的推送(push)和拉取(pull)操作,是实现本地与远程仓库同步的核心技能。
推送本地代码到 GitCode
-
在本地进行代码修改
- 使用编辑器在本地仓库目录中编写或修改代码
- 完成后保存更改
-
将更改添加到暂存区 打开终端,进入仓库目录,执行以下命令:
csharpgit add .
其中
.
表示添加当前目录下的所有更改文件。如需添加特定文件,可替换为文件名:csharpgit add filename.txt
-
提交更改到本地仓库 使用
git commit
命令提交,并添加清晰的提交信息:sqlgit commit -m "描述你的更改内容,如:添加用户登录功能"
-
推送到远程仓库 执行以下命令将本地提交推送到 GitCode:
cssgit push origin main
其中
origin
是远程仓库的默认名称,main
是分支名称,如需推送到其他分支(如develop
),请替换相应名称。 -
处理推送冲突 若推送时出现冲突,需先拉取远程最新代码并解决冲突:
cssgit pull --rebase origin main
解决冲突后,重新执行
git add .
、git commit
和git push
命令。
从 GitCode 拉取代码到本地
-
拉取最新代码 在终端进入仓库目录,执行以下命令获取远程最新更改:
cssgit pull origin main
-
处理合并冲突 若拉取时出现冲突,Git 会标记冲突文件。打开这些文件,找到冲突标记(
<<<<<<<
、=======
、>>>>>>>
),手动编辑保留需要的代码,删除冲突标记。 -
提交冲突解决方案 解决冲突后,提交更改:
sqlgit add . git commit -m "解决合并冲突"
-
推送解决后的代码
cssgit push origin main
-
保持代码同步建议 定期执行
git pull
命令,可减少冲突发生的概率,尤其在团队协作时更为重要。
通过以上操作,你可以高效地管理代码变更,确保本地与远程仓库保持同步。
第四步:探索 GitCode 高级功能
GitCode 不仅是代码托管平台,更是一个促进技术交流与协作的社区,提供了丰富的功能帮助开发者提升效率:
- 代码发布与分享:创建仓库并提交代码后,可通过分享链接让他人访问你的项目
- 社区讨论:参与代码相关的问题讨论,获取反馈,了解开源组织动态
- 协作开发:通过 Pull Request 向其他项目贡献代码,参与团队协作
- 学习资源:搜索感兴趣的项目,查看源代码和文档,学习他人的开发经验
更多功能详情请参考官方文档:docs.gitcode.com/docs/。
GitCode 致力于为国内开发者提供高效、便捷的代码管理与交流平台,助力开发者成长与技术创新。