GitCode 使用指南

随着更多人在开源的世界里受益，GitCode这样的平台也越来越扮演着更重要的角色，今天本文将详细介绍如何在 GitCode 平台上练习和使用 Git 命令，帮助你快速掌握代码管理的基本流程。希望大家能在GitCode平台找到自己喜欢的项目，能持续深耕。

第一步：注册账号与配置 SSH 密钥

在使用 GitCode 进行代码管理前，需要完成账号注册和 SSH 密钥配置，这是确保代码安全传输的重要步骤。

1. 注册 GitCode 账号

• 打开浏览器，访问 GitCode 官网[1]
• 点击页面上的 "注册" 按钮，按提示填写用户名、密码及手机号码等信息完成注册

image-20250801075612987

i

2. 生成 SSH 密钥对

SSH 密钥对由公钥（可公开）和私钥（需保密）组成，用于本地与 GitCode 服务器的安全认证。

在终端中执行以下命令生成密钥对：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

将 your_email@example.com 替换为你的邮箱地址（例如：jianguo@nutpi.net），便于识别密钥用途。按提示操作，可设置密钥存储路径和密码（建议使用默认路径）。

然后三次回车即可生成 ssh key，

查看你的 public key，

mac

cat ~/.ssh/id_rsa.pub
# ssh-rsa AaC1yc2EAAAA....

windows

在 C:\Users\用户.ssh 目录下找到 id_rsa.pub 复制里面所有内容

image-20220719111429271

3. 添加公钥到 GitCode 账户

• 生成成功后，在 ~/.ssh 目录下会生成 id_rsa（私钥）和 id_rsa.pub（公钥）两个文件
• 打开 id_rsa.pub 文件，复制其中的全部内容
• 登录 GitCode 后，进入["个人设置"](https://gitcode.com/ ""个人设置"")页面，找到 "SSH 公钥" 设置项
• 点击 "添加 SSH 公钥"，粘贴公钥内容，填写描述信息（如 "家里"），点击 "保存"

image

image

4. 验证 SSH 密钥配置

配置完成后，在终端执行以下命令验证是否成功：

ssh -T git@gitcode.com

若看到 "Welcome to GitCode" 相关提示，说明配置成功。如遇 "Permission denied (publickey)" 错误，需检查公钥是否正确添加，必要时可重新生成并添加密钥。

通过 SSH 密钥认证，既能提高代码传输的安全性，又能避免每次操作都输入密码，提升使用便捷性。

5.修改本地的邮箱和签署邮箱一致

git config --global user.name "你的名字"
git config --global user.email "你的gitcode绑定邮箱"
git config --global  --list

比如我的：

git config --global user.name "徐建国"
git config --global user.email "jianguo@nutpi.net"
git config --global  --list

三、提交代码

第二步：创建新仓库

完成账号设置后，即可创建第一个代码仓库来托管你的项目。

1. 登录 GitCode 账号

访问 GitCode 官网[2]，输入账号信息登录。

2. 进入新建项目页面

点击顶部导航栏的 "+" 号或相关按钮，选择["新建项目"](https://gitcode.com/create?position=nav_top ""新建项目"")选项。

3. 选择项目所属组织

• 在项目创建界面，选择项目路径时，建议将测试项目放在 "坚果派" 组织下
• 点击选择["坚果派"](https://gitcode.com/nutpi ""坚果派"")组织，便于集中管理测试项目

image

image

4. 填写仓库基本信息

• 项目名称：输入简洁明了的名称（如 "测试仓库" 或 "学习项目"）
• 项目路径：将成为仓库的唯一访问地址，不可重复
• 仓库描述：简要说明仓库用途，方便他人理解
• 可见性：选择 "公开"（任何人可访问）或 "私有"（仅授权用户可访问）

填写完成后，点击 "创建项目" 按钮，系统将在几秒内完成仓库创建。

5. 验证仓库创建

• 访问["坚果派组织的项目页面"](https://gitcode.com/org/nutpi ""坚果派组织的项目页面"")，可看到新创建的仓库
• 点击仓库名称进入主页，可查看文件、提交历史等信息
• 点击 "Clone" 按钮，获取仓库的克隆地址（推荐使用 SSH 方式）

6. 克隆仓库到本地

在本地终端中执行以下命令，将远程仓库克隆到本地：

git clone git@gitcode.com:nutpi/demo.git

请将 git@gitcode.com:nutpi/demo.git 替换为你的仓库实际 SSH 地址。

完成以上步骤后，你就可以在本地进行代码开发，并通过 Git 命令与远程仓库同步了。

第三步：推送与拉取代码

掌握代码的推送（push）和拉取（pull）操作，是实现本地与远程仓库同步的核心技能。

推送本地代码到 GitCode

在本地进行代码修改

• 使用编辑器在本地仓库目录中编写或修改代码
• 完成后保存更改

将更改添加到暂存区打开终端，进入仓库目录，执行以下命令：

git add .

其中 . 表示添加当前目录下的所有更改文件。如需添加特定文件，可替换为文件名：

git add filename.txt

提交更改到本地仓库使用 git commit 命令提交，并添加清晰的提交信息：

git commit -m "描述你的更改内容，如：添加用户登录功能"

推送到远程仓库执行以下命令将本地提交推送到 GitCode：

git push origin main

其中 origin 是远程仓库的默认名称，main 是分支名称，如需推送到其他分支（如 develop），请替换相应名称。

处理推送冲突若推送时出现冲突，需先拉取远程最新代码并解决冲突：

git pull --rebase origin main

解决冲突后，重新执行 git add .、git commit 和 git push 命令。

从 GitCode 拉取代码到本地

拉取最新代码在终端进入仓库目录，执行以下命令获取远程最新更改：

git pull origin main

处理合并冲突若拉取时出现冲突，Git 会标记冲突文件。打开这些文件，找到冲突标记（<<<<<<<、=======、>>>>>>>），手动编辑保留需要的代码，删除冲突标记。

提交冲突解决方案解决冲突后，提交更改：

git add .
git commit -m "解决合并冲突"

推送解决后的代码

git push origin main

保持代码同步建议定期执行 git pull 命令，可减少冲突发生的概率，尤其在团队协作时更为重要。

通过以上操作，你可以高效地管理代码变更，确保本地与远程仓库保持同步。

第四步：探索 GitCode 高级功能

GitCode 不仅是代码托管平台，更是一个促进技术交流与协作的社区，提供了丰富的功能帮助开发者提升效率：

• 代码发布与分享：创建仓库并提交代码后，可通过分享链接让他人访问你的项目
• 社区讨论：参与代码相关的问题讨论，获取反馈，了解开源组织动态
• 协作开发：通过 Pull Request 向其他项目贡献代码，参与团队协作
• 学习资源：搜索感兴趣的项目，查看源代码和文档，学习他人的开发经验

更多功能详情请参考官方文档：https://docs.gitcode.com/docs/[3]。

GitCode 致力于为国内开发者提供高效、便捷的代码管理与交流平台，助力开发者成长与技术创新。

下一期将带大家在平台上找到鸿蒙，仓颉等项目参与共建。

本文地址：https://gitcode.com/nutpi/gitcode

参考资料

[1]

GitCode 官网: https://gitcode.com/

[2]

GitCode 官网: https://gitcode.com/

[3]

https://docs.gitcode.com/docs/: https://docs.gitcode.com/docs/