VietTelex：macOS 越南语输入法

项目简介

VietTelex（ViệtTelex / ViếtTelex）是面向 macOS 的越南语输入法，支持 Telex 和 VNI 两种输入方式。它作为系统输入法（IMKit）直接集成到 macOS，会为每个应用自动选择合适的输入方式，让字符出现在正确位置并减少下划线。Terminal、浏览器、表格等应用都能使用。

设计上尽量简洁：安装完即可输入，高级选项需要时再打开。项目由 Phil Trịnh 以 MIT 许可开源。

菜单栏输入法菜单	设置窗口

主要功能

• macOS 系统集成：作为系统输入法工作，兼容按应用自动切换输入法、拼写检查、撤销和 VoiceOver。
• 响应快：据 benchmark，每个按键处理约 130 ns，连续输入依然流畅。
• 多应用可用：从 Terminal/iTerm 到 Chrome 地址栏、Excel 和 Spotlight，VietTelex 会为每个应用寻找合适的输入方式。
• 保留英文与代码：自动还原 google、github 等词，能识别 camelCase 写法（如 OmS、JavaScript），并提供严格 Telex 选项。
• 经过测试的准确率：在 9,091 个用例的测试集中，越南语词处理正确率 100%，被变形的英文词还原率 98.9%。
• 注重隐私：不收集用户输入的内容；仅在检查更新（手动或每周计划）或主动在设置中下载 Apple 语言包时联网，更新只在用户选择时才下载。

安装与使用

安装方式二选一（不要并行安装，两者会写入同一个 app）：

• Homebrew：

brew install --cask ptrinh/viettelex/viettelex

• 或从官网下载页 / Releases 下载 VietTelex-x.y.z.pkg（已签名 + notarized），双击后按提示操作，会自动安装到用户目录、注册输入法并打开系统设置 → 键盘。

安装后在 Input Sources → Edit… / ＋ → Vietnamese → ViệtTelex → Add 中添加：

① Input Sources → Edit…	② ＋ → Vietnamese → ViệtTelex → Add

要在 Terminal、iTerm、Chrome/Edge/Brave 中输入，需要在隐私与安全性中授予 VietTelex 权限：macOS 26 及更早为 Accessibility，macOS 27 为 Device Control and Data Access。用 🌐 键或 ⌃Space 切换越南语/英语（macOS 会按应用记住）。

Telex 输入法：s f r x j 分别对应 sắc、huyền、hỏi、ngã、nặng 五个声调，aa ee oo 得到 â ê ô，aw ow uw 得到 ă ơ ư，dd 得到 đ，z 删除声调。例如 vieejt → việt，truowngf → trường，hoas → hóa。

VNI 输入法：在设置的「Gõ phím」标签中选择 VNI，用数字键输入声调：1-5 为五个声调，6 = â/ê/ô，7 = ơ/ư，8 = ă，9 = đ，0 = 去声调，例如 Vie6t5 → Việt。建议开启拼写检查，避免 mp3 之类的字符串被误判为声调。

注意事项

• 密码输入框无法输入越南语：VietTelex 会在 secure field 中自动停用，这是正常的安全行为。
• 彻底卸载需删除 ~/Library/Input Methods/VietTelex.app 后重新登录；如要清除个人设置，再删除 ~/Library/Preferences/com.viettelex.settings.plist。用 Homebrew 安装则执行 brew uninstall --cask viettelex。
• 从 Homebrew 切换到 .pkg 前，先运行 brew uninstall --cask viettelex；反向切换时先切到 ABC、退出 VietTelex 并删除上述路径下的 app，再运行 Homebrew 命令。
• 如果已经开启权限但仍提示缺少权限，可执行 tccutil reset Accessibility com.viettelex.inputmethod.telex，然后切换输入法或重新登录再授权。
• 如果某个应用的输入有问题，可在设置的「Ứng dụng」标签中为该应用单独选择输入方式，保留「Tự động」即可自动处理。

本作品整理自 GitHub 开源项目 ptrinh/viettelex，原作者 @ptrinh，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。