VS Code运行Kotlin代码报错：'kotlinc'未被识别，求解决方案

问题重现 #

你执行的编译命令：

cd "c:\Users\<MyPcUser>\<SomeMoreFolders>\Visual Studio\Kotlin (There is the file saved) \" && kotlinc main.kt -include-runtime -d main.jar && java -jar main.jar

报错信息：

'kotlinc' is not recognized as an internal or external command, operable program or batch file.

解决方案 #

• 确认Kotlin编译器已安装
  仅安装VS Code的Kotlin语言扩展不够，需要下载并安装Kotlin官方SDK。安装完成后找到目录下的bin文件夹（通常路径类似C:\Program Files\Kotlin\bin），确认其中包含kotlinc.exe。

• 将Kotlin编译器路径添加到系统PATH环境变量

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」区域找到PATH，点击「编辑」
  3. 点击「新建」，输入Kotlin的bin文件夹完整路径（比如C:\Program Files\Kotlin\bin）
  4. 保存所有设置后，重启VS Code或终端，让环境变量生效

• 验证配置是否生效
  打开命令提示符（cmd），输入kotlinc -version，如果能正常显示Kotlin编译器版本，说明配置成功，此时再运行你的Kotlin代码命令即可。

• 可选：直接在Code Runner中指定编译器路径
  如果不想修改系统环境变量，可以在VS Code的Code Runner扩展设置里指定kotlinc的完整路径：

  1. 打开VS Code设置，搜索Code Runner: Executor Map
  2. 找到Kotlin对应的配置项，将kotlinc替换为你的编译器完整路径，示例：

     "kotlin": "cd $dir && C:/Program Files/Kotlin/bin/kotlinc.exe $fileName -include-runtime -d $fileNameWithoutExt.jar && java -jar $fileNameWithoutExt.jar"
     

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