I18n Helper

This automates the grunt work of adding i18n to your codebase by scanning for hardcoded strings, generating locale files in the right format for your framework (react-intl, vue-i18n, i18next, gettext, etc.), and replacing text with translation calls. It's smart enough to skip variable names and import paths while flagging actual UI text, and it'll check translation completeness across languages so you know what's missing. The workflow is straightforward: it detects your project type, extracts strings, generates properly formatted locale files, rewrites your code with translation functions, and reports on coverage. Saves hours of manual find-and-replace when internationalizing an existing app, though you'll still need to review the automated replacements to make sure context is preserved.

GitHub stars: 328
last updated: May 13, 2026

View on GitHub

Install

$ npx -y skills add laolaoshiren/claude-code-skills-zh --skill i18n-helper --agent claude-code

Installs into .claude/skills of the current project.

Files

🌍 i18n-helper — 国际化/本地化助手

触发条件

当用户要求以下操作时激活此技能：

扫描代码中的硬编码中文/英文文本
为项目添加国际化支持（i18n）
批量提取和翻译语言文件
检查翻译完整性（缺失 key 检测）

工作流程

1. 项目分析

检测项目类型（React/Vue/Angular/Node.js/Python/Java 等）
识别已使用的 i18n 框架（react-intl, vue-i18n, i18next, gettext 等）
扫描源代码目录结构

2. 硬编码文本扫描

在 .js/.jsx/.ts/.tsx/.vue/.py/.java/.go 等文件中搜索硬编码字符串
排除：变量名、URL、正则表达式、import 路径、日志调试信息
标记：用户可见的 UI 文本、错误提示、通知消息

3. 语言文件生成

根据项目框架生成对应格式：

JSON (i18next/react-intl): { "key": "value" }
YAML (vue-i18n): key: value
PO/POT (gettext): 标准格式
Properties (Java): key=value

4. 代码替换

将硬编码文本替换为 i18n 函数调用
保持原有格式和变量插值

示例：

// 替换前
alert('保存成功');
// 替换后
alert(t('alert.saveSuccess'));

5. 完整性检查

对比主语言文件与翻译文件的 key 差异
输出缺失翻译的 key 列表
统计翻译完成度百分比

输出格式

## 📊 i18n 扫描报告

### 硬编码文本
| 文件 | 行号 | 内容 | 建议 key |
|------|------|------|----------|
| src/App.tsx | 42 | '欢迎使用' | page.welcome |

### 语言文件
已生成 `locales/zh-CN.json` 和 `locales/en-US.json`

### 翻译完整性
- zh-CN: 45/45 (100%) ✅
- en-US: 42/45 (93.3%) ⚠️ 缺少 3 个 key

SKILL.md on GitHub