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/07/24