news 2026/9/18 14:39:19

如何解决 Kotlin/Native 在 Windows 下 main 函数的 args 乱码?

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何解决 Kotlin/Native 在 Windows 下 main 函数的 args 乱码?

之前在用 Kotlin/Native 写 codex-kkp 的时候遇到了一个问题:
当我尝试在 Windows 的命令行上向它的产物 exe 传递参数的时候,传入的中文参数会变成我们熟悉又陌生的乱码“锟斤拷”。

codex-kkp-cli.exe"分析代码"# 实际收到的参数变成了乱码

问题分析

那么为什么会这样呢?众所周知,“锟斤拷”系列的乱码通常是 GBK 和 UTF-8 之间的错误转码导致的。
而又众所周知,Windows 存在两套字符API:GBK 是 Windows 默认的中文系统编码(A 版本, ANSI),
UTF-16 则是内核的原生编码(W 版本, 宽、Unicode)。

参考文档:

  • Windows API 中的 Unicode
  • 代码页

而 Kotlin/Native mingwX64 平台 的 main 函数编译后会使用 ANSI 版本的API的入口点:

launcher.cpp#L72-L78
中的Konan_main函数:

extern "C" RUNTIME_EXPORT int Konan_main(int argc, const char** argv) { return Init_and_run_start(argc, argv, 1); }

和 StubIrDriver.kt#L225-L232
里面生成的 main 函数:

out("extern int Konan_main(int argc, char** argv);") out("") out("__attribute__((__used__))") out("int $entryPoint(int argc, char** argv) {") out(" return Konan_main(argc, argv);") out("}")

也就是:

extern int Konan_main(int argc, char** argv); int main(int argc, char** argv) { return Konan_main(argc, argv); }

它没有使用wmainwchar_t** argv,所以它使用的是 ANSI 的 API 而不是 Unicode 的那个。

这个问题在 YouTrack 上也有相关记载:

  • KT-82801: Kotlin/Native: Windows Non-ASCII command-line arguments garbled characters
  • KT-80201: K/N: Windows main(args) receives corrupted Unicode arguments

在 KT-80201 中,也有热心网友贴出了解决方案,这也是接下来要进行介绍的内容。

解决方案

如果你比较熟悉 Windows 的 API,那么应该很快就能想到该如何了解。但是我就不一样了,我对这类 native 相关的东西一窍不通(

OK 言归正传,由于 Kotlin 的main函数接收到的args已经是处于乱码状态的错误参数,因此我们不能直接使用这个args了,
而是要用 Windows 的 W 版本 API 来直接获取通过 UTF-16 编码的正确参数,以此绕过 ANSI 的入口点带来的错误结果。

那么怎么绕开呢?说难也不难,我们可以直接通过platform.windows.GetCommandLineW()来获取 UTF-16 的命令行参数。
完整代码参考如下:

fun getUnicodeArgs(): Array<String> = memScoped { // 获取原始的 UTF-16 命令行 val commandLine = GetCommandLineW() ?: return@memScoped emptyArray() // 解析命令行为参数数组 val argc = alloc<IntVar>() val argv = CommandLineToArgvW(commandLine.toKString(), argc.ptr) ?: return@memScoped emptyArray() try { val argCount = argc.value if (argCount <= 1) { // 只有程序名本身,没有其他参数 return@memScoped emptyArray() } // 转换参数(跳过程序名) Array(argCount - 1) { index -> argv[index + 1]?.toKStringFromUtf16() ?: "" } } finally { LocalFree(argv) } }

通过GetCommandLineW获取到W版本的命令行参数,然后通过CommandLineToArgvW将它们解析为参数数组,
随后将程序名之后的真正的 args 们通过toKStringFromUtf16转化为 Kotlin String 之后就得到了之最终我们需要的东西:
不乱码的 args 数组。

在一个 KMP 项目中,我们现在可以通过expect/actual来实现 mingwX64 平台下对参数的解析(至少我现在是这么做的):

// commonMain - 声明期望函数 internal expect fun resolveArgs(args: Array<String>): Array<String> // appleMain & linuxMain - 直接返回原参数(这些平台默认 UTF-8) internal actual fun resolveArgs(args: Array<String>): Array<String> = args // mingwMain - 使用 Windows Unicode API 重新获取参数 internal actual fun resolveArgs(args: Array<String>): Array<String> { // ... Unicode 处理逻辑 }

main方法中:

fun main(args: Array<String>) { val processedArgs = resolveArgs(args) // 接下来使用 processedArgs 而不是 args(你直接用 args 覆盖也行) }

总结

根据 KT-80201 的状态,至少目前来看官方还没有解决这个问题。
如果你比较关心这个问题的话,可以追踪下这个 issue,跟踪它的未来进展。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/18 12:02:10

AI训练平台性能优化完整实战指南:从瓶颈定位到架构调优

Universe作为业界领先的AI通用智能训练平台&#xff0c;承载着跨越全球游戏、网站和应用程序的复杂训练任务。在日益增长的AI训练需求下&#xff0c;性能优化成为提升训练效率、降低计算成本的关键所在。本文将系统性地介绍如何从基础分析到架构调优&#xff0c;全面优化AI训练…

作者头像 李华
网站建设 2026/9/16 19:49:34

重磅部署“人工智能+” 推动一二三产业向智能化跃迁​

人工智能将“”到科学技术、产业发展、消费提质、民生福祉、治理能力、全球合作6大重点领域。8月26日&#xff0c;《关于深入实施“人工智能”行动的意见》&#xff08;以下简称《意见》&#xff09;正式发布。《意见》围绕前述六大重点领域&#xff0c;深入分析人工智能对各行…

作者头像 李华
网站建设 2026/9/17 10:25:28

EmotiVoice在教育类APP中实现情感化朗读功能

EmotiVoice在教育类APP中实现情感化朗读功能 在一款儿童英语学习APP中&#xff0c;同样的句子“Great job!”如果由机械平淡的语音说出&#xff0c;孩子可能只是扫一眼就划走&#xff1b;但如果这句话带着笑意、语调上扬、充满真诚鼓励地播放出来&#xff0c;孩子的脸上往往会浮…

作者头像 李华
网站建设 2026/9/17 17:07:14

Java 线程池(第十篇):(收官篇)CompletableFuture 异步编排实战 —— 多任务并行、结果汇总、超时控制与线程池协作

completableFuture 异步编排实战 —— 多任务并行、结果汇总、超时控制与线程池协作 如果说前 1–9 篇解决的是 “线程池如何安全、稳定地跑”&#xff0c; 那么这一篇解决的是&#xff1a; 如何把多个异步任务“编排”成一个可读、可控、可维护的并发流程。 这正是现代 Java …

作者头像 李华
网站建设 2026/9/17 21:59:33

EmotiVoice在冥想引导音频中的舒缓语气呈现

EmotiVoice在冥想引导音频中的舒缓语气呈现 在快节奏的现代生活中&#xff0c;越来越多的人开始通过冥想缓解焦虑、提升专注力。而一段真正有效的冥想引导音频&#xff0c;往往不在于说了什么&#xff0c;而在于“怎么说”——语速是否柔和&#xff1f;停顿是否有呼吸感&#x…

作者头像 李华
网站建设 2026/9/17 14:13:05

EmotiVoice性能评测:响应速度、清晰度与情感丰富度全解析

EmotiVoice性能评测&#xff1a;响应速度、清晰度与情感丰富度全解析 在虚拟助手越来越“懂人心”、游戏NPC开始“真情流露”的今天&#xff0c;语音合成技术早已不再是简单的文字朗读。用户不再满足于“能听清”&#xff0c;而是期待“听得动情”。传统TTS系统虽然解决了“说什…

作者头像 李华