本文介绍一种面向俄语输入场景的拉丁→西里尔字符映射方法，适用于“键盘盲打式”转写（如 "ghbdtn" → "привет"），而非标准音译；重点讲解基于规则映射的轻量实现方案及关键注意事项。
在俄语母语者日常输入中，常使用标准 QWERTY 键盘按俄语字母发音或位置进行“盲打式”输入：例如，QWERTY 键盘上 g 键位于标准俄语键盘 п 键位置，h 对应 р，b 对应 и……由此形成 "ghbdtn" → "привет" 这类非语音、纯布局映射关系。这与 transliteration（如 "privet" → "привет"）有本质区别——后者依赖发音规则，前者依赖键盘布局映射。
值得注意的是：unidecode 库并不支持此类布局映射。其设计目标是将 Unicode 字符（如带重音的拉丁字母）音译为 ASCII 近似形式，对俄语的 'ru' 参数仅用于优化音译质量，无法识别或处理 QWERTY 与俄语键盘（ЙЦУКЕН）的物理键位对应关系。因此，原答案中 unidecode(input_text, 'ru') 对 "ghbdtn" 的输出实为巧合（因 unidecode 内部未定义该字符串的映射，可能返回空或原始字符串），该代码无法稳定实现预期功能。
✅ 正确做法是构建明确的键位映射表（QWERTY → ЙЦУКЕН）：
def latin_to_cyrillic_qwerty(text: str) -> str:
# QWERTY 键盘按键到俄语 ЙЦУКЕН 键盘的直接映射（小写）
mapping = {
'q': 'й', 'w': 'ц', 'e': 'у', 'r': 'к', 't': 'е', 'y': 'н', 'u': 'г', 'i': 'ш',
'o': 'щ', 'p': 'з', '[': 'х', ']': 'ъ', 'a': 'ф', 's': 'ы', 'd': 'в', 'f': 'а',
'g': 'п', 'h': 'р', 'j': 'о', 'k': 'л', 'l': 'д', ';': 'ж', "'": 'э', 'z': 'я',
'x': 'ч', 'c': 'с', 'v': 'м', 'b': 'и', 'n': 'т', 'm': 'ь', ',': 'б', '.': 'ю',
'/': '.'
}
# 支持大写字母：先转小写映射，再根据原大小写恢复
result = []
for char in text:
lower_char = char.lower()
if lower_char in mapping:
mapped = mapping[lower_char]
# 保持原大小写：若原字符为大写且映射结果为字母，则转大写
if char.isupper() and mapped.isalpha():
mapped = mapped.upper()
result.append(mapped)
else:
result.append(char) # 未定义字符保持不变（如数字、空格等）
return ''.join(result)
# 示例使用
print(latin_to_cyrillic_qwerty("ghbdtn")) # 输出：привет
print(latin_to_cyrillic_qwerty("GHBDTN")) # 输出：ПРИВЕТ
print(latin_to_cyrillic_qwerty("Hello!")) # 输出：Хелло!⚠️ 使用注意事项：
- 该映射严格遵循 US QWERTY → Russian ЙЦУКЕН 物理键位对应，不涉及语言学规则；
- 标点符号（如 [, ;, '）也按键盘位置映射，需根据实际需求调整；
- 若需支持更复杂场景（如 AltGr 组合键、旧式打字机映射、或乌克兰语/保加利亚语），应扩展映射表或切换至专用库（如 keyboard-layout）；
- 生产环境建议添加输入校验、异常处理，并考虑 Unicode 规范化（如 NFC）。
总结：实现拉丁到西里尔的“盲打式”转换，核心在于建立准确的键盘布局映射表，而非依赖通用音译库。手动构建映射既轻量可控，又可精准适配特定语言和输入习惯，是此类场景下最可靠、最易维护的解决方案。
