Kotlin Notebook 是专为 JVM 开发者打造的一种全新交互式环境。本文将详细介绍 Notebook 的主要功能，并展示如何利用这些功能提升工作效率。
一、如何使用 Kotlin Notebook
从 2025.1 版本开始，Kotlin Notebook 与 IntelliJ IDEA 紧密结合，使得在各种情境下使用 Notebook 变得前所未有的简单。您可以通过以下三种主要方式创建 Notebook：
1. 在项目中创建 Notebook：打开项目后，在 Project 视图中，右键点击源根目录或某个文件夹，然后选择 New | Kotlin Notebook。这将在项目内创建一个 .ipynb 文件。通常，Notebook 置于 notebooks 或 samples 子目录中，但也可以置于项目内的任意位置。
2. 创建临时 Notebook：如果您在不向项目添加新文件的情况下试验代码，临时 Notebook 会非常实用。要创建不属于特定项目的 Notebook，请按以下步骤操作：使用 New Scratch File 操作（在 macOS 上按 Cmd+Shift+N，Windows/Linux 上按 Ctrl+Alt+Shift+Insert），然后从列表中选择 Kotlin Notebook。这将在 Scratches and Consoles | Kotlin Notebooks 目录中创建一个文件，并且该 Notebook 可在所有项目中访问，方便您存储零散的代码段并在需要时随时引用它们。
3. 从 Welcome 屏幕创建 Notebook：您无需打开项目即可直接从 Welcome 屏幕打开或创建 Kotlin Notebook。导航到 Kotlin Notebook 标签页并点击 New Notebook。系统将提示您为 Notebook 命名，并选择将其另存为临时文件或存储到指定文件夹。
二、基础知识：交互式单元执行与内核控制
Kotlin Notebook 在 IntelliJ IDEA 内提供了熟悉的 Notebook 界面，支持轻松运行代码和管理执行状态。每个 Notebook 由可独立或按序执行的单元组成。Notebook 顶部的工具栏包含用于运行单元和管理 Kotlin 内核的控件：
1. 运行单个单元：点击代码单元左侧的 Run 按钮，或按 Ctrl+Enter/Cmd+Enter。单元的代码随即运行，输出结果直接显示在单元下方。
2. 运行多个单元：点击 Run All 以从上至下执行 Notebook 中的所有单元。如果要运行特定点之下的所有单元（例如，从 Notebook 的中间恢复），您可以右键点击该单元并选择 Run All Below。这种灵活性让您能够重新运行整个 Notebook 或特定部分，无需手动运行每个单元。
3. 中断执行：如果某个单元耗时过长或陷入死循环，请点击 Interrupt 按钮（⏹）。此操作会停止当前运行的单元，而不会影响已执行单元的状态。
4. 重启/停止会话：使用 Restart Kernel 按钮 重置 Kotlin 内核。重启操作会终止当前会话并清除运行时状态，因此所有变量和 import 都会变为未解析状态。这有助于确保干净的初始状态（例如，从头开始运行 Notebook 或从错误状态恢复）。您也可以通过关闭 Notebook 或使用 Kotlin Notebook 工具窗的标准 Stop 操作彻底停止会话。
还可以使用齿轮图标打开 Kotlin Notebook 设置，您可以在其中调整 Notebook 的配置。借助此设置面板，您可以控制 Kotlin 内核环境，例如使用的 JDK 或内核版本。
三、分享与协作
Kotlin Notebook 提供了便捷的方式来与他人分享 Notebook 或在线发布您的成果：
1. GitHub Gist：您可以快速将当前的 Notebook 作为 GitHub Gist 分享。只需点击工具栏上的 Create Gist 按钮（带 GitHub 标徽的图标）。IDE 会将 Notebook 导出到您 GitHub 帐户上的 Gist，并生成一个可分享的 URL。您可以将此 URL 发送给同事，供他们在 GitHub 上查看该 Notebook 或将其下载到本地。此功能非常适合快速分享示例或在问题和论坛中添加 Notebook 内容。您的 Kotlin Notebook 中的所有代码、输出和 Markdown 都会保留。
2. JetBrains Datalore：Kotlin Notebook 与 JetBrains 的在线数据科学 Notebook 平台 Datalore 完全兼容。只需将 .ipynb 文件上传到 Datalore 即可分享或在云端继续工作。这意味着，您只需将 Notebook 移至 Datalore 即可轻松与他人协作——无需任何转换。
四、测试 REST API 与处理数据
相关链接：
1. Kotlin Notebook的诞生：
Kotlin Notebook已在IntelliJ IDEA中亮相，你可以通过以下链接了解更多信息：blog./idea/2025/04/kotlin-notebook-arrives-in-intellij-idea/。
2. 如何执行Notebook中的各个单元：
3. 停止正在运行的单元：
4. Datalore介绍：
想要了解Datalore的相关信息，可以访问：datalore./。
5. kotlin-jupyter-http-util工具：
Kotlin社区提供了一个名为kotlin-jupyter-http-util的工具，你可以在GitHub上找到它：/Kotlin/kotlin-jupyter-http-util。
6. 官方文档库：
7. Kandy文档和示例库探索：
8. GitHub上的Kotlin Jupyter库：
你可以在GitHub上找到Kotlin Jupyter的相关库，链接为：/Kotlin/kotlin-jupyter-libraries。
9. 深入了解：
想要深入了解Kotlin Jupyter的库详细信息，请查阅以下链接：/Kotlin/kotlin-jupyter/blob/master/docs/libraries.md。
