安装指南

欢迎使用 Trae IDE！本指南将帮助您在各种操作系统上安装和设置 Trae IDE。

系统要求

最低要求

操作系统: Windows 10+, macOS 10.14+, 或 Linux (Ubuntu 18.04+)
内存: 4GB RAM
存储空间: 2GB 可用磁盘空间
处理器: Intel i3 或同等性能的 AMD 处理器

下载 Trae IDE

官方下载

访问 Trae 官网下载最新版本：

Windows: Trae-Setup-x64.exe
macOS: Trae-darwin-x64.dmg (Intel) 或 Trae-darwin-arm64.dmg (Apple Silicon)
Linux: Trae-linux-x64.AppImage 或 .deb / .rpm 包

预发布版本

如果您想体验最新功能，可以下载预发布版本：

访问 GitHub Releases
选择标有 "Pre-release" 的版本
下载对应平台的安装包

安装步骤

Windows 安装

下载安装程序
- 下载 Trae-Setup-x64.exe
- 确保文件完整性（可选：验证 SHA256 校验和）

运行安装程序

bash

# 右键点击安装程序，选择"以管理员身份运行"

安装向导
- 接受许可协议
- 选择安装位置（默认：C:\Program Files\Trae）
- 选择组件：
  - ✅ Trae IDE 核心
  - ✅ 桌面快捷方式
  - ✅ 开始菜单快捷方式
  - ✅ 文件关联（.trae 项目文件）
  - ✅ 添加到 PATH 环境变量
完成安装
- 点击"安装"开始安装过程
- 等待安装完成（通常需要 2-5 分钟）
- 选择"立即启动 Trae IDE"

macOS 安装

下载 DMG 文件

bash

# Intel Mac
curl -O https://releases.trae.ai/latest/Trae-darwin-x64.dmg

# Apple Silicon Mac
curl -O https://releases.trae.ai/latest/Trae-darwin-arm64.dmg

挂载和安装

bash

# 双击 DMG 文件挂载
# 将 Trae.app 拖拽到 Applications 文件夹

首次启动

bash

# 从 Launchpad 或 Applications 文件夹启动
# 如果出现安全提示，请前往"系统偏好设置" > "安全性与隐私"
# 点击"仍要打开"允许 Trae 运行

命令行工具（可选）

bash

# 添加命令行工具到 PATH
echo 'export PATH="/Applications/Trae.app/Contents/Resources/app/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证安装
trae --version

Linux 安装

使用 AppImage（推荐）

bash

# 下载 AppImage
wget https://releases.trae.ai/latest/Trae-linux-x64.AppImage

# 添加执行权限
chmod +x Trae-linux-x64.AppImage

# 运行 Trae
./Trae-linux-x64.AppImage

# 可选：移动到系统目录
sudo mv Trae-linux-x64.AppImage /usr/local/bin/trae

使用 DEB 包（Ubuntu/Debian）

bash

# 下载 DEB 包
wget https://releases.trae.ai/latest/trae_amd64.deb

# 安装
sudo dpkg -i trae_amd64.deb

# 修复依赖（如果需要）
sudo apt-get install -f

# 启动 Trae
trae

使用 RPM 包（CentOS/RHEL/Fedora）

bash

# 下载 RPM 包
wget https://releases.trae.ai/latest/trae-x86_64.rpm

# 安装（CentOS/RHEL）
sudo yum install trae-x86_64.rpm

# 安装（Fedora）
sudo dnf install trae-x86_64.rpm

# 启动 Trae
trae

使用 Snap（通用）

bash

# 安装 Snap（如果未安装）
sudo apt update
sudo apt install snapd

# 安装 Trae
sudo snap install trae --classic

# 启动 Trae
trae

首次启动设置

1. 欢迎界面

首次启动 Trae IDE 时，您将看到欢迎界面：

选择主题: 浅色、深色或自动
选择语言: 中文、英文等
导入设置: 从其他编辑器导入配置（可选）

2. AI 功能设置

json

{
  "ai": {
    "enabled": true,
    "provider": "trae-cloud",
    "features": {
      "codeCompletion": true,
      "chatAssistant": true,
      "codeGeneration": true,
      "errorAnalysis": true
    }
  }
}

3. 账户登录

创建账户: 注册新的 Trae 账户
登录: 使用现有账户登录
离线模式: 暂时跳过登录（功能受限）

4. 扩展安装

推荐安装的扩展：

语言支持:
- JavaScript/TypeScript
- Python
- Java
- C/C++
- Go
- Rust
框架支持:
- React
- Vue.js
- Angular
- Next.js
工具集成:
- Git
- Docker
- ESLint
- Prettier

验证安装

1. 检查版本

bash

# 命令行检查
trae --version

# 输出示例
Trae IDE v1.0.0
Commit: abc123def456
Date: 2024-01-15
Node.js: v18.17.0
Electron: v25.3.0

2. 创建测试项目

bash

# 创建新项目
trae create my-test-project

# 或在 IDE 中
# File > New Project > Web Application > React

3. 测试 AI 功能

打开 AI 聊天：Ctrl+Shift+A
输入："Hello, can you help me write a simple function?"
验证 AI 响应正常

4. 测试代码补全

javascript

// 在 .js 文件中输入
function test() {
  console.l // 应该显示 log 补全建议
}

故障排除

常见问题

Windows 问题

问题: "Windows 已保护你的电脑"

bash

# 解决方案
# 1. 点击"更多信息"
# 2. 点击"仍要运行"
# 3. 或者：右键安装程序 > 属性 > 解除阻止

问题: 安装失败，提示权限不足

bash

# 解决方案
# 1. 右键安装程序
# 2. 选择"以管理员身份运行"
# 3. 或者：禁用 UAC（不推荐）

macOS 问题

问题: "无法打开 Trae，因为无法验证开发者"

bash

# 解决方案
# 1. 系统偏好设置 > 安全性与隐私
# 2. 点击"仍要打开"
# 3. 或者：sudo spctl --master-disable（不推荐）

问题: 命令行工具不可用

bash

# 检查 PATH
echo $PATH

# 重新添加到 PATH
echo 'export PATH="/Applications/Trae.app/Contents/Resources/app/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux 问题

问题: AppImage 无法运行

bash

# 检查依赖
ldd Trae-linux-x64.AppImage

# 安装缺失的库
sudo apt-get install libgtk-3-0 libxss1 libasound2

# 或者使用 --no-sandbox 参数
./Trae-linux-x64.AppImage --no-sandbox

问题: 字体渲染问题

bash

# 安装字体
sudo apt-get install fonts-liberation fonts-dejavu

# 重启 Trae

网络问题

AI 功能无法使用:

bash

# 检查网络连接
ping api.trae.ai

# 检查防火墙设置
# 确保允许 Trae 访问网络

# 配置代理（如果需要）
# File > Preferences > Network > Proxy Settings

扩展下载失败:

bash

# 手动下载扩展
# 1. 访问 Trae 扩展市场
# 2. 下载 .vsix 文件
# 3. Extensions > Install from VSIX

性能问题

启动缓慢:

bash

# 禁用不必要的扩展
# Extensions > Disable unused extensions

# 清理缓存
# Help > Developer Tools > Application > Clear Storage

# 增加内存限制
# File > Preferences > Settings > Memory Limit

高内存使用:

bash

# 监控内存使用
# Help > Process Explorer

# 调整设置
# File > Preferences > Settings
# - 禁用预览功能
# - 减少最大文件大小限制
# - 关闭自动保存

卸载 Trae IDE

Windows 卸载

bash

# 方法 1：控制面板
# 控制面板 > 程序 > 卸载程序 > Trae IDE

# 方法 2：设置应用
# 设置 > 应用 > Trae IDE > 卸载

# 清理残留文件
# 删除：%APPDATA%\Trae
# 删除：%LOCALAPPDATA%\Trae

macOS 卸载

bash

# 删除应用程序
rm -rf /Applications/Trae.app

# 清理用户数据
rm -rf ~/Library/Application\ Support/Trae
rm -rf ~/Library/Preferences/ai.trae.plist
rm -rf ~/Library/Caches/Trae

# 移除命令行工具
# 编辑 ~/.zshrc，删除 Trae 相关的 PATH 配置

Linux 卸载

bash

# AppImage
rm /usr/local/bin/trae  # 或删除 AppImage 文件

# DEB 包
sudo apt-get remove trae
sudo apt-get purge trae  # 完全删除包括配置

# RPM 包
sudo yum remove trae     # CentOS/RHEL
sudo dnf remove trae     # Fedora

# Snap
sudo snap remove trae

# 清理用户数据
rm -rf ~/.config/Trae
rm -rf ~/.cache/Trae

下一步

安装完成后，您可以：

阅读快速开始指南: 快速开始
了解 IDE 功能: IDE 功能
学习 AI 助手: AI 助手教程
创建第一个项目: 第一个项目

获取帮助

如果您在安装过程中遇到问题：

文档: 帮助文档
社区: GitHub Discussions
问题反馈: GitHub Issues
邮件支持: support@trae.ai

欢迎使用 Trae IDE！🚀

安装指南 ​

系统要求 ​

最低要求 ​

推荐配置 ​

下载 Trae IDE ​

官方下载 ​

预发布版本 ​

安装步骤 ​

Windows 安装 ​

macOS 安装 ​

Linux 安装 ​

使用 AppImage（推荐） ​

使用 DEB 包（Ubuntu/Debian） ​

使用 RPM 包（CentOS/RHEL/Fedora） ​

使用 Snap（通用） ​

首次启动设置 ​

1. 欢迎界面 ​

2. AI 功能设置 ​

3. 账户登录 ​

4. 扩展安装 ​

验证安装 ​

1. 检查版本 ​

2. 创建测试项目 ​

3. 测试 AI 功能 ​

4. 测试代码补全 ​

故障排除 ​

常见问题 ​

Windows 问题 ​

macOS 问题 ​

Linux 问题 ​

网络问题 ​

性能问题 ​

卸载 Trae IDE ​

Windows 卸载 ​

macOS 卸载 ​

Linux 卸载 ​

下一步 ​

获取帮助 ​

安装指南

系统要求

最低要求

推荐配置

下载 Trae IDE

官方下载

预发布版本

安装步骤

Windows 安装

macOS 安装

Linux 安装

使用 AppImage（推荐）

使用 DEB 包（Ubuntu/Debian）

使用 RPM 包（CentOS/RHEL/Fedora）

使用 Snap（通用）

首次启动设置

1. 欢迎界面

2. AI 功能设置

3. 账户登录

4. 扩展安装

验证安装

1. 检查版本

2. 创建测试项目

3. 测试 AI 功能

4. 测试代码补全

故障排除

常见问题

Windows 问题

macOS 问题

Linux 问题

网络问题

性能问题

卸载 Trae IDE

Windows 卸载

macOS 卸载

Linux 卸载

下一步

获取帮助