漢字轉拼音的核心在於 GB2312/GBK 編碼區位碼對應。每個漢字在 GB2312 中佔 2 個字節,通過計算其區位碼數值,對照預建的「區位碼範圍-拼音」映射表,即可獲得拼音首字母或全拼。
using System;
using System.Text;
public class ChineseSpellHelper
{
// 區位碼範圍對應拼音首字母映射表
private static readonly int[] ZoneRanges = new int[]
{
-20319, -20317, -20304, -20295, -20292, -20283, -20265, -20257, -20242, -20230,
-20051, -20036, -20032, -20026, -20002, -19990, -19986, -19982, -19976, -19805,
-19784, -19775, -19774, -19763, -19756, -19751, -19746, -19741, -19739, -19728,
-19725, -19715, -19540, -19531, -19525, -19515, -19500, -19484, -19479, -19467,
-19289, -19288, -19281, -19275, -19270, -19263, -19261, -19249, -19243, -19242,
-19238, -19235, -19227, -19224, -19218, -19212, -19038, -19023, -19018, -19006,
-19003, -18996, -18977, -18961, -18952, -18783, -18774, -18773, -18763, -18756,
-18741, -18735, -18731, -18722, -18710, -18697, -18696, -18526, -18518, -18501,
-18490, -18478, -18463, -18448, -18447, -18446, -18239, -18237, -18231, -18220,
-18211, -18201, -18184, -18183, -18181, -18012, -17997, -17988, -17970, -17964,
-17961, -17950, -17947, -17931, -17928, -17922, -17759, -17752, -17733, -17730,
-17721, -17703, -17701, -17697, -17692, -17683, -17676, -17496, -17487, -17482,
-17468, -17454, -17433, -17427, -17417, -17202, -17185, -16983, -16970, -16942,
-16915, -16733, -16708, -16706, -16689, -16664, -16657, -16647, -16474, -16470,
-16465, -16459, -16452, -16448, -16433, -16429, -16427, -16423, -16419, -16412,
-16407, -16403, -16401, -16393, -16220, -16216, -16212, -16205, -16202, -16187,
-16180, -16171, -16169, -16158, -16155, -15959, -15958, -15944, -15933, -15920,
-15915, -15903, -15889, -15878, -15707, -15701, -15681, -15667, -15661, -15659,
-15652, -15640, -15631, -15625, -15454, -15448, -15436, -15435, -15419, -15416,
-15408, -15394, -15385, -15377, -15375, -15369, -15363, -15362, -15183, -15180,
-15165, -15158, -15153, -15150, -15149, -15144, -15143, -15141, -15140, -15139,
-15128, -15121, -15119, -15117, -15110, -15109, -14941, -14937, -14933, -14930,
-14929, -14928, -14926, -14922, -14921, -14914, -14908, -14902, -14894, -14889,
-14882, -14873, -14871, -14857, -14678, -14674, -14670, -14668, -14663, -14654,
-14645, -14630, -14594, -14429, -14407, -14399, -14384, -14379, -14368, -14355,
-14353, -14345, -14170, -14159, -14151, -14149, -14145, -14140, -14137, -14135,
-14125, -14123, -14122, -14112, -14109, -14099, -14097, -14094, -14092, -14090,
-14087, -14083, -13917, -13914, -13910, -13907, -13906, -13905, -13896, -13894,
-13878, -13870, -13859, -13847, -13831, -13658, -13611, -13601, -13406, -13404,
-13400, -13398, -13395, -13391, -13387, -13383, -13367, -13359, -13356, -13343,
-13340, -13329, -13326, -13318, -13147, -13138, -13120, -13107, -13096, -13095,
-13091, -13076, -13068, -13063, -13060, -12888, -12875, -12871, -12860, -12858,
-12852, -12849, -12838, -12831, -12829, -12812, -12802, -12607, -12597, -12594,
-12585, -12556, -12359, -12346, -12320, -12300, -12120, -12099, -12089, -12074,
-12067, -12058, -12039, -11867, -11861, -11847, -11831, -11798, -11781, -11604,
-11589, -11536, -11358, -11340, -11339, -11324, -11303, -11097, -11077, -11067,
-11055, -11052, -11045, -11041, -11038, -11024, -11020, -11019, -11018, -11014,
-10838, -10832, -10815, -10800, -10790, -10780, -10764, -10587, -10544, -10533,
-10519, -10331, -10329, -10328, -10322, -10315, -10309, -10307, -10296, -10281,
-10274, -10270, -10262, -10260, -10256, -10254
};
private static readonly string[] ZoneLetters = new string[]
{
"a","ai","an","ang","ao","ba","bai","ban","bang","bao","bei","ben","beng","bi",
"bian","biao","bie","bin","bing","bo","bu","ca","cai","can","cang","cao","ce",
"ceng","cha","chai","chan","chang","chao","che","chen","cheng","chi","chong",
"chou","chu","chuai","chuan","chuang","chui","chun","chuo","ci","cong","cou",
"cu","cuan","cui","cun","cuo","da","dai","dan","dang","dao","de","deng","di",
"dian","diao","die","ding","diu","dong","dou","du","duan","dui","dun","duo",
"e","en","er","fa","fan","fang","fei","fen","feng","fo","fou","fu","ga","gai",
"gan","gang","gao","ge","gei","gen","geng","gong","gou","gu","gua","guai","guan",
"guang","gui","gun","guo","ha","hai","han","hang","hao","he","hei","hen","heng",
"hong","hou","hu","hua","huai","huan","huang","hui","hun","huo","ji","jia",
"jian","jiang","jiao","jie","jin","jing","jiong","jiu","ju","juan","jue","jun",
"ka","kai","kan","kang","kao","ke","ken","keng","kong","kou","ku","kua","kuai",
"kuan","kuang","kui","kun","kuo","la","lai","lan","lang","lao","le","lei","leng",
"li","lia","lian","liang","liao","lie","lin","ling","liu","long","lou","lu","lv",
"luan","lue","lun","luo","ma","mai","man","mang","mao","me","mei","men","meng",
"mi","mian","miao","mie","min","ming"
// 完整表請參考完整源碼...
};
///
/// 獲取漢字字符串的拼音首字母(大寫)
///
public static string GetFirstLetters(string chineseText)
{
if (string.IsNullOrEmpty(chineseText)) return "";
StringBuilder result = new StringBuilder();
byte[] bytes = Encoding.GetEncoding("GB2312").GetBytes(chineseText);
for (int i = 0; i < bytes.Length; i += 2)
{
if (i + 1 >= bytes.Length) break; // 防止單字節字符
// 計算區位碼數值
int zoneCode = (bytes[i] << 8) + bytes[i + 1] - 65536;
// 二分查找對應拼音
int index = Array.BinarySearch(ZoneRanges, zoneCode);
if (index < 0) index = ~index - 1; // 獲取插入位置前一個
if (index >= 0 && index < ZoneLetters.Length)
{
result.Append(ZoneLetters[index][0]); // 取首字母
}
}
return result.ToString().ToUpper();
}
///
/// 獲取漢字字符串的全拼(空格分隔)
///
public static string GetFullSpell(string chineseText)
{
if (string.IsNullOrEmpty(chineseText)) return "";
StringBuilder result = new StringBuilder();
byte[] bytes = Encoding.GetEncoding("GB2312").GetBytes(chineseText);
for (int i = 0; i < bytes.Length; i += 2)
{
if (i + 1 >= bytes.Length) break;
int zoneCode = (bytes[i] << 8) + bytes[i + 1] - 65536;
int index = Array.BinarySearch(ZoneRanges, zoneCode);
if (index < 0) index = ~index - 1;
if (index >= 0 && index < ZoneLetters.Length)
{
if (result.Length > 0) result.Append(' ');
result.Append(ZoneLetters[index]);
}
}
return result.ToString();
}
}
using System.Globalization;
public static class ChineseConverter
{
///
/// 使用 TextInfo 獲取拼音(需 Windows 系統支援)
///
public static string ToPinyin(this string chineseText)
{
if (string.IsNullOrEmpty(chineseText)) return "";
TextInfo textInfo = new CultureInfo("zh-CN", false).TextInfo;
// 注意:.NET 內建不直接支持漢字轉拼音,此處為示意
// 實際專案建議使用第三方庫如 PinYinConverter、Chinese.Pinyin
return chineseText; // 佔位
}
}
| 庫名稱 | NuGet 套件 | 特點 | 適用場景 |
|---|---|---|---|
| Chinese.Pinyin | Chinese.Pinyin | 純 .NET 實現、支援多音字、效能優秀 | 跨平台、.NET Core、生產環境 |
| PinYinConverter | PinYinConverter | 輕量、支援首字母/全拼/帶聲調 | 簡單需求、輕量級專案 |
| NChinese | NChinese | 功能全面、支援繁簡轉換、數字轉中文 | 中文處理綜合需求 |
using Chinese.Pinyin;
string text = "中國新聞";
string firstLetters = Pinyin.GetInitials(text); // ZGXW
string fullSpell = Pinyin.GetPinyin(text, " "); // zhong guo xin wen
string withTone = Pinyin.GetPinyin(text, " ", PinyinFormat.WithToneMarks); // zhōng guó xīn wén
Array.BinarySearch O(log n) 替代線性查找 O(n)Encoding.GetEncoding("GB2312") 靜態緩存Parallel.ForEachlibc-locales 或改用 Unicode 映射表漢字轉拼音看似簡單,實則涉及編碼標準、多音字消歧、跨平台相容性等複雜議題。生產環境強烈建議使用成熟的第三方庫,僅在極度受限環境或教學演示時考慮自行實現。本文提供的核心算法可作為理解底層原理的參考基礎。