文档 / 入门

你的第一个项目

打开一个文件夹，让 Yuli 建立索引，决定信任级别，并首次运行应用。

本指南通过五个步骤，带你从刚安装好的 IDE 走到应用成功运行。

1. 打开项目

在 文件 菜单中：

选项 适用场景
打开项目… 项目已在你的电脑上。
打开文件夹… 你想打开任意文件夹。
克隆仓库… 项目位于 GitHub、GitLab 或其他远程仓库。
最近的项目 你之前打开过它（Alt+3）。
从模板新建项目… 你要开始一个新项目。

每个项目都会在标题栏下方的独立标签页中打开。你可以同时打开多个项目，并通过 分屏视图：同时查看两个项目 并排查看其中两个。

2. 决定是否信任

首次打开时，Yuli 会询问 “你信任此项目吗？”。

选项 作用 何时选择
信任 运行项目的 Lombok 和 Maven/Gradle，进行完整分析。 你自己或团队的项目。
受限模式 不运行仓库中的代码，仅基于可读取的内容进行分析。 你不了解的代码。

之后可在 全局选项 → 安全 → 受信任的项目 中更改。

3. 等待索引完成

Yuli 会在后台分析项目。编辑器顶部的细进度条会显示进度：

  1. “正在准备代码智能功能…”
  2. “正在为项目建立索引…”
  3. “正在解析依赖并分析…”

在此期间你可以继续编辑。索引完成后，引用、导航和图表将全部可用。

Yuli 会识别项目类型：Maven、Gradle、Ant、Eclipse、npm 或 Cargo。如果缺少 JDK、Maven 或 Gradle，它会提供下载。

4. 熟悉界面

区域 内容
左侧 项目：文件、Git 和智能体配置。
中间 与 AI 的聊天。
右侧 编辑器及其标签页。
底部 终端、运行、问题、测试和质量。

详见界面。

5. 运行

有三种方式：

  • 在主页点击 运行与测试。
  • Shift+F10 运行上一次的配置；Shift+F9 调试它。
  • 让智能体来做：“启动应用，并告诉我它运行在哪个端口。”

输出会显示在 运行 面板中。项目中的 stack trace 行以及每个 Archivo.java:42 都可直接跳转到对应文件和行。

如需创建或调整配置（环境变量、Spring 配置文件、JVM 选项），请使用 项目 → 构建、运行和调试…。参见运行与调试。

测试

  • Ctrl+Shift+F10 运行所有测试。
  • Ctrl+Shift+F11 运行测试并统计覆盖率。
  • Ctrl+F9 构建项目。

结果显示在 测试 面板中，覆盖率显示在编辑器的边栏中。

下一步

连接 AI，然后提出你的第一个任务。一个不错的入门尝试：

“给我讲讲这个项目的架构，以及主要业务逻辑在哪里。”