Roo Code 繁體中文（zh-TW）在地化翻譯指南：術語規範、格式規則與 i18n 實作解析-北京尧图网络

Roo Code 繁體中文zh-TW在地化翻譯指南術語規範、格式規則與 i18n 實作解析【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code本篇技術指南以 Roo Code 倉庫內的.roo/rules-translate/instructions-zh-tw.md為核心系統講解繁體中文zh-TW在地化的術語對照、排版格式規則並結合 Roo Code 的 i18n 架構、翻譯工作流與校驗腳本說明一套可供貢獻者直接套用的翻譯作業流程。讀者完成本篇後將能掌握 Roo Code 中 zh-TW 語系的翻譯標準並理解翻譯檔的載入機制與完整性檢查方式可直接參與該專案的在地化貢獻。一、Roo Code 的 i18n 體系與 zh-TW 語系的存放位置Roo Code 是一套運行在 VSCode 中的 AI 開發代理Agent擴充套件其介面與提示訊息需要在地化到多種語言。從倉庫結構看它的在地化localization分為兩個互不重疊的區域各自維護一套翻譯檔區域路徑內容核心擴充套件Core Extensionsrc/i18n/locales/後端back-end使用者可見的字串如錯誤訊息、狀態提示WebView 介面WebView UIwebview-ui/src/i18n/locales/前端 React 介面的字串經由useTranslationhook 取用zh-TW 語系的核心擴充套件翻譯檔位於 src/i18n/locales/zh-TW/目前包含 6 個 namespace 檔common.json、embeddings.json、mcp.json、skills.json、tools.json、worktrees.json。此外VSCode 擴充套件的 manifest套件名稱、描述、功能表命令等翻譯則存放在 src/package.nls.zh-TW.json對應英文基準檔 src/package.nls.json。從 src/shared/language.ts 的語言對照表可以看到zh-TW被映射為「繁體中文」與zh-CN简体中文並列為兩種獨立語系。該檔的formatLanguage函式src/shared/language.ts會把 VSCode 傳入的小寫地區碼標準化例如將zh-tw轉為zh-TW再交由 i18next 載入對應資源若地區碼不在支援清單中則回退到en。在運行時src/i18n/setup.ts 會動態掃描i18n/locales/下所有語言目錄並把每個語言目錄內的所有 JSON 檔以「檔名」作為 namespace 逐一載入最後以lng: en、fallbackLng: en初始化 i18nextsrc/i18n/setup.ts。也就是說翻譯檔的 key 結構必須與en語系完全對齊缺漏時會自動回退到英文不會直接崩潰但介面會出現中英混雜的情況——這正是「翻譯必須完整覆蓋所有 key」的制度性原因。二、核心術語對照表Key Terminology本節為.roo/rules-translate/instructions-zh-tw.md的原文內容是繁體中文翻譯的第一優先依據。翻譯時必須使用「採用zh-TW」欄的用詞並刻意避開中國大陸慣用的對應詞以確保台灣使用者閱讀時的在地感與專業度English TermUse (zh-TW)Avoid (Mainland)file檔案文件task工作任務project專案項目configuration設定配置server伺服器服務器import/export匯入/匯出導入/導出這份術語表在實際翻譯檔中確實得到貫徹。以 src/i18n/locales/zh-TW/common.json 中的真實字串為例nested_git_repos_warning存檔點已停用因為在 {{path}} 偵測到巢狀的 git 儲存庫。——這裡的「存檔點」checkpoint、「儲存庫」repository正是台灣慣用技術詞錯誤訊息大量使用「檔案」如「複製圖片時發生錯誤」、「無法開啟檔案」而非「文件」設定相關字串統一使用「設定」伺服器相關字串使用「伺服器」匯入/匯出功能在設定頁對應「匯入」/「匯出」。值得注意的延伸原則與 zh-TW 指南對應的簡體中文指南 .roo/rules-translate/instructions-zh-cn.md 中server明確規定為「MCP 服務」而非「伺服器」。這說明翻譯時必須依目標語系所在地的慣例處理同一英文詞在不同語系間可能有不同選擇不應互相抄襲。三、格式規則Formatting Rules.roo/rules-translate/instructions-zh-tw.md規定了三條必須遵守的排版格式規則中英文/數字之間加空格例如「AI 驅動」不可寫成「AI驅動」。使用繁體中文引號例如「範例文字」不可使用直引號範例文字。遵循台灣的電腦用語慣例而不是中國大陸術語。這些規則在實際翻譯檔中可以找到大量佐證。例如 src/i18n/locales/zh-TW/common.json 中擴充套件描述description您編輯器中的完整 AI 開發團隊。——「AI」與中文之間保留了空格git_not_installed存檔點功能需要 Git。請安裝 Git 以啟用存檔點。——「Git」前後均有空格時間類字串統一為「15秒」「1分鐘」的台灣寫法而非「15 seconds」佔位符placeholder前後依上下文自然斷句如command_timeout: 命令執行超時{{seconds}} 秒後——變數與中文之間依需要保留空格與全形標點。台灣電腦用語慣例還體現在細微處例如「資料夾」而非「文件夾」、「螢幕」而非「屏幕」、「程式」而非「程序」、「匯出」而非「導出」。在動手翻譯前建議先通讀 src/i18n/locales/zh-TW/ 下既有檔案讓新增翻譯與既有風格保持一致。四、翻譯工作流如何正確地新增與更新 zh-TW 字串Roo Code 將翻譯作業沉澱為一套明確的工作流程集中記載於.roo/skills/roo-translation/SKILL.md.roo/skills/roo-translation/SKILL.md與命令檔.roo/commands/roo-translate.md。核心步驟如下先改英文基準後翻譯其他語系新增字串時先加入en語系的 JSON 檔確認無誤後再向其他語系同步避免以非英文為源頭造成偏差。定位字串的 UI 上下文翻譯前先確認字串出現在按鈕、工具提示還是對話框。按鈕標籤用簡短祈使句如「儲存」「取消」工具提示可以稍具描述性。使用apply_diff增量修改既有翻譯檔必須用apply_diff編輯避免用整檔覆寫以降低 JSON 結構被破壞的風險修改前可用search_files找到相鄰的 key 作為精準定位的錨點。保留佔位符與語態方向{{variable}}這類插值變數必須與英文源完全一致若原文是「使用者對軟體下達的指令」翻譯也必須維持該方向不能翻成「系統對使用者的指示」。不要翻譯技術保留詞token、Prompt等領域術語、品牌名與縮寫如MCP、Git一律保留英文。在執行層面可以透過.roo/commands/roo-translate.md定義的斜線命令快速啟動翻譯流程例如/roo-translate zh-TW—— 只處理繁體中文語系/roo-translate zh-TW src/i18n/locales/zh-TW/common.json—— 只處理指定的翻譯檔/roo-translate all welcome.title—— 將某個 key 翻譯到所有支援語系。支援的語系共 18 種ca, de, en, es, fr, hi, id, it, ja, ko, nl, pl, pt-BR, ru, tr, vi, zh-CN, zh-TW。五、驗證與品質保證兩條校驗腳本翻譯完成後必須用倉庫內建的腳本驗證完整性兩條腳本各司其職1. 缺漏翻譯檢查scripts/find-missing-translations.js這條腳本負責比對「非英文語系」與「英文基準」的 key 集合找出缺失的翻譯。支援的命令列參數如下詳見 scripts/find-missing-translations.js 的說明區塊node scripts/find-missing-translations.js # 檢查全部區域核心、WebView、package.nls node scripts/find-missing-translations.js --localezh-TW # 只檢查 zh-TW node scripts/find-missing-translations.js --filecommon.json # 只檢查特定檔 node scripts/find-missing-translations.js --areacore # 只檢查核心擴充套件core / webview / package-nls其比對邏輯scripts/find-missing-translations.js會遞迴展開英文檔的巢狀 key例如errors.missingToolParameter再逐一檢查目標語系對應路徑是否存在若整個檔案缺失會標記為「File is missing entirely」。此外它還會驗證package.nls.*.json必須為扁平結構不允許巢狀物件並確保每個 key 都有對應翻譯scripts/find-missing-translations.js。一旦發現缺漏腳本會輸出報告並以非零退出碼結束從而可以在 CI 中作為把關檢查。2. 使用處 key 檢查scripts/find-missing-i18n-key.js這條腳本則從「程式碼使用處」反向驗證掃描src/與webview-ui/src/components/下的.ts/.tsx/.js/.jsx檔案用正規表示式匹配三種 i18n key 寫法——{t(key)}、i18nKeykey、以及帶 namespace 的t(namespace:key)見 scripts/find-missing-i18n-key.js——然後檢查該 key 是否存在於所有語系的對應 JSON 檔中node scripts/find-missing-i18n-key.js --localezh-TW node scripts/find-missing-i18n-key.js --filecommon.json兩條腳本互補前者確保「語系檔不落後於英文基準」後者確保「程式碼用到的 key 在所有語系中都有定義」。品質檢查清單綜合.roo/rules-translate/001-general-rules.md與.roo/skills/roo-translation/SKILL.md的品質要求一份 zh-TW 翻譯在提交前應通過以下檢查佔位符{{variable}}是否與英文源完全一致且未被刪改術語是否全文一致不得混用「設定/配置」「伺服器/服務器」是否全程保持非正式口吻類似德語規範中「du」而非「Sie」技術術語、品牌名、縮寫是否保留英文中英文之間是否補足空格、標點是否使用全形繁體中文按鈕文案是否控制在簡短的動詞2–4 字是否保留了原文的敘事視角使用者→系統或系統→使用者六、常見誤區Common Pitfalls根據.roo/skills/roo-translation/SKILL.md的「Common Pitfalls」與.roo/rules-translate/001-general-rules.md的「COMMON PITFALLS TO AVOID」章節翻譯 zh-TW 時最常犯的錯誤包括改動或刪除{{variable}}佔位符這會直接破壞程式碼整合導致執行期錯誤是最嚴重的一類錯誤翻譯不該翻譯的技術詞token、Prompt、MCP、品牌名等應保留英文token在英文中語義特殊所有語系都應直接沿用正式/非正式口吻搖擺必須全篇統一使用非正式口吻同一文件中術語不一致例如繁體文件混用「設定/配置」改變錯誤訊息或操作指示的語義翻譯應精確傳達原文含義而不是字面直譯忽略字串出現的 UI 情境按鈕、工具提示、對話框對文案長度與語氣的要求不同。從翻譯檔實際內容看zh-TW 語系還有一項易被忽略的細節插值變數在繁體中文中的排列。例如刪除規則資料夾失敗: {{rulesFolderPath}}。錯誤: {{error}}這類結構變數位置必須與英文基準保持一致不能為了語感隨意挪動否則前端渲染時的順序與英文資源不一致。七、小結Roo Code 的繁體中文在地化並非簡單的逐字翻譯而是一套「術語表格式規則工作流自動化驗證」的完整工程。翻譯 zh-TW 字串時請以.roo/rules-translate/instructions-zh-tw.md的術語與格式規則為準繩參考 src/i18n/locales/zh-TW/ 既有檔案的實際風格遵循「先英文、再翻譯、後驗證」的工作流最後用node scripts/find-missing-translations.js與node scripts/find-missing-i18n-key.js兩條腳本把關完整性。如此即可確保繁體中文語系與其他 17 種語系在 key 覆蓋率與品質上保持一致為繁體中文使用者提供與英文一致且符合台灣在地慣例的體驗。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Roo Code 繁體中文（zh-TW）在地化翻譯指南：術語規範、格式規則與 i18n 實作解析

相关推荐

Anaconda环境管理：Python多版本与依赖隔离实战

MySQL 8.0客户端认证协议不兼容问题解决方案

A*算法优化：路径规划效率与质量的提升策略

更多资讯

风电并网与15节点混合发电系统仿真实践

STM32F103驱动LTC6804-1电池采样实战：非标准SPI时序与级联设计

微波波段金属超表面吸收器设计与COMSOL仿真实践

CentOS-7下安全编译与使用glibc-2.29指南

ToolJet RBAC 权限模型：四步配好用户组与细粒度授权

Lexical React 富文本编辑器最小示例解析：从 RichTextPlugin 到自定义工具栏与 HTML 导入导出

今日更新

SpacetimeDB C++ 模块库实战：用 C++20 在数据库内构建 WebAssembly 模块

别踩雷！不是所有 AI 写作工具都靠谱，2026 高校认可工具精选

SSM+MySQL幼儿园管理系统源码解析：从部署到优化

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？