IntelliJ IDEA 2025.3 Help

在 IntelliJ IDEA 中使用 ScalaCLI

ScalaCLI 是一个命令行工具,旨在简化 Scala 代码的处理过程。 ScalaCLI 并不是为了取代像 sbt 或 Mill 这样完整的构建工具,而更适合于更简单的项目和任务,在轻量易用的工具非常有用时。 它对于单模块项目特别有用,比如基于终端的应用程序、基础 web 应用程序或无服务器 lambda,也适合用于脚本编写,以及在无需复杂构建工具带来的开销下快速实现原型。

设置 ScalaCLI

要在您的计算机上设置 ScalaCLI,请访问 ScalaCLI 官网 并按照说明操作。

安装后,通过运行: scala-cli --version 来验证 ScalaCLI 是否正常工作。

创建一个新的 ScalaCLI 项目

  1. 在 IntelliJ IDEA 中,选择 文件 | 新建项目...

  2. 新建项目 向导中,从左侧列表中选择 ScalaCLI 作为您的构建系统。

  3. 决定您要使用的 Scala 版本和语法。

  4. 点击 创建

创建一个新的 ScalaCLI 项目

导入一个新的 ScalaCLI 项目

  1. 打开终端并导航到您想创建项目的目录。

  2. 运行以下命令以创建一个新的 ScalaCLI 项目: scala-cli new project-name。 这将在新目录中生成 ScalaCLI 项目的基本结构。

  3. 在 IntelliJ IDEA 中,选择 文件 | 新建 | 从现有源创建项目...

  4. 选择您新建的 ScalaCLI 项目的目录。

  5. 选择 BSP 作为外部模型。 如果 BSP 没有显示,请在项目目录中使用 the scala-cli setup-ide . 命令生成 .bsp 文件夹。

正在导入一个新的 ScalaCLI 项目

项目导入后,IntelliJ IDEA 会使用 Scala CLI 的 BSP 命令来处理您的代码运行、测试和调试。 您可以通过命令行管理项目结构,变更将会同步到 IntelliJ IDEA 中。

导入现有的 ScalaCLI 项目

  1. 在 IntelliJ IDEA 中,选择 文件 | 打开

  2. 选择您新建的 ScalaCLI 项目的目录。

  3. 选择 BSP 作为外部模型。 如果 BSP 没有显示,请在项目目录中使用 scala-cli setup-ide . 命令生成 .bsp 文件夹。

处理 ScalaCLI

在简单的单文件脚本中,ScalaCLI 指令可以放在文件顶部。 在较大的项目中,指令通常放在 project.scala 文件里。 当您将 ScalaCLI 项目导入 IntelliJ IDEA 时,或者使用 scala-cli setup-ide . 命令时,会生成 BSP 配置文件(.bsp/scala-cli.json)。 IntelliJ IDEA 使用此 BSP 配置导入项目。 这使 IntelliJ IDEA 能够理解项目结构和依赖。 导入后,IntelliJ IDEA 会使用 BSP 处理编译、运行、测试和调试 Scala 代码等多种项目管理任务。

如果您在编辑器中修改依赖项,右上角会出现带有 BSP 图标的弹窗。 点击它即可重新加载 BSP 配置。

其它通过命令行进行的项目结构或依赖变更,可以在 IntelliJ IDEA 的 BSP 面板中刷新。

如果您基于带有 sbt 配置的其它项目编写 ScalaCLI 程序,可以将 sbt 依赖粘贴到以 //> using dep 开头的行,文本格式会自动转换。

2026年 1月 23日