Kotlin跨文件调用类出现Unresolved Reference Error问题排查

嘿，我刚从Python转Kotlin的时候也踩过一模一样的坑！让我帮你拆解一下问题根源和解决办法：

问题原因 #

Python是解释型脚本语言，运行时会自动加载同目录下的相关文件，但Kotlin是编译型语言。你用VSCode的Code Runner默认配置运行时，它只会编译并执行当前打开的单个文件（比如main.kt），完全没把board.kt包含到编译流程里，自然找不到TicTacToeBoard类啦。你的代码本身没问题，是运行方式的锅！

解决办法 #

1. 手动用Kotlin命令行编译运行 #

这是最直接的临时方案，适合快速验证：

• 打开终端，进入你的tictactoe项目目录
• 执行编译命令，把所有.kt文件打包成可运行的jar：

  kotlinc main.kt board.kt -include-runtime -d tictactoe.jar
  

• 运行生成的jar文件：

  java -jar tictactoe.jar
  

2. 修改VSCode Code Runner的配置，自动编译所有文件 #

如果不想每次手动敲命令，可以调整Code Runner的执行脚本，让它自动处理同目录下的所有Kotlin文件：

• 打开VSCode设置（快捷键Ctrl+,），搜索「Code Runner: Executor Map」
• 找到Kotlin对应的配置项，替换成以下命令：
  • Windows系统：

    "kotlin": "kotlinc *.kt -include-runtime -d temp.jar && java -jar temp.jar && del temp.jar"
    

  • Mac/Linux系统：

    "kotlin": "kotlinc *.kt -include-runtime -d temp.jar && java -jar temp.jar && rm temp.jar"
    

  这样每次点击Code Runner的运行按钮时，它会先编译当前目录下所有.kt文件，运行后自动删除临时jar文件。

3. 用Gradle/Maven构建项目（推荐长期方案） #

如果后续要扩展井字棋的功能，建议用构建工具管理项目：

• 创建标准的Kotlin项目结构，把main.kt和board.kt放到src/main/kotlin目录下
• 用Gradle初始化项目（可以用gradle init命令选择Kotlin应用模板）
• 之后通过Gradle的run任务运行项目，构建工具会自动处理所有文件的编译和依赖，完全不会出现跨文件引用的问题。

补充说明 #

你的board.kt里的TicTacToeBoard类默认是public访问权限，完全没问题，不是权限导致的找不到引用。核心问题就是编译范围没覆盖到所有相关文件～

内容的提问来源于stack exchange，提问作者Davi A. Sampaio