如何调试打包完成的Multiplatform Compose Desktop macOS应用？

一、日志文件位置 #

• Mac上打包后的Compose桌面应用，默认日志会输出到用户目录下的~/Library/Logs/[你的应用包名]/文件夹，文件名通常是java0.log或按日期命名的日志文件，直接打开就能查看完整报错栈。
• 如果打包时自定义了日志配置（比如用java.util.logging），日志路径会遵循你的配置规则，需要检查对应的handler输出路径。

二、调试工具（类似adb） #

远程调试（JDB） #

1. 打包时修改应用启动配置，在build.gradle.kts的nativeDistributions块里，通过jvmArgs添加JVM参数：-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005。
2. 安装并启动应用后，在IntelliJ IDEA创建“Remote JVM Debug”运行配置，设置端口为5005，连接本地即可断点调试打包后的应用。

系统控制台日志 #

打开Mac自带的控制台应用（Console.app），在搜索框输入你的应用名称，就能捕获应用的系统级运行日志。

三、快速排查小技巧 #

• 把应用从dmg拖到本地后，直接在终端执行：open /Applications/[你的应用名].app，或者进入应用包内的Contents/MacOS目录运行二进制文件，终端会实时输出日志，能立刻看到报错细节。
• 优先检查资源文件路径，很多run模式正常但打包后报错的问题，都是资源未正确打包或路径读取逻辑在打包环境下失效导致的。

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