Turn Chinese interface copy into maintainable Vue locale keys without leaving VS Code.
LocaleSail is focused on one migration workflow: find Chinese text in Vue and TypeScript, write it to a locale JSON file, replace the source text with vue-i18n calls, and optionally split a large locale file into typed modules.
What LocaleSail does
| Step | Result |
|---|---|
| Extract | Finds Chinese copy in Vue templates, attributes, scripts, TypeScript, and template literals. |
| Replace | Converts matching copy to $t(...), this.$t(...), or t(...) calls for the current code context. |
| Inspect | Shows locale values for keys in the editor and refreshes the result after edits. |
| Organize | Flattens or restores nested JSON and builds directory-based JavaScript or TypeScript locale modules. |
LocaleSail preserves template interpolation values as i18n parameters, supports Vue 3 <script setup>, and can append new entries to existing split modules without replacing their comments or formatting.
Quick start
- Install LocaleSail for Vue i18n from the Visual Studio Marketplace.
- Set
localeSail.defaultLocalesPathif your locale directory is notsrc/locales. - Open a
.vue,.js, or.tsfile and run LocaleSail: Extract Chinese Copy. - Review the generated locale JSON, then run LocaleSail: Replace Copy with i18n Keys.
Release 0.2.0 introduces the independent localeSail.* settings namespace. Settings saved under the pre-0.2 namespace must be entered again with the new keys.
Workspace-level settings are now generated as localesailrc.json; existing richierc.json files remain supported as a compatibility fallback.
Commands
| Command | Default shortcut |
|---|---|
| Extract Chinese Copy | Ctrl+Alt+U / Ctrl+Cmd+U |
| Replace Copy with i18n Keys | Ctrl+Alt+I / Ctrl+Cmd+I |
| Preview Translation Values | Ctrl+Alt+O / Ctrl+Cmd+O |
| Create Workspace Configuration | Ctrl+Alt+G / Ctrl+Cmd+G |
| Build Split Locale Modules | Explorer or editor context menu on a JSON file |
See the detailed behavior guide for extraction rules, replacement forms, JSON paths, and all settings.
Project links
License and lineage
LocaleSail for Vue i18n is distributed under the MIT License. It began as a fork of RichieChoo/vue-swift-i18n; the original copyright notice remains in LICENSE, and subsequent LocaleSail changes are maintained independently by Eyaa.