求助：如何使用 Svelte-i18n CLI 工具？

架构老林

2026-7-6

Svelte-i18n CLI 使用指引

1. 安装CLI工具

CLI是svelte-i18n包的内置工具，无需单独安装，确保项目中已安装该包即可：

npm install svelte-i18n --save-dev
# 或使用yarn
yarn add svelte-i18n --dev

2. 核心命令：提取翻译键

CLI最常用的功能是提取代码中的翻译键，生成/更新语言文件，核心命令为extract：

npx svelte-i18n extract [选项]

3. 常用参数说明

指定扫描目录：通过--src（缩写-s）设置要扫描的代码目录，默认值为src
```
npx svelte-i18n extract --src ./src/pages
```
指定输出目录：通过--out（缩写-o）设置语言文件的输出位置，默认值为locales
```
npx svelte-i18n extract --out ./i18n
```
设置基准语言：通过--default-language（缩写-d）指定基准语言，默认值为en
```
npx svelte-i18n extract --default-language zh-CN
```
合并现有翻译：通过--merge（缩写-m）保留已有翻译，仅新增未存在的键，避免覆盖
```
npx svelte-i18n extract --merge
```

4. 配置文件简化操作

在项目根目录创建i18n.config.js，统一配置CLI参数，无需每次命令行输入：

module.exports = {
  src: './src',
  out: './locales',
  defaultLanguage: 'zh-CN',
  merge: true,
  ignore: ['**/node_modules/**', '**/*.test.js'] // 忽略指定文件/目录
};

配置完成后，直接运行简化命令：