如何在IntelliJ中调试Kotlin/Native(linuxX64)应用？

1. 确保Gradle构建生成调试符号 #

打开项目的build.gradle.kts（或build.gradle），检查Kotlin Native目标配置，确保开启调试信息生成：

kotlin {
    linuxX64 {
        binaries {
            executable {
                // 强制生成调试符号，让断点能被识别
                debuggable = true
                // 关闭编译优化，避免断点位置偏移或失效
                optimize = false
            }
        }
    }
}

修改后执行./gradlew clean清理旧构建产物，再重新执行构建任务。

2. 手动创建Native调试配置 #

如果IDE未自动生成官方文档提到的Native调试配置，手动添加：

• 点击IDE右上角运行配置下拉框，选择「Edit Configurations...」
• 点击左上角「+」按钮，选择「Native Application」类型
• 配置核心参数：
  • Name：自定义命名（比如「Kotlin Native Debug」）
  • Executable：选择项目构建后的可执行文件，路径通常为build/bin/linuxX64/debugExecutable/[项目名称].kexe
  • Working directory：设置为项目根目录
• 保存配置后，选择该配置启动调试

3. 校验IDE与插件版本兼容性 #

• 确保IntelliJ IDEA版本在2022.3及以上，旧版本对Kotlin Native调试支持存在缺陷
• 检查「Kotlin」插件版本与项目依赖的Kotlin版本完全一致（比如项目用1.9.20，插件也需对应1.9.20）
• 版本不匹配时，在「Settings → Plugins → Kotlin」中更新插件，或在build.gradle.kts中同步项目Kotlin版本

4. 检查系统调试工具依赖 #

Linux下Kotlin Native调试依赖gdb，在终端执行以下命令验证是否安装：

gdb --version

未安装则通过包管理器安装（如Ubuntu/Debian：sudo apt install gdb）

5. 重置IDE缓存 #

若以上方法无效，尝试重置IDE缓存：

• 关闭IntelliJ，删除Linux下的IDE缓存目录（路径一般为~/.cache/JetBrains/IntelliJIdea[版本号]）
• 重新打开IDE，导入项目并重新构建

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