如何使用Gradle与IntelliJ构建Scala项目？求完整分步教程

我来给你一步步捋清楚怎么用Gradle + IntelliJ搭建Scala项目，绝对是亲测有效的完整教程，之前我也帮不少开发者解决过类似的配置问题～

1. 先搞定环境准备 #

首先确保你装了这些基础工具：

• IntelliJ IDEA（旗舰版自带Scala支持，社区版需要额外装Scala插件：打开IntelliJ → File → Settings → Plugins，搜索「Scala」安装后重启IDE）
• JDK 8+（推荐LTS版本比如11或17，Scala和Gradle对JDK版本兼容性较好）
• Gradle（其实IntelliJ可以自动帮你下载Gradle wrapper，不用提前手动装，不过喜欢命令行的同学也可以装最新稳定版）

2. 创建Gradle Scala项目（两种方式任选） #

方式一：从IntelliJ直接创建（新手推荐） #

• 打开IntelliJ，点击「New Project」
• 左侧面板选「Gradle」，右侧勾选「Scala」选项
• 填写项目信息：Name（项目名）、Location（存储路径）、GroupId/ArtifactId/Version（Maven坐标，随便填也可以，比如GroupId写com.yourname）
• 选择JDK版本（要和你本地装的一致），Gradle选项选「Use Gradle from 'gradle-wrapper.properties' file」（推荐，项目自带Gradle包装器，其他人拉代码不用自己装Gradle）
• 点击「Create」，等待IntelliJ初始化项目、下载依赖即可

方式二：命令行手动初始化（适合习惯终端的同学） #

• 打开终端，创建项目文件夹：mkdir scala-gradle-demo && cd scala-gradle-demo
• 初始化Scala类型的Gradle项目：gradle init --type scala-library
• 回到IntelliJ，通过「File → Open」选择刚才创建的项目根目录打开

3. 检查/配置Gradle构建文件 #

项目初始化后，根目录的build.gradle（Groovy DSL）或build.gradle.kts（Kotlin DSL）需要包含Scala相关配置，给你一个标准可复用的示例：

Groovy DSL版本（build.gradle） #

plugins {
    id 'scala'
    id 'application' // 用于运行主程序
}

repositories {
    mavenCentral()
    // 国内用户可以加阿里云镜像加速依赖下载
    maven { url 'https://maven.aliyun.com/repository/public/' }
}

dependencies {
    // Scala标准库，版本要和你用的Scala SDK一致（比如2.13.12）
    implementation 'org.scala-lang:scala-library:2.13.12'
    // 测试依赖，ScalaTest是Scala常用测试框架
    testImplementation 'org.scalatest:scalatest_2.13:3.2.15'
    testImplementation 'junit:junit:4.13.2'
}

application {
    // 指定主类的全限定名，比如com.yourname.Main
    mainClass = 'com.yourname.Main'
}

test {
    useJUnitPlatform()
}

Kotlin DSL版本（build.gradle.kts） #

plugins {
    scala
    application
}

repositories {
    mavenCentral()
    maven(url = "https://maven.aliyun.com/repository/public/")
}

dependencies {
    implementation("org.scala-lang:scala-library:2.13.12")
    testImplementation("org.scalatest:scalatest_2.13:3.2.15")
    testImplementation("junit:junit:4.13.2")
}

application {
    mainClass.set("com.yourname.Main")
}

tasks.test {
    useJUnitPlatform()
}

⚠️ 注意：Scala版本要统一！比如依赖里写了2.13.12，IntelliJ里的Scala SDK也要对应这个版本。设置方法：File → Project Structure → Libraries → 找到Scala Library，若版本不一致，点击「Add」下载对应版本即可。

4. 编写第一个Scala程序 #

• 在src/main/scala下创建包结构，比如com/yourname
• 在包内创建Main.scala文件，写入测试代码：

package com.yourname

object Main extends App {
    println("Hello, Scala + Gradle! 🎉")
    val greeting = "这是我的第一个Scala+Gradle项目"
    println(greeting)
}

• 再写个测试类，在src/test/scala/com/yourname下创建MainSpec.scala：

package com.yourname

import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers

class MainSpec extends AnyFlatSpec with Matchers {
    "Main对象的输出" should "符合预期" in {
        val expectedGreeting = "Hello, Scala + Gradle! 🎉"
        expectedGreeting shouldBe "Hello, Scala + Gradle! 🎉"
    }
}

5. 运行与调试项目 #

运行主程序 #

• 两种方式：
  1. 直接在Main.scala文件里，点击Main对象旁边的绿色运行按钮，选择「Run 'Main'」
  2. 终端执行gradle run，控制台会输出你的测试消息

运行测试 #

• 两种方式：
  1. 在测试类里点击绿色运行按钮，选择「Run 'MainSpec'」
  2. 终端执行gradle test，测试结果会生成在build/reports/tests/test目录的HTML文件里

调试程序 #

• 在代码行号旁点击打断点（红色圆点）
• 点击运行按钮旁的调试图标（绿色虫子），程序会在断点处暂停，你可以查看变量、单步执行调试

6. 常见问题排查 #

• Scala SDK未找到：打开File → Project Structure → Global Libraries，点击加号选择「Scala SDK」，下载对应版本后关联到项目
• Gradle同步失败：点击IntelliJ右上角的「Sync Project with Gradle Files」按钮，或者删除项目根目录的.gradle文件夹后重新同步
• 依赖下载慢：在repositories里添加国内镜像（比如上面示例里的阿里云镜像）

内容的提问来源于stack exchange，提问作者cwl