源本科技 | 码上会

TRAE 项目管理

2026/03/08
34
0

核心概念

理解“工作空间” (Workspace)

在深入操作之前,首先需要明确 TRAE 中的核心概念——工作空间

  • 定义:工作空间通常指在 TRAE 中打开的一个根文件夹。它是您进行代码编辑、调试和版本控制的基础上下文环境。

  • 多文件夹支持:对于结构复杂的大型项目,TRAE 允许您将多个独立的文件夹添加至同一个工作空间中。这意味着您可以在一个窗口内同时管理前端、后端或微服务等多个关联模块,而无需频繁切换窗口。

  • 最佳实践:建议将逻辑上紧密相关的代码库放在同一工作空间中,以便利用 TRAE 的全局搜索、跨文件引用跳转等功能。


创建项目的三种方式

TRAE 提供了高度灵活的项目初始化方案,无论是本地开发、开源协作还是私有仓库管理,都能找到合适的入口。

导入本地文件夹

适用于您已经在本地磁盘准备好代码,或需要从零开始构建新项目的场景。

操作步骤:

  1. 入口选择

    • 点击左侧面板中央显眼的(打开文件夹) 按钮。

    • 或者,点击界面左上角的(选择项目) 菜单,在下拉列表中选择(打开文件夹)

  2. 选择路径:在弹出的系统文件对话框中,导航至您的目标文件夹,选中后确认。

  3. 加载项目:TRAE 将立即索引该文件夹,并在侧边栏展示文件树,项目即刻就绪。

小贴士:如果文件夹内尚未初始化 Git 仓库,TRAE 通常会提示您是否将其初始化为 Git 仓库,建议勾选以启用版本控制功能。

从 GitHub 克隆仓库

适用于需要参与开源项目、同步团队代码或利用 GitHub 托管私有仓库的场景。此方式需要授权 TRAE 访问您的 GitHub 账户。

操作步骤:

  • 启动克隆

    • 点击左侧面板的(克隆 Git 仓库)按钮

    • 或通过左上角菜单(选择项目)>(克隆 Git 仓库)

image-BbqA.webp
  • 选择来源:在弹出的选项中选择(从 GitHub 克隆)

image-WqdD.webp
  • 身份授权

    • 系统将弹出授权窗口,点击(允许)

    • 按照浏览器或系统提示完成 TRAE 与 GitHub 之间的 OAuth 授权流程。

  • 选取仓库

    • 授权成功后,TRAE 会列出您有权限访问的所有仓库。

    • 直接选择:在列表中点击目标仓库。

    • 搜索选择:在输入框中输入仓库名称(支持模糊搜索)。

  • 设定存储位置:在文件对话框中选择本地存储路径,点击(选择为存储库目标)

  • 打开项目:克隆完成后,根据需求选择:

    • 打开:在当前 TRAE 窗口加载项目(适合单任务专注模式)。

    • 在新窗口中打开:启动一个新的 TRAE 实例加载该项目(适合同时处理多个独立任务)。

通过 Git URL 直接克隆

适用于克隆非 GitHub 平台(如 GitLab, Gitee, Bitbucket)的仓库,或无需登录 GitHub 账号即可访问的公开 / 私有仓库。

操作步骤:

  1. 启动克隆:同样通过左侧面板或左上角菜单进入 "克隆 Git 仓库" 界面。

  2. 输入地址:选择 "提供仓库 URL 或选择仓库源"(或直接在下拉框中选择 URL 输入模式),在文本框中粘贴完整的 Git 仓库地址(例如:https://github.com/user/repo.gitgit@gitlab.com:user/repo.git)。

  3. 确认克隆:点击(克隆) 或对应的确认按钮。

  4. 设定存储位置:选择本地保存路径并确认。

  5. 打开项目:克隆结束后,同样可选择 "打开""在新窗口中打开" 来启动项目。

注意事项

  • 若克隆的是私有仓库且未通过 SSH 密钥或凭证管理器配置认证,系统可能会在克隆过程中提示您输入用户名和密码(或 Personal Access Token)。

  • 确保本地已安装 Git 命令行工具,否则 TRAE 可能无法执行克隆操作。


项目切换与管理

在实际开发中,开发者往往需要同时维护多个项目。TRAE 提供了便捷的项目切换机制,避免重复启动软件。

切换步骤:

  1. 激活菜单:点击界面左上角显示的当前项目名称(通常位于菜单栏最左侧)。

  2. 查看历史:系统将展开一个面板,其中(最近) 列表展示了您最近打开或导入过的项目记录。

  3. 选择目标:点击列表中您需要切换到的项目名称。

  4. 加载环境:TRAE 会自动在一个新窗口中加载并展示该项目,保持原有窗口的状态不受干扰。

管理建议:

  • 多窗口策略:TRAE 默认在新窗口打开切换后的项目,这有利于隔离不同项目的上下文环境(如不同的插件配置、终端变量等)。

  • 清理记录:如果 "最近" 列表中包含了不再需要的项目,通常可以通过右键点击该项目选择 "从列表中移除" 来保持列表整洁。