cuecode

cuecode 是一个用于批量修复 .cue 文件中文乱码的命令行工具。

它会递归扫描指定目录及其子目录中的 .cue 文件：

• 如果文件已经是 UTF-8 且包含中文：跳过
• 如果文件不是 UTF-8：尝试按 GB18030、GBK、Big5 解码
• 解码后检测到中文：转换并写回 UTF-8

该工具主要用于 CDImage.cue 这类在播放器/系统中中文显示异常的问题。

特性

• 递归扫描目录下所有 .cue 文件
• 自动识别并转换常见中文编码（GB18030/GBK/Big5）
• 仅在“检测到中文且可可靠解码”时才转换，尽量避免误改
• 支持 dry-run 预览模式
• 输出详细统计信息

环境要求

• Go 1.23+

构建

go build -o cuecode .

用法

基本用法

./cuecode -dir /path/to/music

只预览不写回

./cuecode -dir /path/to/music -dry-run

显示跳过详情

./cuecode -dir /path/to/music -v

参数说明

• -dir：要扫描的根目录，默认当前目录 .
• -dry-run：只打印将要转换的文件，不实际写入
• -v：输出更多跳过信息

输出说明

运行结束后会输出汇总：

完成: 扫描=10, 已转换=3, 已是UTF-8=2, 跳过=5, 失败=0

• 扫描：命中的 .cue 文件数量
• 已转换：成功从非 UTF-8 转为 UTF-8 的文件数
• 已是UTF-8：本身已是 UTF-8 且包含中文的文件数
• 跳过：未检测到可转换中文或不满足转换条件的文件数
• 失败：读写错误等异常文件数

退出码

• 0：执行成功且无失败
• 1：程序执行中发生整体错误（如参数或遍历层面错误）
• 2：任务执行完成，但有部分文件处理失败

注意事项

• 工具会原地覆盖写回已转换文件，建议首次使用先加 -dry-run 预览。
• 当前仅针对中文相关编码场景（GB18030/GBK/Big5）做转换。