# 教程 - 创建控制台应用程序

本教程演示如何使用 IntelliJ IDEA 创建一个控制台应用程序.

开始之前, 首先请下载并安装最新版的 [IntelliJ IDEA](https://www.jetbrains.com/idea/download/).

## 创建项目

1. 在 IntelliJ IDEA 中, 选择菜单 File | New | Project.

2. 在左侧列表中, 选择 Kotlin.

3. 输入项目名称, 如果需要的话, 修改它的保存位置.

> **Tip:**
> 选择 Create Git repository, 可以将新项目存入版本控制系统. 这个操作也可以在之后的任何时候进行.

![创建一个控制台应用程序](images/jvm-new-project.png)

4. 选择 IntelliJ 构建系统. 这是原生的构建器, 不需要下载任何额外的 artifact.

如果你希望创建更加复杂的项目, 需要更多配置, 请选择 Maven 或 Gradle. 对于 Gradle,请选择构建脚本的语言: Kotlin 或 Groovy.

5. 在 JDK 列表中, 选择希望在项目中使用的 [JDK](https://www.oracle.com/java/technologies/downloads/).

* 如果在你的计算机上已经安装了 JDK, 但在 IDE 中没有定义, 请选择 Add JDK, 并指定 JDK home 目录的路径.

* 如果在你的计算机上还没有需要的 JDK, 请选择 Download JDK.

6. 启用 Add sample code 选项, 创建一个文件, 其中包含 `"Hello World!"` 示例程序.

> **Tip:**
> 你也可以启用 Generate code with onboarding tips 选项, 向你的示例代码添加一些有用的注释.

7. 点击 Create.

> **Note:**
> 如果你选择了 Gradle 构建系统, 那么在你的项目中会有一个构建脚本文件: `build.gradle(.kts)`. 其中包含 `kotlin("jvm")` 插件, 以及你的控制台应用程序需要的依赖项目. 请确认使用了插件的最新版本:
>
>
>
> Kotlin:
>
>
>
> ```KOTLIN
> plugins {
> kotlin("jvm") version "2.4.20"
> application
> }
> ```
>
>
>
> Groovy:
>
>
>
> ```GROOVY
> plugins {
> id 'org.jetbrains.kotlin.jvm' version '2.4.20'
> id 'application'
> }
> ```

## 创建应用程序

1. 打开 `src/main/kotlin` 中的 `Main.kt` 文件. `src` 目录包含 Kotlin 源代码文件和资源文件. `Main.kt` 文件包含示例代码, 它会输出 `Hello, Kotlin!`, 以及几行循环迭代器的值.

![包括 main 函数的 Main.kt 文件](images/jvm-main-kt-initial.png)

2. 修改代码, 让它询问你的名字, 然后对你说 `Hello`:

* 创建一个输入提示, 然后将 [readln()](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.io/readln.html) 函数返回的值赋值给 `name` 变量.

* 我们使用一个字符串模板, 而不是字符串拼接, 方法是直接在输出的文本内, 在变量名之前添加一个 `$` 符号 – `$name`.

```KOTLIN
fun main() {
    println("What's your name?")
    val name = readln()
    println("Hello, $name!")

    // ...
}
```

## 运行应用程序

现在应用程序已经可以运行了. 最简单的方法是, 在源代码编辑器侧栏中按绿色的 Run 图标, 然后选择 Run 'MainKt'.

![运行控制台应用程序](images/jvm-run-app.png)

你可以在 Run 工具窗口中看到运行结果.

![Kotlin 的运行输出](images/jvm-output-1.png)

输入你的名字, 然后可以看到你的应用程序向你问候!

![Kotlin 的运行输出](images/jvm-output-2.png)

恭喜你! 你已经运行了你的第一个 Kotlin 应用程序.

## 下一步做什么?

创建了这个应用程序之后, 你可以开始更加深入的学习 Kotlin 语法:

* 完成 [Kotlin 观光之旅](kotlin-tour-welcome.html)

* 在 IDEA 中安装 [JetBrains Academy Plugin](https://plugins.jetbrains.com/plugin/10081-jetbrains-academy), 并完成 [Kotlin Koan 课程](https://plugins.jetbrains.com/plugin/10081-jetbrains-academy/docs/learner-start-guide.html?section=Kotlin%20Koans) 中的练习