Kotlin Notebook无法访问本地Gradle项目源码问题求助

核心原因 #

Kotlin Notebook默认不会自动关联Gradle项目的编译输出和源码路径，需要手动配置或触发关联。

解决步骤 #

1. 关联Gradle项目到Notebook
   打开playground.ipynb后，在Notebook顶部工具栏找到Attach to Gradle Project选项，选择当前项目的根模块（因为用了--no-split-project，直接选my-project即可）。

2. 提前构建Gradle项目
   在终端执行编译命令，生成项目的class文件和jar包：

   ./gradlew build # Windows环境使用 gradlew.bat build
   

3. 手动导入项目源码路径（自动关联失效时用）
   在Notebook的第一个单元格添加以下代码，手动指定项目的编译输出路径：

   @file:DependsOn("../build/classes/kotlin/main")
   @file:DependsOn("../build/libs/my-project.jar")
   

   执行该单元格后，就能正常导入项目中的类，比如：

   import my.project.App
   App().main(arrayOf())
   

4. 检查IDE配置（IntelliJ IDEA环境）

   • 打开File > Settings > Languages & Frameworks > Kotlin > Kotlin Notebook
   • 勾选Use project classpath选项
   • 确认Notebook使用的JDK版本为17，与项目配置一致

额外排查点 #

如果以上步骤无效，尝试重启IDE并重新打开Notebook，或者删除项目根目录下的.idea文件夹后重新导入项目。

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