“厦门”的首字母是S？pinyin库的坑你踩过吗？

最近在项目里遇到个挺有意思的小坑，就是 pinyin 库把“厦门”的首字母识别成了“S”而不是“X”。这在程序中应该算是个bug了。为了让程序准确地处理拼音，我花了点时间了解后找到了一个解决方案，下面记录一下。

问题原因

原来是 pinyin 库在处理多音字时，会返回一个默认的拼音首字母。而“厦”这个字有两个读音，一个是“xià”，另一个是“shà”。结果，库给选了个错误的读音，把“厦”的首字母变成了“S”。

解决方案

既然 pinyin 库默认不太可靠，那我们就自己来搞定。我的思路是先定义一个多音字字典，把容易出问题的字提前标注好。然后在转换拼音的时候，先检查这个字典，如果字典里有，就用我们定义的首字母，没找到再用库里的转换。代码如下：

// 定义多音字字典
const polyphonicChars = {
  厦: "X",
  // 其他多音字及其正确拼音的首字母可以在这里添加
};

const result = list.map((m) => {
	const firstChar = m.name.charAt(0);
	let firstLetter;

	// 检查是否为多音字
	if (polyphonicChars[firstChar]) {
		firstLetter = polyphonicChars[firstChar];
	} else {
		const pinyinArray = pinyin(firstChar, {
			style: pinyin.STYLE_FIRST_LETTER,
		});
		firstLetter = pinyinArray[0][0].toUpperCase();
	}

	// 获取第一个字符的所有拼音
	m.firstLetter = firstLetter;
	return m;
});

代码解析

1. 定义多音字字典：通过一个对象 polyphonicChars 手动定义多音字及其正确拼音的首字母。在这个例子中，我们将“厦”的首字母定义为“X”。
2. 遍历列表并处理拼音：对列表中的每一项进行处理，首先获取名称的第一个字符 firstChar。
3. 检查是否为多音字：如果 firstChar 存在于 polyphonicChars 字典中，则直接使用字典中定义的首字母。
4. 获取拼音首字母：如果 firstChar 不在字典中，则使用 pinyin 库获取其拼音的首字母。
5. 更新对象：将获取到的首字母 firstLetter 赋值给对象的 firstLetter 属性。

通过这种方式，可以有效地解决 pinyin 库处理多音字时可能出现的错误，提高拼音转换的准确性。