# intlify/vue-i18n `vue-i18n` > Vue.js 的国际化插件 **版本：** 11.3.0（2026 年 3 月） **部署：** @vue/devtools-api@^6.5.0、@intlify/core-base@11.3.0、@intlify/devtools-types@11.3.0、@intlify/shared@11.3.0 **标签：** rc：9.0.0-rc.9（2 月） 2021 年），alpha：9.2.0-alpha.9（2021 年 7 月），旧版：8.28.2（2022 年 10 月），边缘：9.3.0-beta.14-77e850b（2023 年 1 月），beta：9.3.0-beta.27（2023 年 8 月），下一个：12.0.0-alpha.3 （2025 年 7 月），稳定：11.1.10（2025 年 7 月），legacy10：10.0.8（2025 年 7 月），stable9：9.14.5（2025 年 7 月），legacy9：9.14.5（2025 年 7 月），最新：11.3.0（2026 年 3 月） **参考文献：** [文档]() — API 参考、指南 ## API 变更本节记录了特定于版本的 API 更改 - 优先考虑最近的主要/次要版本。 * 已弃用：旧版 API 模式 - 在 v11 中已弃用，用于组合 API 首选项；计划在 v12 中删除 [源]() * 已弃用：自定义指令 `v-t` — 由于 Vue 3 中的优化优势有限，在 v11 中已弃用；计划在 v12 中删除 [源]() * 重大问题：`tc` 和 `$tc` — 在旧版 API 模式的 v11 中被删除；在 `t` 和 `$t` 中使用复数支持 [来源]() * 新功能：Vue 3 Vapor 模式 - 在 v11.2.0 中添加了对 Vue 3 Vapor 模式的兼容性 [来源]() * BREAKING：JIT 编译 - 在 v10 中默认启用，以解决 CSP 问题并支持动态资源 [来源]() * 重大问题：`$t` 和 `t` 签名 - v10 中对旧版 API 模式签名进行了更改，以匹配 Composition API 模式；位置语言环境参数现在需要选项对象[源]() * 新功能：生成的区域设置类型 - v10 添加了对通过“GeneeratedTypeConfig”扩展区域设置类型的支持，以实现更好的 TypeScript 推理 [来源]() * 破坏：模 `%` 语法 — 使用 v10 中删除的模语法进行命名插值；使用标准 `{}` 插值 [来源]() * BREAKING：`vue-i18n-bridge` — 在 Vue 2 EOL 之后在 v10 中删除 [来源]() * 重大问题：`allowComposition` 选项 — 在 v10 中被删除；之前用于 v9 上的 Legacy 到 Composition API 迁移 [来源]() **还更改了：** `petite-vue-i18n` GA v10 · 可配置的 `$i18n` 类型新 v11.1.0 · `mode` 属性已弃用 v11 · `tm` 接受 `DefineLocaleMessage` 键类型 v11.0.0 · 部分选项支持 `$n` 和 `$d` 新 v11.1.4 ## 最佳实践 * 对于所有新项目，首选组合 API 模式（“legacy: false”）——旧版 API 模式在 v11 中已弃用，并将在 v12 中删除[来源]() * 在“v-t”指令上使用“t()”函数或“”组件 - 该指令在 v11 中已弃用，并且缺乏对按键补全的 IDE 支持[来源]() * 使用“DefineLocaleMessage”、“DefineDateTimeFormat”和“DefineNumberFormat”接口定义全局资源模式 — 在“useI18n”中启用自动类型推断和键完成，无需传递类型参数[来源]() * 在处理通过“tm()”检索的语言环境消息时使用“rt()”（解析翻译）——确保正确解析嵌套结构以及以编程方式访问的消息的复数化 * 在将“v-html”与包含用户输入的翻译一起使用时启用“escapeParameter: true”——通过转义插值参数和中和危险的 HTML 属性来防止 XSS * 显式配置“__VUE_I18N_FULL_INSTALL__”和“__VUE_I18N_LEGACY_API__”功能标志 - 在捆绑器配置中将这些设置为“false”可以实现更好的树摇动并减少捆绑包大小[来源]() * 使用“@intlify/unplugin-vue-i18n”预编译语言环境消息 — 通过使用 AST/Functions 提高性能，并通过在运行时编译期间避免“eval”来确保 CSP 合规性[来源]() * 使用动态“import()”和“setLocaleMessage()”实现区域设置消息的延迟加载——仅在需要时加载语言资源（例如，在路由器防护中），从而减少初始包大小[来源]() * 切换语言环境时同步“html”“lang”属性和“Accept-Language”标头 — 确保可访问性（屏幕阅读器）和服务器端请求的一致语言处理[来源]()

Vue I18n 技能

包含技能