Kotlin 语言参考文档 中文版 Help

创建你的第一个 Kotlin Notebook

要开始使用 Kotlin Notebook, 主要可以通过三种方式:

创建一个新项目

要创建一个包含 Kotlin Notebook 的新项目, 步骤如下:

  1. 在 IntelliJ IDEA 的欢迎界面中, 在左侧面板选择 Kotlin Notebook | New Notebook.

  2. 输入新 Notebook 的 Name, 并选择 Type | In Folder.

    • Scratch:: 这个选项用于创建草稿(Scratch) Notebook, 而不将其添加到项目中.

    • In Folder:: 这个选项用于在项目中创建 Notebook. 你需要指定项目的位置.

  3. 点击 Create.

从 IntelliJ IDEA 创建新的 Kotlin Notebook

你的新 Kotlin Notebook 会在一个新项目中创建完成.

或者, 也可以先创建一个空项目, 再 添加 Kotlin Notebook:

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

  2. 在左侧面板中, 选择 New Project.

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

  4. 在 Language 列表中, 选择 Kotlin.

    创建一个新的 Kotlin Notebook 项目
  5. 选择 IntelliJ 构建系统.

  6. 在 JDK 列表中, 选择你的项目希望使用的 JDK.

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

  8. 点击 Create.

项目创建完成后, 添加一个新的 Kotlin Notebook (参见下一节).

向项目添加新的 Kotlin Notebook

要向既有项目添加新的 Kotlin Notebook, 步骤如下:

  1. 选择 File | New | Kotlin Notebook, 或者对一个文件夹右击鼠标, 选择 New | Kotlin Notebook.

    创建一个新的 Kotlin Notebook
  2. 设置新 Notebook 的名称, 例如, first-notebook.

  3. 按下 Enter 键. 会打开一个新的 tab, 其中包含 Kotlin Notebook first-notebook.ipynb.

创建 Kotlin Notebook 草稿(Scratch)

也可以以草稿文件(Scratch File)的形式创建 Kotlin Notebook. 使用 草稿文件(Scratch File), 你可以测试一小段代码, 而不必创建新的项目, 或修改已有的项目.

要创建 Kotlin Notebook 草稿:

  1. 点击 File | New | Scratch File.

  2. 在 New Scratch File 列表中, 选择 Kotlin Notebook.

    Notebook 草稿

执行基本操作

  1. 在新的 Kotlin Notebook 中, 在代码单元(Code Cell)内输入以下代码:

    println("Hello, this is a Kotlin Notebook!")
  2. 要运行代码单元(code cell), 请点击 Run Cell and Select Below Run Cell and Select Below 按钮, 或按下快捷键 Shift + Return.

  3. 点击 Add Markdown Cell 按钮, 添加一个 Markdown 单元.

  4. 在单元中输入 # Example operations, 运行并渲染这个 Markdown 单元, 运行方式与运行代码单元相同.

  5. 在新的代码单元中, 输入 10 + 10, 并运行.

  6. 在一个代码单元中定义一个变量. 例如, val a = 100.

  7. 创建一个新的代码单元, 添加代码 println(a * a).

  8. 使用 Run All Run all button 按钮, 运行 Notebook 中的所有代码单元和 Markdown 单元.

    第一个 Notebook

恭喜! 你已经创建并尝试了你的第一个 Kotlin Notebook.

下一步

在本教程的下一部分, 你将学习如何向 Kotlin Notebook 添加依赖项.

2026/09/29