開發(fā)工具版本控制【免費下載鏈接】vscode-gitlensSupercharge Git inside VS Code and unlock untapped knowledge within each repository — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via rich visualizations and powerful comparison commands, and so much more項目地址https://gitcode.com/gh_mirrors/vs/vscode-gitlens點擊查看免費下載本文是 GitLensvscode-gitlens擴展本地化體系的實戰(zhàn)指南以倉庫中 l10n/README.md 為骨架結(jié)合 docs/localization.md、scripts/localization.mjs、scripts/localization-chunks.mjs 與 packages/utils/src/plural.ts 等源碼展開。讀完本文你將掌握 GitLens 雙目錄manifest runtime消息體系的結(jié)構(gòu)、新增或更新一門語言的完整流程、ICU 復(fù)數(shù)塊plural block的翻譯規(guī)則、pnpm run check:l10n校驗鏈路的實現(xiàn)原理以及面向 zh-cn / zh-tw / es 的術(shù)語約定與基于 OpenCC 的派生工作流。本地化體系概覽兩類消息目錄l10n/目錄存放 GitLens 運行時的消息目錄message catalogs。整個本地化體系建立在兩類文件之上它們來源不同、用途不同、存放位置也不同文件倉庫根目錄內(nèi)容翻譯文件package.nls.json清單manifest文本命令標(biāo)題、設(shè)置項描述、視圖名稱package.nls.locale.jsonl10n/bundle.l10n.json運行時文本通知、快速選擇quick picks、工具提示tooltips、webviewl10n/bundle.l10n.locale.json兩個英文文件都是由源碼自動生成的嚴(yán)禁手工編輯。以當(dāng)前倉庫快照為例l10n/bundle.l10n.json包含約 6800 余條運行時英文消息package.nls.json包含約 2300 條清單文本簡體中文運行時目錄l10n/bundle.l10n.zh-cn.json已覆蓋約 6785 條剩余缺口由 VS Code 按消息粒度回退到英文。語言標(biāo)識遵循 VS Code 語言包language pack的命名de、es、fr、it、ja、ko、pt-br、ru、zh-cn、zh-tw等。GitLens 跟隨 VS Code 的顯示語言沒有獨立的 GitLens 語言設(shè)置項唯一的例外是既有的日期區(qū)域date-locale設(shè)置仍單獨控制日期格式化見 docs/localization.md 開頭。新增或更新一門語言的完整流程按以下步驟為 GitLens 添加一種新語言或更新既有語言把對應(yīng)的英文文件復(fù)制成語言文件如package.nls.json→package.nls.zh-cn.json、l10n/bundle.l10n.json→l10n/bundle.l10n.zh-cn.json只翻譯值values。鍵必須逐字節(jié)保持一致包括標(biāo)點和尾部空格。保留每一個{0}/{name}占位符?？梢愿鶕?jù)語言習(xí)慣重排或重復(fù)占位符但不能刪除或改名。運行時目錄中值如果是對象{ message: …, comment: […] }說明comment里帶翻譯者提示翻譯message并把譯文以純字符串形式存在同一鍵下——VS Code 的擴展宿主按原樣讀取語言目錄不會解包對象只有英文源保留對象形式。merge命令會自動完成這一展平flatten。允許部分翻譯。VS Code 按消息粒度回退到英文所以新語言可以增量落地。運行pnpm run check:l10n。該檢查會對未知鍵、缺失或改名占位符、過時條目報錯check:l10n腳本定義見 package.json 的 scripts 段。數(shù)量消息count message的鍵本身就是工程側(cè)寫入的復(fù)數(shù)塊規(guī)則見下一節(jié)。校驗鏈路的源碼視角pnpm run check:l10n實際執(zhí)行的是 scripts/localization.mjs 的check分支它會做三件事重新提取運行時目錄并與l10n/bundle.l10n.json比對extractCatalog()遞歸掃描src與packages下除node_modules、dist、out、__tests__、fixtures、scripts之外的*.ts/*.js源文件用vscode/l10n-dev的getL10nJson提取消息不一致即報 Runtime catalog is stale要求先跑pnpm run generate:l10n檢查 manifest 引用掃描package.json中所有%…%形式的引用是否都能在package.nls.json中解析checkReferences校驗全部語言目錄對package.nls.locale.json與l10n/bundle.l10n.locale.json逐一執(zhí)行validateTranslations()檢查未知鍵、空譯文、占位符集合是否與英文源一致effectivePlaceholders連嵌套復(fù)數(shù)塊里的選擇器也會計入、以及復(fù)數(shù)塊結(jié)構(gòu)是否合法。單元測試覆蓋了這些規(guī)則validateTranslations允許重排/重復(fù)占位符與部分翻譯、拒絕缺失/新增/空/過時翻譯、接受英文源中的復(fù)數(shù)塊、接受比英語多 CLDR 類別的譯文見 scripts/tests/localization.test.mjs。ICU 復(fù)數(shù)塊Plural Block翻譯規(guī)則數(shù)量消息的鍵本身就是由添加該消息的工程師寫好的復(fù)數(shù)塊例如{count, plural, one{{count} file changed} other{{count} files changed}}翻譯時第一個逗號之前的部分這里的count必須原樣保留——它命名的是該消息自己的占位符選擇器不是要翻譯的文本逐個翻譯已經(jīng)存在的每個category{...}分支one{...}、other{...}翻譯方式與普通消息相同并在分支內(nèi)部重復(fù)那個占位符{count}英文源只寫one和other因此大部分消息只需要翻譯這兩個分支。如果你的語言需要比英語更多的 CLDR 復(fù)數(shù)類別——如俄語的few/many、阿拉伯語的zero/two——就為你的語言補充所需分支zero、one、two、few、many、other。other分支必須有且必須保留雙形式語言法語、德語、中文等只需翻譯已有分支即可精確數(shù)量可用N定位如0{no files changed}它優(yōu)先于該數(shù)量本應(yīng)落入的 CLDR 類別pnpm run check:l10n會像校驗普通翻譯一樣校驗每個復(fù)數(shù)塊必須有other分支、分支名合法、兩側(cè)占位符一致。一個句子可以有多個計數(shù)如{0} commit behind, {1} commits ahead會看到兩個復(fù)數(shù)塊或并列、或一個嵌套在另一個的分支里。按上述規(guī)則獨立翻譯每個塊——一個塊只需要為自己對應(yīng)的計數(shù)提供類別。已有復(fù)數(shù)塊的消息必須保持復(fù)數(shù)塊即使你的語言只有兩種形式、且每種分支在“one/other”下最終譯出來都一樣也不要把它展平成純文本。運行時如何解析復(fù)數(shù)塊packages/utils/src/plural.ts 中的formatPlural()是復(fù)數(shù)塊的運行時解析器該模塊刻意不導(dǎo)入vscode或vscode/l10n保持純凈以便在擴展宿主、webview 與各包中復(fù)用用Intl.PluralRules按當(dāng)前 UI 語言把計數(shù)歸類getPluralCategory支持setPluralLocale顯式指定分支選擇順序為N精確匹配 → CLDR 類別 →other見selectBranch選擇器不是數(shù)字時回退other并告警一次塊可以出現(xiàn)在模板任意位置、出現(xiàn)多次、也可以嵌套resolve遞歸處理選中分支體中的嵌套塊塊外的普通{placeholder}與塊內(nèi)占位符統(tǒng)一替換未知占位符原樣保留數(shù)字用日期區(qū)域的數(shù)字格式化器輸出。工程側(cè)的對應(yīng)規(guī)則寫代碼的人如何產(chǎn)出復(fù)數(shù)塊在 docs/localization.md數(shù)量消息必須通過formatPlural(l10n.t({count, plural, one{...} other{...}}), { count })渲染require-format-plurallint 規(guī)則會攔截直接傳給l10n.t()的復(fù)數(shù)塊消息。校驗?zāi)_本 scripts/localization.mjs 用純.mjs重新實現(xiàn)了這套語法parsePluralBlocks/checkPluralBlocks兩處需保持同步。不要翻譯的內(nèi)容以下內(nèi)容在翻譯時必須原樣保留Git 語法與標(biāo)志--force、author:、HEAD~1命令 ID 與設(shè)置鍵settings keys$(icon)codicon 記號產(chǎn)品名GitLens、GitKraken、Launchpad、Commit Graph占位符內(nèi)部的任何內(nèi)容\n換行符與 Markdown 鏈接語法。工程側(cè)在 docs/localization.md 有更細(xì)的編碼約束宿主代碼從vscode導(dǎo)入l10nwebview 與可復(fù)用包從vscode/l10n導(dǎo)入必須使用字面量完整消息并把變化的數(shù)據(jù)作為參數(shù)傳入禁止用模板表達(dá)式或拼接作為消息鍵webview 中禁止用unsafeHTML渲染翻譯富鏈接場景改用gitlens/components/localizedContent.js的localizedContent。XLIFF 往返與偽本地化較大的翻譯工程可使用vscode/l10n-dev做 XLIFF 往返pnpm exec vscode-l10n-dev generate-xlf pnpm exec vscode-l10n-dev import-xlf導(dǎo)入后清單目錄放在倉庫根目錄運行時目錄放在l10n/文件夾vscode/l10n-dev的輸出目錄選項不會替你區(qū)分這兩處見 docs/localization.md。偽本地化Pseudo Localization用于不借助真實翻譯來檢驗界面布局pnpm run generate:l10n:pseudo該命令執(zhí)行 scripts/localization.mjs 的pseudo分支調(diào)用getL10nPseudoLocalized生成package.nls.qps-ploc.json與l10n/bundle.l10n.qps-ploc.json。一個重要的實現(xiàn)細(xì)節(jié)getL10nPseudoLocalized按{\S\}匹配占位符無法把復(fù)數(shù)塊識別為一個整體會破壞plural關(guān)鍵字與分支結(jié)構(gòu)因此腳本先用pseudoLocalizeValue預(yù)處理——塊的選擇器、plural關(guān)鍵字、分支名與大括號原樣穿過只對真正的文本消息正文與每個分支內(nèi)的文字嵌套塊遞歸處理做偽本地化。生成的偽目錄被 git 忽略、也不打入 VSIX。使用方式安裝微軟的 Pseudo Language Pack把Configure Display Language設(shè)為qps-ploc并重載。在 VS Code 中查看翻譯效果安裝目標(biāo)語言的微軟語言包Microsoft language pack將Configure Display Language切換為該語言并重載若只想看布局、沒有真實譯文就用上面的偽本地化流程。倉庫還提供瀏覽器級回歸測試pnpm run test:localization:browser用 Playwright Chromium 驗證“翻譯后的標(biāo)記仍是純文本、多行 tooltip/確認(rèn)框保留換行、富鏈接仍可用”見 scripts/tests/localization.browser.test.mjs其wipStats用例用帶復(fù)數(shù)塊的中文/法文等譯文在真實 Chromium 中渲染。首次運行需pnpm exec playwright install chromium。Review 與 CI 門檻新語言在對外宣傳為“受支持”之前必須經(jīng)過人工評審。提交流程為帶著兩個語言文件package.nls.locale.json與l10n/bundle.l10n.locale.json開 Pull Request目錄校驗catalog check會在 CI 中自動執(zhí)行。pnpm run check:l10n也被包含在總檢查pnpm run check里。分塊翻譯工作流Chunked Translation對于完全沒有現(xiàn)存翻譯或積壓大量新消息的語言scripts/localization-chunks.mjs 把工作拆成一個個可獨立翻譯的小文件node scripts/localization-chunks.mjs split zh-cn # 把未翻譯條目寫成 .work/l10n-chunks/zh-cn/ 下的 chunk 文件 node scripts/localization-chunks.mjs merge zh-cn # 把翻譯好的 chunk 合并進(jìn)兩個語言文件 node scripts/localization-chunks.mjs prune zh-cn # 丟棄英文消息已不存在的條目三個子命令的語義與源碼實現(xiàn)一一對應(yīng)split locale掃描兩個源目錄package.nls.json與l10n/bundle.l10n.json找出語言文件中缺失的鍵按默認(rèn)600 條/塊寫成catalog-NN.json清單目錄為manifest-NN.json運行時目錄為bundle-NN.json默認(rèn)輸出到.work/l10n-chunks/locale/?？捎?-size N調(diào)整塊大小、--dir D指定輸出目錄。翻譯者只需翻譯每個 chunk 里的values規(guī)則同上鍵逐字節(jié)一致、占位符{0}、{name}、codicon、花括號包裹的片段保留、空白與 Markdown 原樣、產(chǎn)品名不譯。譯文寫回同名文件merge locale讀取所有manifest-NN.json/bundle-NN.json對每個 chunk 先調(diào)用validateTranslations校驗復(fù)用與pnpm run check:l10n相同的規(guī)則任一 chunk 有錯就整體中止且不寫入任何內(nèi)容通過后把條目折入語言文件保留既有翻譯并把{ message, comment }對象展平為純字符串因為擴展宿主不解包對象合并完成后提示運行pnpm run check:l10nprune locale當(dāng)英文源消息被編輯/刪除后舊譯文會變成未知鍵并導(dǎo)致目錄校驗失敗prune把這些孤兒條目從語言文件中移除。當(dāng)英文源變化時重新運行split它會拿新目錄與語言文件做 diff只產(chǎn)出包含未翻譯條目的 chunk。術(shù)語約定Terminology Conventions語言包的好壞取決于一致性。建議為每種語言維護(hù)術(shù)語表并全局統(tǒng)一盡量與該語言的 VS Code 語言包對齊。簡體中文目錄zh-cn與繁體中文目錄zh-tw采用如下基線Englishzh-cnzh-twcommit提交認(rèn)可branch分支分支tag標(biāo)簽標(biāo)籤stash貯藏擱置stage暫存暫存rebase變基重定基底cherry-pick揀選挑揀pull拉取提取fetch提取擷取pull request拉取請求提取要求merge request合并請求合併請求checkout檢出簽出revert還原還原discard放棄捨棄drop丟棄丟棄undo撤消復(fù)原remote遠(yuǎn)程遠(yuǎn)端repository倉庫儲存庫worktree工作樹工作樹working tree工作樹工作樹workspace工作區(qū)工作區(qū)merge base合并基合併基底blame追溯追溯review/reviewer審查/審查者審查/審查者provider提供程序提供者account帳戶帳戶agent代理代理output channel輸出通道輸出通道注意working tree檢出的工作目錄與worktreegit 功能共用一詞與 VS Code 的處理一致只有workspace譯為 工作區(qū)/工作區(qū)。因此 Working changes 譯為 工作樹更改 / 工作樹變更?？缯Z言目錄須保持的不變量GitLens、GitKraken、Launchpad、Copilot是不透明品牌名保持不譯git 語法、git 配置鍵如blame.ignoreRevsFile以及 git 自身的commit-graph維護(hù)命令同樣不譯。但表面上像英文、實為描述性功能名Worktrees、Repository Health、Inline Blame不是品牌名要翻譯描述性的 GitKraken 功能名需要翻譯zh-cn 示例Commit Graph → 提交圖Visual History → 可視化歷史Visual File History → 可視化文件歷史Cloud Patch → 云補丁Inspect → 檢查器Compose/Recompose → 撰寫/重新撰寫Composer → 撰寫器Focus → 聚焦Repository Health → 倉庫健康狀況對 graph 的泛指the Graph、小寫 commit graph、scope the graph使用同一譯法。作為視圖名詞的Inspect譯為 檢查器Inspect Commit Details → 在檢查器中查看提交詳情作動詞的inspect保持動詞消息里引用的命令名如 GitLens: Open Commit Graph、Add a Show Commit Graph command、Scope to Worktree 設(shè)置描述必須與該命令在package.nls.locale.json中的已翻譯標(biāo)題一致——用戶界面里只會看到翻譯后的標(biāo)題英文名指向的是用戶界面中不存在的東西。查表對照不要把引號里的名字留在英文也不要另造措辭。command:URI 與#setting#引用保持原樣未翻譯但無處不在的源詞仍需一致處理英文說 Message 但實際指提交消息時按 Commit Message 的譯法翻譯標(biāo)點跟隨目標(biāo)語言而非源語言中文文本后的冒號用全角無法推送{0}中文括號用全角zh-cn 用“…”引號、zh-tw 用「…」。代碼段、URL、Markdown 鏈接標(biāo)題與command:URI 內(nèi)保持 ASCII 標(biāo)點。西班牙語es約定以 VS Code 西班牙語語言包microsoft/vscode-loc為基準(zhǔn)它解決了與中文的決定性差異git 動詞與操作保持英文——commit、stash、pull、push、fetch、rebase、cherry-pick、checkout、squashVS Code es 用Hacer commit、aplicar stash。它們是不變的陽性名詞el commit、el stash與hacer搭配hacer checkout de la rama、hará force push。派生詞要翻譯uncommitted →sin commitstaged/unstaged →preparado/sin preparar絕不用 staged/stagingdetached →desasociadochecked out →con checkout activoforce push →forzar push/un force push。周邊名詞翻譯如下Englishesgenderbranchramaftagetiquetafremoteremotomrepositoryrepositoriomworktreeárbol de trabajoLaunchpad Worktrees 中亦同mmerge (n.)fusiónfmerge targetdestino de fusiónmcheckout (n.)checkout覆蓋 VS Code 的 desproteger——其含義像解除保護(hù)mdiscarddescartar也用于drop stash—revert (v./n.)revertir / reversiónfprunepodar / poda不用depurar——本目錄用它表示debugffoldplegar—fork pointpunto de bifurcaciónmlocateubicar不用buscar——那是 search—pull requestsolicitud de incorporación de cambiosfblameblame—語域register用usted?Desea…?deles絕不用 dáles成對的 ?…?/?…!按鈕與菜單標(biāo)簽用不定式Hacer cherry-pick…設(shè)置描述用第三人稱Especifica…、Muestra…。功能名按前述策略翻譯Grafo de commits、Historial visual、Historial visual de archivos、parche en la nube、Inspector、Redactar/Redactor、Enfoque、Salud del repositorio。es 特有的風(fēng)險是未知占位符內(nèi)容與性數(shù)一致優(yōu)先采用不隨占位符變形的句式Se eliminó: {0}。從 zh-cn 派生 zh-tw 的機械化流程對于共享字符集的 CJK 語言新變體可以機械化派生而非重新翻譯先把現(xiàn)有目錄用OpenCCs2twpprofileASCII、鍵與占位符不受影響跑一遍再套用目標(biāo)語言的術(shù)語表。OpenCC 不是倉庫依賴需本地安裝做一次性運行。兩個來自 zh-tw 派生過程的順序約束先轉(zhuǎn)換 fetch提取→擷取再轉(zhuǎn)換 pull拉取→提取這樣 Confirm Pull{0}Fetching{1} 這類混合句子才能正確映射真正有歧義的詞要按英文源門控zh-cn 提交同時對應(yīng)commit與submitzh-cn 放棄同時對應(yīng)discard與give up。s2twp能可靠轉(zhuǎn)換字符但只覆蓋部分詞匯。首版 zh-tw 目錄對以下大陸用詞做了二次處理派生時應(yīng)一并應(yīng)用歧義詞按英文鍵門控zh-cn 殘留zh-twzh-cn 殘留zh-tw更改變更列表清單當(dāng)前目前詳情 / 詳細(xì)資訊詳細(xì)資料應(yīng)用 (apply; 非 應(yīng)用程式)套用令牌權(quán)杖會話工作階段標(biāo)籤頁索引標(biāo)籤生成產(chǎn)生響應(yīng)回應(yīng)訪問存取身份身分配置設(shè)定高亮醒目提示賬戶帳戶佈局版面配置釋出 (publish)發(fā)佈文本文字檢測偵測構(gòu)建建置終端終端機後臺背景自定義自訂新建新增獲取取得證書憑證日誌 / 更新日誌記錄 / 變更記錄許可權(quán)權(quán)限反饋意見反應(yīng)工具欄 / 狀態(tài)欄工具列 / 狀態(tài)列瞭解了解批註註釋提供程式提供者…「…」派生過程中的已知陷阱詞級替換造成復(fù)合詞翻倍文件資源管理器 → 檔案 檔案總管 檔案檔案總管誤抓子串迷你圖minimap不是 the graphblame.ignoreRevsFile是配置鍵不能動復(fù)合術(shù)語誤映射拉取請求必須變成 提取要求而不是 提取請求。因此派生后要打印每一條改動并重新運行pnpm run check:l10n——鍵與占位符集合不會因轉(zhuǎn)換漂移ASCII 不受影響但語義可能出錯。運行與驗證建議改動英文源碼消息后先pnpm run generate:l10n重新生成運行時目錄再pnpm run check:l10n校驗若同時改了貢獻(xiàn)點文本先pnpm run generate:contributions同步package.nls.json翻譯者提交前pnpm run check:l10n是底線門檻合并/裁剪 chunk 后尤其要跑涉及 webview 富文本、多行 tooltip 時pnpm run test:localization提取/校驗/初始化與字面量消息 lint 規(guī)則與pnpm run test:localization:browser真實 Chromium 渲染雙保險需要更細(xì)的提取/校驗實現(xiàn)可研讀 scripts/localization.mjs 與 packages/utils/src/plural.tsvscode/l10n-dev的 Unicode 轉(zhuǎn)義解碼缺陷由 patches/vscode__l10n-dev0.0.35.patch 修復(fù)上游 0.0.35 會丟失四位轉(zhuǎn)義的最后一位數(shù)字、并在占位符后找錯碼點轉(zhuǎn)義的閉合花括號提取回歸測試會對比鍵與 JavaScript 運行時字符串。贊分享開發(fā)工具版本控制【免費下載鏈接】vscode-gitlensSupercharge Git inside VS Code and unlock untapped knowledge within each repository — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via rich visualizations and powerful comparison commands, and so much more項目地址https://gitcode.com/gh_mirrors/vs/vscode-gitlens點擊查看免費下載相關(guān)推薦laravel-mongodb驗證規(guī)則本地化多語言錯誤消息支持laravel mongodb驗證規(guī)則本地化多語言錯誤消息支持 在全球化應(yīng)用開發(fā)中用戶可能來自不同地區(qū)使用不同語言。為提升用戶體驗應(yīng)用需要根據(jù)用戶的語言后端數(shù)據(jù)庫Brackets 多語言本地化指南從新增語言到維護(hù)翻譯的完整流程基于 src/nls/README.mdBrackets 多語言本地化指南從新增語言到維護(hù)翻譯的完整流程基于 src/nls/README.md Brackets 是一款用 JavaScript開發(fā)工具代碼編輯器桌面應(yīng)用Create T3 App 文檔多語言協(xié)作指南從翻譯提交到本地化維護(hù)的完整工作流Create T3 App 文檔多語言協(xié)作指南從翻譯提交到本地化維護(hù)的完整工作流 本文面向希望為 Create T3 App 官方文檔貢獻(xiàn)翻譯的開發(fā)者系統(tǒng)講開發(fā)工具CLI代碼生成上一篇GitHub_Trending/reg/register貢獻(xiàn)者訪談核心開發(fā)者分享項目歷程下一篇Theatre狀態(tài)管理最佳實踐避免過度設(shè)計創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考