x18n - 面向任意框架的 i18n 检查、查看与管理工具集 - AiBoss

x18n 是一个与框架无关的国际化（i18n）工具集，用于对多语言资源做检查、查看与管理。据项目自述，它是 i18n-ally 的精神续作，把后者的概念推广成一套可在任意框架、任意运行环境中使用的工具，并采用更健壮、更可扩展的架构。它面向的是需要维护多语言文案的 Web 与移动项目团队：既包括在本地编辑器里逐条核对翻译的开发者，也包括希望在 CI 中自动拦截缺失键、未使用键的工程团队，还包括需要以脚本方式批量处理语言文件的自动化流程。

维护者与状态

仓库由 x18n-dev 维护，地址为 github.com/x18n-dev/x18n，采用 MIT 许可证。仓库创建于 2026-10-15，最后提交时间为 2026-11-03，属于相当年轻的项目。最新正式版本为 v0.1.8，发布于 2026-11-02，版本号仍处于 0.1.x 阶段。截至 2026-11-03，仓库星标数为 638。项目另有一个官网 x18n.dev，可作为文档与入口参考。

主要能力

以下能力均来自项目 README 的自述，未经过独立验证。

适配现有项目

45+ 预设、零配置：据项目说明，可自动识别 Vue、React、Angular、Svelte、Astro、Next.js、Nuxt、Flutter、Laravel、Rails、.NET 等项目的结构。
多格式支持：覆盖 JSON、JSON5、YAML、PO、Fluent、INI、Properties，以及 PHP 与 .NET 的资源文件。
命名空间：支持以 ns:key 形式的键来组织消息。
可扩展：README 称可通过插件自行添加格式、扫描器、检查项与预设。

保持资源健康

Lint 与检查：报告缺失键、未使用键、非法键、占位符不匹配与术语表违规，项目自述这些检查可直接用于 CI。
陈旧翻译检测：找出源文案在译文写就之后发生变更的条目。
查找缺失：针对任意语言报告并补齐缺失的键与翻译。
按文本搜索：在任意语言中按文本模糊或精确查找对应的键，并跳转到代码中的使用位置。
提取硬编码字符串：识别代码中写死的字符串，并将其移入语言文件。

面向自动化与 CI

README 称其提供翻译与审校用的提示词（prompt），以及稳定的 --json 输出，便于脚本与自动化代理调用。
提供针对既有译文的审校提示与检查项。

多端使用

同一套引擎可用于终端 CLI、浏览器 UI、VS Code、任意支持 LSP 的编辑器，以及 Vite 与 Nuxt DevTools。
支持行内注解与悬停预览，在代码中直接看到某个键的各语言文案。
支持「转到定义」与「查找引用」，从键跳到消息，或列出该键的全部使用处。
README 称可从 i18n Ally 迁移既有配置。

使用入口

仓库地址为 x18n-dev/x18n，官网为 x18n.dev。

据项目说明，命令行用法基于 @x18n/cli 包，通过包管理器直接执行即可，无需先全局安装：

pnpx @x18n/cli

上述命令会输出 i18n 资源的概览。执行检查：

pnpx @x18n/cli check

该命令对 i18n 资源做 lint 与检查，报告缺失键或未使用键。查看某个键的全部使用位置：

pnpx @x18n/cli usages nav.keys

启动浏览器中的交互式界面来管理资源：

pnpx @x18n/cli ui

除 CLI 外，项目还拆分为多个包：@x18n/core 为可在 Node 与浏览器中运行的引擎，包含领域模型、插件 API、分析与编辑能力；@x18n/builtins 提供内置的格式、语言查找器、使用扫描器、检查项、报告器与预设；@x18n/node 负责文件系统、配置与插件加载；@x18n/lsp 为语言服务器；@x18n/ui 与 @x18n/devtools 提供本地开发服务器、静态报告与 DevTools 面板；另有 x18n-vscode 与 x18n-zed 两个编辑器扩展。README 称，安装 VS Code 扩展后可在编辑器内直接渲染译文，并获得「转到定义」与「查找引用」支持；其他编辑器则可通过语言服务器获得类似能力。

许可与限制

项目采用 MIT 许可证，README 中标注版权归 Anthony Fu 所有。素材中未列出明确的硬件要求、性能指标或已知缺陷；项目自述的适用边界主要体现在版本阶段上——当前最新版本为 v0.1.8，仍属早期迭代，接口与包结构存在变动的可能。此外，README 中列出的框架预设、格式支持与编辑器集成均为项目自述，实际覆盖范围需以仓库文档与实测为准。对于依赖 CI 的团队，建议先在小范围项目中验证 --json 输出的稳定性，再接入流水线。