Trae IDE + Gitee 超详细配置教程

📌 教程适用人群：Python新手、Trae IDE使用者、不想折腾GitHub网络问题、只想纯净托管py源码的开发者

📌 教程核心亮点：全程国内Gitee稳定访问、无需翻墙、只追踪.py源码、自动过滤所有垃圾文件、SSH免密登录、Trae图形化操作零命令刚需

📌 最终效果：电脑写Python代码，一键提交同步到Gitee，仓库干净整洁，只有源码无冗余文件

---

一、前言：为什么放弃GitHub，选择Gitee？

很多新手配置GitHub会遇到：网页打不开、SSH超时、推送失败、网络波动等问题。

Gitee（码云）国内服务器，访问秒开、稳定无卡顿、完全免费、私有仓库不限量，非常适合个人开发者托管Python源码。

本文适配 Windows + Trae IDE + Git + Gitee，一步到位，永久复用。

---

二、完整配置流程（8大步骤，从零到通）

1、注册Gitee账号

1. 打开官网：https://gitee.com

2. 手机号注册/登录账号

3. 牢记：用户名 + 注册邮箱（后续Git配置必须用到）

✅ 优势：国内访问无压力，无需任何网络工具

2、安装 Git 工具（必备依赖）

Trae IDE 本身不带Git，必须手动安装Git for Windows。

1. 下载安装Git，安装时务必勾选：Add Git to PATH

2. 安装完成后，打开 Trae 终端（Ctrl+~），执行全局基础配置

git config --global user.name "你的Gitee用户名"
git config --global user.email "你的Gitee注册邮箱"

# 查看是否配置成功
git config --global --list

⚠️ 不配置这两步，后续所有代码提交全部报错！

3、生成 SSH 密钥（实现永久免密推送）

作用：配置后Trae推拉代码无需输入账号密码，一劳永逸。

Trae终端执行正确命令（杜绝拼写错误）：

ssh-keygen -t ed25519 -C "你的Gitee注册邮箱"

执行后 连续三次回车，不要设置密码、不要修改路径！

生成成功后，读取公钥：

type ~/.ssh/id_ed25519.pub

复制全部输出内容（ssh-ed25519开头的整段文本）。

4、公钥上传到Gitee后台

1. Gitee网页右上角头像 → 设置

2. 左侧找到 安全设置 → SSH公钥

3. 标题自定义（例：Trae-Windows电脑）

4. 粘贴刚刚复制的公钥，保存确认

5. 终端测试连通性：

ssh -T git@gitee.com

首次连接输入 yes 回车，提示 成功认证 即配置完成。

5、Gitee网页创建项目仓库

1. 网页右上角「+」号 → 新建仓库

2. 仓库名称：英文命名（无中文、无空格）

3. 推荐选择 私有仓库（代码仅自己可见）

4. ⚠️ 重点：本地已有代码，绝对不要勾选 README初始化，否则首次推送冲突报错

5. 点击创建仓库

6、复制Gitee仓库SSH地址

仓库主页 → 克隆/下载 → 切换到 SSH 模式

复制地址，格式如下：

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

❌ 不要复制HTTPS地址，SSH才支持免密登录

7、Trae IDE 关联Gitee仓库

场景1：本地已有Python项目（最常用）

1. Trae打开项目文件夹

2. 左侧【源代码管理】→ 初始化仓库

3. 终端执行关联命令（替换为你的仓库地址）

git remote add origin 你的GiteeSSH地址
git branch -M main
git push -u origin main

场景2：空白项目，拉取云端代码

Trae欢迎页 → 克隆Git仓库 → 粘贴SSH地址 → 选择本地目录即可

8、配置 .gitignore（核心：只托管.py文件）

很多新手仓库杂乱，缓存、日志、配置文件全部上传，极不规范。

在项目根目录新建文件，命名为 .gitignore（无后缀），粘贴以下专属Python配置：

# 全局忽略所有文件
*
# 允许遍历文件夹
!**/
# 只保留所有py源码文件
!**/*.py

# 忽略Python缓存
__pycache__/
*.py[cod]
*.pyd

# 忽略虚拟环境
venv/
.venv/
env/

# 忽略日志、临时文件
*.log
*.tmp

# 忽略Trae、系统缓存
.trae/
Thumbs.db
.DS_Store

✅最终效果：无论项目多少杂文件，Git只识别、提交、上传 .py 源码，仓库极度干净。

---

三、日常开发常用Git命令（新手够用）

日常99%场景只需这几条，优先图形化操作，卡顿再用命令兜底：

# 1.查看文件变更状态（优先执行）
git status

# 2.添加所有变更文件
git add .

# 3.本地提交代码（引号内填写修改说明）
git commit -m "更新Python功能/修复bug"

# 4.推送到Gitee云端
git push origin main

# 5.拉取云端最新代码（多设备同步用）
git pull origin main

# 6.查看历史提交记录
git log --oneline

---

四、高频报错避坑总结（解决90%问题）

1. ssh-keygen 命令识别失败：拼写错误！不是 ssk-keygen，必须是 ssh-keygen

2. 首次连接提示确认：输入 yes 回车，属于正常安全校验，不是报错

3. Trae提交失败：必须填写提交备注，空白提交会直接卡死

4. 首次推送冲突：新建仓库不要勾选README，如需修复执行 git pull origin main --allow-unrelated-histories

5. 杂文件还在上传：新增gitignore后，需重新初始化仓库生效

---

五、Trae图形化日常工作流（无需敲命令）

1. 编写/修改Python代码，保存文件

2. 左侧源代码管理查看变更（只显示.py文件）

3. 输入提交备注 → 点击【提交】

4. 点击【拉取】→【推送】，一键同步到Gitee云端

5. 完成代码备份，永久留存

---

六、总结

1. 放弃GitHub网络烦恼，Gitee是国内个人开发者的选择

2. 一套SSH密钥永久免密，无需反复输密码

3. 专属gitignore配置，只托管Python源码，仓库整洁规范

4. Trae图形化操作为主、命令兜底，新手零门槛上手

5. 支持无限新建私有仓库，多个Python项目分开托管、互不干扰