Lingo.dev + .csv（数据）

Lingo.dev CLI 翻译 CSV 文件，同时保留结构、标题和数据完整性，用于内容管理和数据本地化。CLI 保持精确的 CSV 格式和分隔符，保持列名不变，仅处理文本内容，同时保留数字和日期，安全处理 UTF-8 和各种字符编码，并与 Excel、Google Sheets 和数据库导入无缝协作。

快速设置

为基于语言环境命名的 CSV 文件配置：

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "csv": {
      "include": ["data/[locale].csv"]
    }
  }
}

提醒：[locale] 是一个占位符，在 CLI 运行期间会被实际的语言环境替换，因此应在配置中保持原样。

翻译 CSV 数据

npx lingo.dev@latest i18n

在翻译指定列中的文本内容时，保留 CSV 的结构、标题和数据类型。

CSV 结构处理

带标题的内容

id,title,description,category
1,"Getting Started","Learn the basics quickly","Tutorial"
2,"Advanced Features","Deep dive into advanced topics","Guide"
3,"API Reference","Complete API documentation","Reference"

标题保持不变，可翻译的内容会被本地化。

混合数据类型

product_id,name,price,description,created_date
SKU001,"Premium Widget",29.99,"High-quality widget for professionals","2024-01-15"
SKU002,"Basic Tool",9.99,"Simple tool for everyday use","2024-01-16"

仅翻译文本列；数字、日期和 ID 保持不变。

高级功能

自定义分隔符支持

支持各种 CSV 方言：

• 逗号分隔：value1,value2,value3
• 分号分隔：value1;value2;value3
• 制表符分隔：value1 value2 value3

引号处理

title,content,tags
"Article Title","Content with ""quotes"" inside","tag1,tag2"
"Another Article","Simple content","single-tag"

保留 CSV 的引号和转义约定。

高级配置

多个 CSV 文件

"csv": {
  "include": [
    "data/[locale].csv",
    "content/[locale]/*.csv"
  ]
}

锁定特定列

"csv": {
  "include": ["data/[locale].csv"],
  "lockedKeys": ["id", "price", "created_date", "status"]
}

使用列标题作为键，以防止特定列被翻译。