Gitee 国内代码托管平台使用指南

概述

本节介绍如何使用国内代码托管平台 Gitee（码云） 管理 IoT 项目，特别针对在 Trae 集成开发环境中使用 Gitee 的常见场景。学习完成后，您将能够：

注册并创建 Gitee 仓库
在 Trae 中配置 Gitee 仓库并自动执行 Git 操作
使用 git credential.helper 记住 Gitee 账号密码
在 Mac 上使用 Personal Access Token（PAT）进行认证

前置要求

在开始本节之前，请确保：

已完成 Git 版本控制基础的学习
已安装 Trae IDE
[ ]（可选）拥有一个 Gitee 账号

Gitee 平台简介

Gitee（https://gitee.com）是开源中国推出的国内代码托管平台，提供与 GitHub 类似的功能。对于国内 IoT 开发者而言，Gitee 的优势在于：

访问速度快：服务器在国内，无需翻墙
免费私有仓库：个人免费版支持私有仓库
与国内生态集成：与阿里云、腾讯云等国内云服务对接更方便
中文界面友好：全中文操作界面

在 Trae 中配置 Gitee 仓库

Trae IDE 支持标准的 Git 操作，可以通过以下步骤连接到 Gitee 仓库：

1. 在 Gitee 上创建仓库

创建完成后，会获得一个仓库地址，格式为：

https://gitee.com/你的用户名/仓库名.git

例如：

https://gitee.com/iot-project/esp32-sensor.git

2. 在 Trae 中克隆仓库到本地

在 Trae 中打开终端（Terminal），执行：

# 克隆仓库
git clone https://gitee.com/iot-project/esp32-sensor.git

# 或者在 Trae 的"源代码管理"面板中，点击"克隆仓库"，粘贴 Gitee 仓库地址

3. 让 Trae 自动执行 Git 操作

Trae 的 AI 功能（如 Trae 的 Agent 模式）可以自动执行 Git 操作，包括：

git add 暂存更改
git commit 提交代码
git push 推送代码到远程仓库
git pull 拉取远程更新

要让 Trae 能够自动执行这些操作，需要确保：

Git 已正确配置用户信息：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"

配置了 Gitee 凭证（见下文），否则 Trae 在执行 push / pull 时会因认证失败而卡住
工作目录是一个有效的 Git 仓库：Trae 的 Agent 会自动检测当前项目是否为 Git 仓库，如果不是，需要先执行 git init 或 git clone

提示：在使用 Trae 的 AI 功能时，可以直接通过自然语言指令让 Trae 执行 Git 操作，例如：

“帮我提交代码，提交信息为’添加温度传感器驱动’”

“推送到远程仓库”

“拉取最新代码”

记住 Gitee 账号密码

在使用 HTTPS 协议连接 Gitee 时，每次 push / pull 都需要输入用户名和密码。可以通过 Git 的 credential helper 机制来记住凭证：

macOS 钥匙串存储（推荐）

macOS 自带的钥匙串（Keychain）可以安全地保存 Git 凭证：

# 启用 osxkeychain 凭证助手
git config --global credential.helper osxkeychain

配置后，第一次执行 git push / git pull 时会弹出对话框要求输入 Gitee 的用户名和密码（注意：密码应填入 Gitee 的 Personal Access Token，见下文），输入确认后，凭证会被保存在 Mac 钥匙串中，后续操作不再要求输入。

验证凭证是否已保存：

# 查看钥匙串中是否已保存 Gitee 凭证
security find-internet-password -s gitee.com

持久化存储（通用方案）

如果不想使用钥匙串，也可以使用 Git 的普通凭证存储：

# 将凭证存储在磁盘上（明文存储，注意安全）
git config --global credential.helper store

执行一次 git push 输入用户名和密码后，会被保存在 ~/.git-credentials 文件中。此方式明文存储密码，仅在个人开发机上使用。

按仓库或按域名配置

可以为不同平台配置不同的凭证助手：

# 仅对 Gitee 使用凭证存储
git config --global credential.https://gitee.com.helper store
# 其他平台保持默认

Mac 上使用 Personal Access Token（PAT）进行认证

从 2022 年起，Gitee 和 GitHub 都已不再支持使用账户密码直接通过 HTTPS 进行 Git 操作，推荐使用 Personal Access Token（个人访问令牌） 进行认证。

1. 在 Gitee 上生成 Personal Access Token

登录 Gitee → 点击头像 → 设置
左侧菜单选择 “安全设置” → “私人令牌”
点击 “生成新令牌”
填写令牌描述（如 “Trae IDE 开发用”）
选择授权范围（推荐勾选：projects、git_hooks、hooks、pull_requests 等）
点击 “提交”，系统会生成一串令牌

⚠️ 注意：令牌只会显示一次！请立即复制并妥善保存到密码管理器或 1Password 中。

2. 在 Mac 上使用 PAT 认证

方式一：HTTPS + PAT（推荐）

使用 PAT 代替密码进行 Git 操作：

# 方式 A：在终端中直接输入（安全）
git push
# 弹出输入框时：
#   Username: 你的 Gitee 用户名（或手机号/邮箱）
#   Password: 粘贴 Personal Access Token

方式二：将 PAT 写入钥匙串（推荐，省去重复输入）

搭配前面的 osxkeychain 凭证助手：

# 1. 启用钥匙串凭证助手
git config --global credential.helper osxkeychain

# 2. 手动向钥匙串中添加 Gitee 凭证
#    将 YOUR_TOKEN 替换为实际的 PAT
security add-internet-password \
  -a "你的Gitee用户名" \
  -s "gitee.com" \
  -w "YOUR_PERSONAL_ACCESS_TOKEN" \
  -r "htps" \
  -l "Gitee Access Token" \
  -D "Web form password" \
  -j "Git credentials for Gitee" \
  /Library/Keychains/System.keychain

或者更简单的方式——执行一次 Git 操作，在弹出的对话框中输入 PAT：

# 触发一次 push，会弹出钥匙串对话框
echo "test" > test.txt
git add test.txt
git commit -m "测试 PAT 认证"
git push -u origin main
# 在弹出的对话框中：
#   用户名：你的 Gitee 用户名
#   密码：粘贴 PAT
#   勾选"记住密码"

之后所有 Git 操作都会自动使用保存的 PAT。

方式三：使用 SSH 密钥认证（无需输入密码）

如果希望完全免密码操作，推荐使用 SSH 方式，这在 Mac 上体验最佳：

# 1. 生成 SSH 密钥（如果还没有）
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
# 按回车接受默认路径 ~/.ssh/id_ed25519
# 可选设置密码（passphrase），或直接按回车不设密码

# 2. 查看公钥内容
cat ~/.ssh/id_ed25519.pub
# 复制输出的整段内容

# 3. 将公钥添加到 Gitee
#    登录 Gitee → 设置 → 安全设置 → SSH 公钥
#    粘贴公钥内容，填写标题（如 "MacBook Pro"）

# 4. 在 Trae 中使用 SSH 地址克隆仓库
git clone git@gitee.com:你的用户名/仓库名.git

# 5. 验证连接是否成功
ssh -T git@gitee.com
# 看到 "Welcome to Gitee.com, 你的用户名！" 说明配置成功

SSH 方式的优点是：

无需输入任何密码
安全性更高（使用非对称加密）
不受 Gitee 密码策略变更影响

常见问题与排错

Q1: “remote: The project you were looking for could not be found.”

原因：Gitee 仓库地址错误，或没有权限访问
解决：检查仓库 URL 是否正确，确认是否已加入仓库协作者

Q2: “Authentication failed” 认证失败

原因：使用了过期的 PAT 或账户密码
解决：重新生成 PAT，更新钥匙串中的凭证

Q3: Mac 钥匙串弹窗反复出现

原因：钥匙串中的凭证已过期或损坏
解决：在 Mac 的”钥匙串访问”（Keychain Access）应用中搜索 gitee.com，删除相关条目后重新配置

Q4: Trae 的 AI 提示 “not a git repository”

原因：当前工作目录没有初始化 Git 仓库
解决：在 Trae 终端中执行 git init 或从 Gitee 克隆已有仓库

小结

通过本小节的学习，您已经掌握了：

技能	关键操作
Gitee 仓库配置	注册账号、创建仓库、获取仓库地址
Trae 自动 Git 操作	配置 user.name/user.email，确保凭证可用
记住账号密码	使用 `osxkeychain` 或其他 credential helper
Mac PAT 认证	生成令牌、存入钥匙串、免密码推送
SSH 免密登录	生成密钥、配置到 Gitee、使用 SSH 地址克隆

正在开发商业 IoT 产品？

我们提供 ESP32 ODM 定制设计与制造服务。从原型到量产——编写这套教程的团队，可以和你一起实现。

联系我们 →