QClaw生成i18n代码需执行五步：一、运行qclaw init --i18n --locales指定语言集；二、用注释+qclaw generate translations生成语义化键值；三、通过qclaw import导入CSV等翻译资源并校验；四、用qclaw setup framework-i18n适配Vue/Svelte语法；五、执行qclaw generate formats生成日期数字货币等文化适配配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用QClaw构建多语言前端项目，但尚未生成符合标准的i18n代码结构或翻译配置文件，则可能是由于未触发其多语言工程化模板或未指定目标语言集。以下是生成前端国际化i18n代码的具体操作路径：
一、调用QClaw多语言初始化指令
QClaw内置语言感知引擎，可基于自然语言需求自动推导所需语言包结构与资源组织方式，无需手动创建目录或JSON文件。该方法直接生成符合行业规范的i18n基础骨架。
1、在项目根目录打开终端，确保已安装QClaw CLI并完成身份认证。
2、执行命令：qclaw init --i18n --locales en,zh-CN,ja,es，其中 locales 参数明确声明支持的语言标识符。
立即学习“前端免费学习笔记（深入）”；
3、等待QClaw自动创建 /src/i18n/locales/en/translation.json、/src/i18n/locales/zh-CN/translation.json 等标准化路径及空翻译模板。
4、QClaw同步生成 /src/i18n/index.ts 与 /src/i18n/config.ts，包含语言切换逻辑、默认语言设置及类型安全定义。
二、使用自然语言描述生成带上下文的翻译键值对
QClaw支持语义化键名推导，能根据组件功能、UI位置和业务场景自动生成具备可读性与可维护性的翻译键（key），避免手工命名混乱或重复。
1、在任意React组件文件中添加注释块，格式为：// i18n: 登录页标题、密码错误提示、记住我复选框标签。
2、保存文件后，QClaw实时扫描注释并识别待翻译文本语义类别。
3、执行命令：qclaw generate translations --from-comments。
4、QClaw将自动向各 locale 的 translation.json 中注入结构化键值，例如："LoginPage.title": "Sign In", "LoginPage.error.password": "Incorrect password", "LoginPage.rememberMe": "Remember me"。
三、接入已有翻译资源进行智能映射与校验
当项目已存在Excel、CSV或XLIFF格式的翻译资产时，QClaw可执行双向对齐：将现有翻译内容注入代码结构，并检测缺失键、冗余键及格式异常项。
1、将翻译表保存为UTF-8编码的CSV文件，首行为 key,en,zh-CN,ja 列标题。
2、执行命令：qclaw import translations ./i18n-data.csv --strict。
3、QClaw解析CSV并逐行比对当前代码中引用的 key（如 t('LoginPage.title')），标记未覆盖项与拼写不一致项。
4、自动生成 /src/i18n/report/missing-keys.md 与 /src/i18n/report/format-errors.json，供人工复核。
四、为Vue或Svelte项目生成框架适配型i18n绑定代码
QClaw识别项目框架类型后，自动注入对应语法糖支持，包括Vue的 $t() 全局方法、Svelte的 {$_} 插值语法，以及类型推导补全能力。
1、确认项目 package.json 中存在 "type": "module" 或 "framework": "vue" 字段。
2、运行：qclaw setup framework-i18n --auto-inject。
3、QClaw修改 main.ts（或 main.js），插入 i18n 实例注册逻辑，并为每个 .vue 文件添加 <script setup lang="ts"> import { useI18n } from 'vue-i18n'; const { t } = useI18n();</script>。
4、在模板中检测到 {{ $t('Button.submit') }} 类语法时，自动为其绑定类型定义，防止运行时 key 错误。
五、生成带文化适配规则的日期/数字/货币格式配置
除静态文本外，QClaw同步生成 locale-specific 格式化配置，覆盖日期显示、数字分组、货币符号、RTL布局开关等非文本本地化要素。
1、执行：qclaw generate formats --include-date-number-currency。
2、QClaw读取各语言区域设置标准（如 CLDR），生成 /src/i18n/formats/en.json，含 "date": {"short": "M/d/yyyy"}, "number": {"currency": {"style": "currency", "currency": "USD"}} 等字段。
3、在组件中调用 formatDate(new Date(), 'short', currentLocale) 即可按目标语言规则渲染，无需硬编码格式字符串。
4、对阿拉伯语（ar）、希伯来语（he）等RTL语言，QClaw自动在 /src/i18n/config.ts 中启用 isRtl: true 标志，并注入CSS方向控制类。
