Kavita项目中的韩语文件名解析问题与解决方案

问题背景

在Kavita这款电子书管理软件中，用户在使用韩语环境时遇到了一个特殊的文件名解析问题。当用户尝试创建包含小数卷号的档案时（如"1.5권"或"1.5화"），系统无法正确识别这些小数卷号，而是将其识别为整数卷号（例如将1.5권识别为5권）。

技术分析

这个问题源于Kavita项目中用于解析韩语文件名的正则表达式模式存在不足。当前系统中使用的正则表达式模式为：

제?(?<Volume>\d+(\.\d)?)(권|회|화|장)

这个模式存在两个主要问题：

1. 小数部分的可选匹配不够完善，只能匹配单个小数位（如1.5），但无法匹配多位小数（如1.55）
2. 在匹配小数卷号时，系统会将小数点后的数字单独提取，导致1.5권被错误解析为5권

解决方案

经过技术团队的研究，提出了以下改进后的正则表达式模式：

제?(?<Volume>\d+(\.\d+)?)(권|회|화|장)

这个改进后的模式具有以下优势：

1. 使用\.\d+替代原来的\.\d，可以匹配任意位数的小数部分
2. 保持了原有匹配韩语卷号单位（권/회/화/장）的能力
3. 完整捕获整个小数卷号，避免小数点后数字被单独提取的问题

实现效果

使用改进后的正则表达式后，系统能够正确识别以下格式的韩语文件名：

• 주술회전 1.5권
• 주술회전 1.5화
• 주술회전 1.55권
• 주술회전 1.55화

文件名中的小数卷号将被完整保留，不再出现错误解析为整数卷号的情况。

技术意义

这个改进不仅解决了韩语用户面临的具体问题，也体现了国际化软件开发中需要考虑的各种语言特性。在处理多语言支持时，开发者需要注意：

1. 不同语言中数字表达方式的差异
2. 特殊字符（如小数点）在不同语言环境中的处理
3. 语言特有的计量单位（如韩语中的권/회/화/장）的识别

总结

Kavita团队通过优化韩语文件名解析的正则表达式，成功解决了小数卷号识别问题。这一改进将提升韩语用户的使用体验，同时也为软件的多语言支持树立了良好的范例。对于开发者而言，这个案例提醒我们在处理国际化问题时，需要充分考虑目标语言的特殊性和用户的实际使用场景。