VSCode中Jupyter Notebook的Kotlin Kernel启动失败求助

问题详情 #

在VSCode中使用Jupyter Notebook的Kotlin Kernel时，已创建虚拟环境并通过pip安装jupyter notebook和kotlin-jupyter-kernel，但选择该内核运行代码时触发以下错误：

Failed to start the Kernel. 
FileNotFoundError: [WinError 2] System cannot find specified path. 
View Jupyter log for further details.

当前kernel.json配置 #

{
    "display_name": "Kotlin",
    "language": "kotlin",
    "interrupt_mode": "message",
    "argv": [
        "python",
        "-m",
        "run_kotlin_kernel",
        "{connection_file}"
    ],
    "metadata": {
        "jar_path_detect_command": [
            "python",
            "-m",
            "kotlin_kernel",
            "detect-jars-location"
        ]
    }
}

排查与解决步骤 #

1. 修正虚拟环境Python路径 #

错误核心原因多为kernel.json中python命令未指向虚拟环境内的解释器：

• 激活虚拟环境后，在终端执行where python（Windows）或which python（Linux/macOS），获取Python完整路径
• 将kernel.json里的"python"替换为该完整路径，示例：

  "argv": [
      "C:\\Users\\xxx\\venv\\Scripts\\python.exe",
      "-m",
      "run_kotlin_kernel",
      "{connection_file}"
  ]
  

2. 重新安装kotlin-jupyter-kernel #

确认包安装完整性：

• 激活虚拟环境，执行pip list检查kotlin-jupyter-kernel是否存在
• 若直接运行python -m run_kotlin_kernel报错，执行以下命令重装：

  pip uninstall kotlin-jupyter-kernel -y
  pip install kotlin-jupyter-kernel --no-cache-dir
  

3. 配置Java运行环境 #

Kotlin Kernel依赖JDK，需确保环境正常：

• 在终端执行java -version，确认已安装JDK 1.8及以上版本
• 若未安装，下载对应版本JDK并配置JAVA_HOME环境变量，保证终端能正常识别java命令

4. 查看Jupyter日志定位具体缺失路径 #

• 在VSCode中打开「Jupyter: View Logs」面板，查找日志中明确标记的缺失文件路径
• 若日志提示Kotlin jar包找不到，手动执行python -m kotlin_kernel detect-jars-location获取jar路径，将其补充到kernel.json的metadata配置中（覆盖自动检测命令）

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