---
title: "i18n（国際化）とは？読み方・l10nとの違いとAngularでの実装手順【Angular 22】"
url: "https://www.issoh.co.jp/tech/details/8884/"
published: 2025-09-18
updated: 2026-10-31
categories: ["フレームワーク"]
publisher: "株式会社一創"
---

# i18n（国際化）とは？読み方・l10nとの違いとAngularでの実装手順【Angular 22】

i18n は internationalization（国際化）の略記で、ソフトウェアを特定の言語や地域に縛らず、あとから翻訳や地域ごとの書式を差し込めるように作っておく設計・開発の工程です。翻訳そのものは l10n（ローカライズ）の仕事で、i18n はその前段にあたります。この記事では W3C の定義で両者の違いを整理し、複数形や言語タグなど最初に分けておく設計項目を挙げたうえで、Angular 22.2 の公式 `@angular/localize` と ngx-translate 18.1.0（2026年10月27日公開）を実際にビルド・実行した結果から、実装手順と訳抜けを見逃しやすい箇所を解説します。

## まとめ：i18nの意味とAngularでの実装方式の要点

- i18n は internationalization の i と n の間に18文字あることから来た略記。読み方は「アイエイティーンエヌ」、日本では「あいじゅうはちエヌ」とも読む
- i18n は翻訳できる仕組みを作る工程、l10n はその仕組みに特定の言語・地域の訳や書式を入れる工程
- 最初に分けるのは、文字列の外出し・複数形・日付と通貨の書式・言語タグ・文字コードと書字方向。複数形は日本語が1種類、アラビア語は6種類と言語で数が違う
- Angular 公式の `@angular/localize` はビルド時に訳を埋め込み、ロケールごとに別の配布物を出す。リロードなしの言語切り替えはできない
- 画面上で言語を切り替えたいなら ngx-translate（18.1.0）か Transloco（`@jsverse/transloco` 8.4.0）。ngx-translate 18 では `TranslateModule` が削除された
- XLIFF で `<target>` を書き忘れた訳は、`i18nMissingTranslation` を `error` にしても原文のまま黙ってビルドが通る。擬似ロケールのビルドと CI の検査で補う

## i18nの意味と読み方

i18n は英語圏では「アイエイティーンエヌ」（i-eighteen-n）と読みます。internationalization は20文字の長い単語なので、先頭の i と末尾の n だけを残し、間の文字数18を数字で書いて略しています。日本では「あいじゅうはちエヌ」「あいいちはちエヌ」と読む人もいれば、「国際化」と読み替える人もいます（[Wikipedia「国際化と地域化」](https://ja.wikipedia.org/wiki/%E5%9B%BD%E9%9A%9B%E5%8C%96%E3%81%A8%E5%9C%B0%E5%9F%9F%E5%8C%96)）。W3C の用語集は、この略記が 1970年代か1980年代に Digital Equipment Corporation（DEC）で生まれたと注記しています（[Glossary of W3C Jargon](https://www.w3.org/2001/12/Glossary)）。

定義は W3C の解説ページ「[Localization vs. Internationalization](https://www.w3.org/International/questions/qa-i18n)」の次の一文が基準になります。

> `Internationalization is the design and development of a product, application or document content that enables easy localization for target audiences that vary in culture, region, or language.`

文化・地域・言語の異なる利用者に向けて、ローカライズを容易にする設計と開発、という意味で、翻訳の作業そのものは含みません。英語だけで公開するアプリでも、文字列をコードから分離しておくのは i18n の作業です。

同じ作り方の略記（数略語）はほかにもあります。

| 略記   | 元の語                  | 意味              |
| ---- | -------------------- | --------------- |
| i18n | internationalization | 国際化             |
| l10n | localization         | ローカライズ（地域化）     |
| g11n | globalization        | 国際化と地域化をまとめた呼び方 |
| m17n | multilingualization  | 多言語化            |
| a11y | accessibility        | アクセシビリティ        |

g11n はソフトウェアの外の「社会のグローバル化」の意味でも使われます。サイト全体の多言語展開を指す用法は[Webグローバリゼーションとは？GILTの範囲と自動翻訳4方式、検索に載る条件](/column/details/7770/)で扱っています。

## i18nとl10nの違い

l10n は localization の略で、l と n の間に10文字あります。W3C は localization を次のように定義しています。

> `Localization refers to the adaptation of a product, application or document content to meet the language, cultural and other requirements of a specific target market (a locale).`

| 項目         | i18n（国際化）          | l10n（ローカライズ）          |
| ---------- | ------------------ | --------------------- |
| 目的         | どの言語にも載せ替えられる構造を作る | 特定のロケールに合わせて中身を作る     |
| 主な作業者      | 開発者                | 翻訳者・各地域の担当者           |
| 発生する時期     | 設計・実装時（以後は文言追加のたび） | 対応言語を増やすたび            |
| Angularでの例 | i18n属性で印を付けて抽出する   | messages.ja.xlf に訳を書く |

i18n は設計段階から先に進めておくのが基本です。国際化していないコードに翻訳を入れると、文字列の切り出しから始めることになり見積もりが膨らみます。ローカライズの対象範囲（画像・法務表記・決済手段まで含むか）や、そもそも実施すべきかの判断は[ローカライズとは？翻訳・国際化との違いと対象範囲・実施可否の判断基準](/column/details/17255/)で扱っています。

## 国際化で最初に分けておく設計項目

W3C は国際化の作業として、ローカライズの障壁を取り除く設計、右から左に書く言語や縦書きへの備え、地域ごとの書式への対応、翻訳対象をソースコードから分離すること、を挙げています。実装に落とすと次の6項目です。

| 項目         | 国際化していないと起きること   | 手段                    |
| ---------- | ---------------- | --------------------- |
| 文字列の外出し    | 訳すたびにコードを書き換える   | 翻訳ファイル・i18n属性         |
| 文字列の連結     | 語順の違う言語で文が壊れる    | ICU式・プレースホルダ          |
| 複数形        | 1 items のような誤り   | ICUのplural            |
| 日付・数値・通貨   | 10/2 が10月か2月か曖昧  | Intl API・DatePipe     |
| 言語タグ       | 中国語の簡体と繁体を区別できない | BCP 47（ja-JP・zh-Hant） |
| 文字コード・書字方向 | 文字化け・アラビア語の崩れ    | UTF-8・dir属性           |

言語タグは IETF の [BCP 47（RFC 5646）](https://www.rfc-editor.org/rfc/rfc5646)の形式で、言語・文字体系・地域を `-` でつなぎます。`zh-Hant-TW` は「中国語・繁体字・台湾」です。ロケールを独自の文字列（`jp` など）で持つと、ブラウザの `Accept-Language` や Intl API と突き合わせられなくなります。文字コード側の話は[ISO/IEC 10646（UCS）とは？Unicodeとの違い・版の対応と文字コードUTF-8/16/32を解説](/column/details/7728/)にまとめています。

### 言語別の複数形カテゴリとCLDRの6区分

英語の感覚で「1件なら単数、それ以外は複数」と2分岐で書くと、ほかの言語で破綻します。複数形の規則は Unicode の [CLDR](https://www.unicode.org/cldr/charts/latest/supplemental/language%5Fplural%5Frules.html) が zero・one・two・few・many・other の6区分で定めており、ブラウザや Node.js の `Intl.PluralRules` で引けます。Node.js v26.5.0（CLDR 48.0）で確かめた結果です。

```
for (const loc of ['ja', 'en', 'fr', 'ru', 'ar']) {
  const pr = new Intl.PluralRules(loc);
  const cats = pr.resolvedOptions().pluralCategories;
  const ex = [0, 1, 2, 5, 11, 21, 100].map((n) => `${n}=${pr.select(n)}`).join(' ');
  console.log(`${loc.padEnd(2)} [${cats.join(', ')}]  ${ex}`);
}
// ja [other]  0=other 1=other 2=other 5=other 11=other 21=other 100=other
// en [one, other]  0=other 1=one 2=other 5=other 11=other 21=other 100=other
// fr [one, many, other]  0=one 1=one 2=other 5=other 11=other 21=other 100=other
// ru [one, few, many, other]  0=many 1=one 2=few 5=many 11=many 21=one 100=many
// ar [zero, one, two, few, many, other]  0=zero 1=one 2=two 5=few 11=many 21=many 100=other
```

ロシア語では 21 が 1 と同じ one に入り、フランス語では 0 が単数側に入ります。`count === 1 ? '件' : '件s'` のような分岐をコードに書かず、分岐の数を訳文側で決められる ICU 式に任せるのが国際化の要点です。

### Intl APIによる日付・通貨の書式設定

```
const d = new Date(Date.UTC(2026, 9, 2, 3, 0, 0));
for (const l of ['ja-JP', 'en-US', 'de-DE']) {
  console.log(l,
    new Intl.DateTimeFormat(l, { dateStyle: 'full', timeZone: 'Asia/Tokyo' }).format(d),
    new Intl.NumberFormat(l, { style: 'currency', currency: 'JPY' }).format(1234.5));
}
// ja-JP 2026年10月2日金曜日 ￥1,235
// en-US Friday, October 2, 2026 ¥1,235
// de-DE Freitag, 2. Oktober 2026 1.235 ¥
```

日本円は小数を持たない通貨なので 1234.5 は 1,235 に丸められ、ja-JP では円記号が全角の「￥」になります。保存は UTC、表示のときだけ `timeZone` を指定する、という分け方もここで決めておきます。

### 言語・フレームワーク別のi18nの仕組み

文字列を外に出してキーで引く、という構造はどの言語でも同じで、翻訳ファイルの形式が違います。

| 環境               | 代表的な仕組み              | 翻訳ファイル          |
| ---------------- | -------------------- | --------------- |
| C・Python・PHP など  | GNU gettext          | .po（コンパイル後 .mo） |
| Java             | ResourceBundle       | .properties     |
| Ruby on Rails    | Rails I18n（t メソッド）   | YAML            |
| JavaScript・React | i18next              | JSON            |
| Vue              | Vue I18n             | JSON など         |
| Angular          | @angular/localize ほか | XLIFF・JSON など   |

React や Next.js で同じ構造を作る場合の翻訳ファイルの分け方と複数形の扱いは[i18nextとは：翻訳ファイルの設計と複数形・補間・SSR読み込みの実装手順【v26対応】](/tech/details/18711/)で解説しています。以下は Angular の実装です。

## Angularの国際化3方式：@angular/localize・ngx-translate・Transloco

Angular で多言語化する方法は、公式の `@angular/localize` と、サードパーティの ngx-translate・Transloco の3つが主流です。違いは訳を適用するタイミングで、これが言語切り替えの可否を決めます。

| 項目              | @angular/localize  | ngx-translate  | Transloco |
| --------------- | ------------------ | -------------- | --------- |
| 最新版（2026-10-31） | 22.2.4             | 18.1.0         | 8.4.0     |
| 訳の適用            | ビルド時               | 実行時            | 実行時       |
| その場の言語切替        | 不可（リロード必須）         | 可              | 可         |
| 配布物             | ロケールごとに1式          | 1式             | 1式        |
| 翻訳ファイル          | XLIFF・XMB・JSON・ARB | JSON（ローダーで変更可） | JSON      |
| 提供元             | Angularチーム         | CodeAndWeb     | jsverse   |

表の `@angular/localize` は標準のビルド時方式の場合です。`loadTranslations()` で起動前に訳を読み込む実行時の使い方もありますが（[loadTranslations](https://angular.dev/api/localize/loadTranslations)）、どちらでも再読み込みなしの切り替えはできません。制約はソースのコメントに明記されています（[packages/localize/src/translate.ts](https://github.com/angular/angular/blob/v22.2.4/packages/localize/src/translate.ts)、v22.2.4）。

> `` Note that `$localize` messages are only processed once, when the tagged string is first encountered, and does not provide dynamic language changing without refreshing the browser. ``

言語ごとに URL（`/ja/`・`/en/`）を分けて配信でき、言語の切り替えがページの再読み込み（別 URL への遷移）で済むなら `@angular/localize` を選びます。訳がビルド時に埋め込まれるので、翻訳ファイルを取りに行く通信が発生しません。入力中のフォームを保ったまま切り替えたい、翻訳をデプロイなしで差し替えたいなら実行時方式で、2つのうちでは ngx-translate を既定にします。npm の週間ダウンロード数（2026年10月23日〜29日）は `@ngx-translate/core` が約194万、`@jsverse/transloco` が約48万です。Transloco は旧パッケージ `@ngneat/transloco` が 6.0.4 で非推奨になり、`@jsverse/transloco` へ移っています。

## @angular/localizeの実装手順（Angular 22.2で実測）

以下は Angular CLI 22.2.5 の `ng new` で作ったプロジェクト（@angular/core 22.2.4）に、英語（en-US）を原文として日本語訳を足した手順です。

### ng add @angular/localizeで追加される設定

```
ng add @angular/localize
# UPDATE src/main.ts (267 bytes)
# UPDATE tsconfig.app.json (429 bytes)
# UPDATE tsconfig.spec.json (436 bytes)
# UPDATE angular.json (1978 bytes)
```

`main.ts` の先頭に `/// <reference types="@angular/localize" />` が、tsconfig の `types` に `@angular/localize` が、angular.json の build の `polyfills` に `@angular/localize/init` が追加されます。パッケージは既定で `devDependencies` に入り、実行時に `$localize` を使う場合だけ `--use-at-runtime` を付けて `dependencies` 側に入れます。

### i18n属性・ICU式・$localizeで翻訳対象に印を付ける

テンプレートの要素には `i18n`、属性値には `i18n-属性名`、TypeScript 内の文字列には `$localize` タグを付けます。`@@` の後ろはカスタムIDで、付けないと抽出時に自動でIDが振られます。

```
<!-- src/app/app.html -->
<h1 i18n="site header|An introduction header for this sample@@introductionHeader">Hello i18n!</h1>
<img src="logo.png" i18n-title title="Angular logo" alt="" />
<p i18n="@@cartCount">{count(), plural, =0 {Your cart is empty} =1 {One item in your cart} other {{{count()}} items in your cart}}</p>
<p>{{ today | date: 'fullDate' }} / {{ price | currency: 'JPY' }}</p>
<p>{{ toast }}</p>
<p>Total: {{ count() }}</p>
```

```
// src/app/app.ts
import { Component, signal } from '@angular/core';
import { CurrencyPipe, DatePipe } from '@angular/common';

@Component({
  selector: 'app-root',
  imports: [DatePipe, CurrencyPipe],
  templateUrl: './app.html',
})
export class App {
  protected readonly count = signal(3);
  protected readonly today = new Date(Date.UTC(2026, 9, 2, 3, 0, 0));
  protected readonly price = 1234.5;
  protected readonly toast = $localize`:@@toast.saved:Saved ${this.count()}:count: items`;
}
```

3行目の `{count(), plural, ...}` が ICU 式です。`=0`・`=1` は値の完全一致、`other` はそれ以外の受け皿です。21 も one に入るロシア語では、`=1` とは別に訳文側へ `one`・`few`・`many` を足します。性別などで文を分けるときは `plural` の代わりに `select` を使います。最終行の `Total:` には、後の検査の題材としてわざと印を付けていません。

### ng extract-i18nで翻訳ファイルを書き出す

```
ng extract-i18n --output-path src/locale
# Extraction Complete. (Messages: 4)
```

出力された `src/locale/messages.xlf`（XLIFF 1.2）の一部です。カスタムIDを付けた見出しは `introductionHeader`、付けなかった画像の title は数字の自動IDになります。

```
<trans-unit id="introductionHeader" datatype="html">
  <source>Hello i18n!</source>
  <note priority="1" from="description">An introduction header for this sample</note>
  <note priority="1" from="meaning">site header</note>
</trans-unit>
<trans-unit id="392942015236586892" datatype="html">
  <source>Angular logo</source>
</trans-unit>
```

形式は `--format` で `xlf`（XLIFF 1.2・既定）・`xlf2`・`xmb`・`json`・`arb` から選べ、XMB だけは訳のファイルが `.xtb` になります。翻訳会社や翻訳管理ツールに渡すなら XLIFF が無難です。このファイルを `messages.ja.xlf` としてコピーし、各 `<source>` の下に `<target>` で訳を書きます。日本語は複数形が other の1種類なので、ICU 式の訳は `=0` と `other` の2つで足ります。

### angular.jsonのlocalesとlocalizeでロケール別にビルドする

```
"projects": {
  "demo": {
    "i18n": {
      "sourceLocale": "en-US",
      "locales": { "ja": "src/locale/messages.ja.xlf" }
    },
    "architect": {
      "build": {
        "options": {
          "localize": true,
          "i18nMissingTranslation": "error"
        }
      }
    }
  }
}
```

`ng build` を実行すると `dist/demo/browser/ja` と `dist/demo/browser/en-US` が出力され、ja 側の index.html は `<html lang="ja">`・`<base href="/ja/">` に書き換わります。CLI がロケールデータを読み込み `LOCALE_ID` も設定するため、日付と通貨のパイプはロケールに合った書式になります。Chrome 156 のヘッドレスモードで両方を表示した結果です（タイムゾーンは Asia/Tokyo）。

| 要素                | ja            | en-US                   |
| ----------------- | ------------- | ----------------------- |
| 見出し               | こんにちは i18n!   | Hello i18n!             |
| ICU（count=3）      | カートに 3 点あります  | 3 items in your cart    |
| DatePipe fullDate | 2026年10月2日金曜日 | Friday, October 2, 2026 |
| CurrencyPipe JPY  | ￥1,235        | ¥1,235                  |
| $localize         | 3 件を保存しました    | Saved 3 items           |

配信は、言語ごとのサブディレクトリを置き `Accept-Language` ヘッダーで振り分けるのが公式の想定で、`outputMode` を `server` にしたサーバーレンダリングでは Angular がこの振り分けを自動で行います（[Deploy multiple locales](https://angular.dev/guide/i18n/deploy)）。開発サーバーの `ng serve` は1度に1ロケールしか扱えません。`localize: true` のまま起動すると、エラーで止まるのではなく `` Localization (`localize` option) has been disabled. `` と警告して原文のまま起動します。日本語の画面を開発中に確かめるには、ロケールを1つに絞った設定を作って渡します。言語ごとに URL を分けたら、検索エンジン向けに hreflang で対応関係を示します。書き方は[hreflangとは？書き方・3つの実装方法と多言語サイトSEO対策の検証手順](/column/details/7508/)を参照してください。

## ngx-translate 18.1で実行時に言語を切り替える手順

ngx-translate 18.0.0（2026年6月9日）で `TranslateModule` と `forRoot()`・`forChild()` が削除され、v17 で `fallbackLang` へ改名されたあと残されていた `defaultLang` 系の別名も削除されました（[v17 → v18 移行ガイド](https://ngx-translate.org/getting-started/migration-guide/)）。「angular translatemodule」で調べて出てくる `TranslateModule.forRoot()` の手順は 18 ではコンパイルが通りません。続く [18.1.0（2026年10月27日）](https://github.com/ngx-translate/core/releases/tag/v18.1.0)では、フォールバック言語を順番付きで複数指定する `fallbackLangs`、読み込み失敗を受け取る `onLoadError`、再試行の `retry`、入れ子のキーを平らにする `flatten` が加わりました。`retry` で HTTP の失敗を再試行させるには、ローダー側に `failOnError: true` が必要です。18.1.0 で動かした設定です。

```
npm i @ngx-translate/core@18.1.0 @ngx-translate/http-loader@18.1.0
```

```
// src/app/app.config.ts
import { ApplicationConfig, provideBrowserGlobalErrorListeners } from '@angular/core';
import { provideHttpClient } from '@angular/common/http';
import { provideTranslateService } from '@ngx-translate/core';
import { provideTranslateHttpLoader } from '@ngx-translate/http-loader';

export const appConfig: ApplicationConfig = {
  providers: [
    provideBrowserGlobalErrorListeners(),
    provideHttpClient(),
    provideTranslateService({
      lang: 'ja',
      fallbackLangs: ['en'],
      loader: provideTranslateHttpLoader({
        prefix: '/i18n/',
        suffix: '.json',
        onLoadError: (f) => console.warn(`onLoadError lang=${f.lang} url=${f.url}`),
      }),
    }),
  ],
};
```

```
// src/app/app.ts
import { Component, inject } from '@angular/core';
import { DatePipe } from '@angular/common';
import { TranslatePipe, TranslateService } from '@ngx-translate/core';

@Component({
  selector: 'app-root',
  imports: [TranslatePipe, DatePipe],
  template: `
    <p id="msg">{{ 'HELLO' | translate: { name: 'Sato' } }}</p>
    <p id="nav">{{ 'NAV.LANG' | translate }}</p>
    <button id="de" (click)="translate.use('de')">de</button>
    <p id="date">{{ today | date: 'fullDate' }}</p>
  `,
})
export class App {
  readonly translate = inject(TranslateService);
  protected readonly today = new Date(Date.UTC(2026, 9, 2, 3, 0, 0));
}
```

翻訳は `public/i18n/ja.json` に `{"HELLO": "こんにちは {{name}} さん"}`、`public/i18n/en.json` に `{"HELLO": "Hello {{name}}", "NAV": {"LANG": "Language"}}` と書きました。Chrome 156 で開くと、起動時に `/i18n/ja.json` と `/i18n/en.json` の両方が読み込まれ、表示は「こんにちは Sato さん」「Language」でした。ja.json に無い `NAV.LANG` は、`fallbackLangs` の en から補われています。

## 日付・数値・通貨のロケール書式とLOCALE\_ID

Angular の `DatePipe`・`CurrencyPipe`・`DecimalPipe`・`PercentPipe` は、DI トークン `LOCALE_ID` のロケールで書式を決めます。`@angular/localize` のロケール別ビルドでは CLI が設定しますが、ngx-translate で言語を ja にしても `LOCALE_ID` は既定の en-US のままです。上のアプリでも、日付は「Friday, October 2, 2026」と英語で表示されました。

```
import { registerLocaleData } from '@angular/common';
import localeJa from '@angular/common/locales/ja';
registerLocaleData(localeJa);
// テンプレート：パイプの locale 引数に現在の言語を渡す
<p>{{ today | date: 'fullDate' : undefined : translate.currentLang() ?? undefined }}</p>
// 言語 ja のとき: 2026年10月2日金曜日
```

使うロケールを `registerLocaleData()` で登録し、パイプの locale 引数（`DatePipe` は3つ目、`CurrencyPipe` は4つ目）に現在の言語を渡します。`currentLang` は Signal なので、言語を切り替えると表示も追従します。

## Angularの国際化で訳抜けを見逃す5つの盲点

公式ドキュメントの手順どおりに進めると見落としやすい挙動を、Angular 22.2.4 と ngx-translate 18.1.0 で確かめました。

### target要素が無い翻訳単位の原文フォールバック

`messages.ja.xlf` から画像 title の `<target>` だけを消して `i18nMissingTranslation: "error"` でビルドすると、エラーも警告も出ずに成功し、ja 版の title は英語の「Angular logo」のままでした。`@angular/localize` の XLIFF パーサーは `<target>` が無いと `<source>` を代わりに使います。訳抜けとして止まるのは `<trans-unit>` ごと無い場合だけです。翻訳ファイルを手で編集する運用なら、CI に次のような検査を別に入れます。`ng extract-i18n` の出力形式を前提にした簡易版で、属性の順序やコメント内の `<target>` には左右されませんが、XLIFF 2 や任意の XML まで扱うなら XML パーサーで `<target>` 子要素を数える実装にします。

```
// missing_target.mjs：ng extract-i18n 形式の XLIFF 1.2 で <target> が無い trans-unit を列挙する（CI で exit 1）
import fs from 'node:fs';
let bad = 0;
for (const f of process.argv.slice(2)) {
  const xml = fs.readFileSync(f, 'utf8').replace(/<!--[\s\S]*?-->/g, '');   // コメント内の <target> を数えない
  for (const [, id, body] of xml.matchAll(/<trans-unit\b[^>]*?\bid="([^"]+)"[^>]*>([\s\S]*?)<\/trans-unit>/g)) {
    if (!/<target[\s>]/.test(body)) { console.log(`${f}: target missing: ${id}`); bad++; }
  }
}
console.log(`missing=${bad}`);
process.exit(bad ? 1 : 0);

// $ node missing_target.mjs src/locale/messages.ja.xlf
// src/locale/messages.ja.xlf: target missing: 392942015236586892
// missing=1
```

### 訳抜け警告の実際の文言と公式ドキュメントの差

公式ドキュメント（[Merge translations into the application](https://angular.dev/guide/i18n/merge)）は、訳抜けの警告を `Missing translation for message "{translation_text}"` と説明しています。`<trans-unit>` ごと消してビルドした実際の出力は次のとおりで、文言が違います。ログ監視でこの警告を拾うなら、実際の文言に合わせてください。

```
✘ [ERROR] No translation found for "392942015236586892" ("Angular logo").      ← "error" のとき（終了コード1）
▲ [WARNING] No translation found for "392942015236586892" ("Angular logo").    ← "warning"（既定）のとき（終了コード0）
```

### ngx-translateの既定の読み込み先（/assets/i18n/）

`provideTranslateHttpLoader()` を引数なしで呼ぶと、`prefix` は `/assets/i18n/`、`suffix` は `.json` になります（18.1.0 のソースでも同じ）。いまの `ng new` の雛形は静的ファイルを `public/` に置く構成なので、`public/i18n/ja.json` に置いたまま既定値で動かすと `/assets/i18n/ja.json` が404になります。18.1.0 ではコンソールに `@ngx-translate/http-loader: error loading translation for ja` の警告が出るだけで、画面には `HELLO`・`NAV.LANG` のようにキー名がそのまま表示されました。

### フォールバック表示で隠れる翻訳ファイルの404

上の `fallbackLangs: ['en']` の設定で、翻訳ファイルの無い `de` に切り替えると、`/i18n/de.json` が404になり、`onLoadError lang=de url=/i18n/de.json` が呼ばれたうえで、画面は「Hello Sato」と英語で表示されました。キー名が出る前の盲点と違い、見た目は正常なので、翻訳ファイルの配置漏れに気づけません。`onLoadError` を監視基盤への送信につなぐか、ビルド後の E2E テストで各言語の翻訳ファイルが200で返ることを確かめます。

### 原文修正で変わる自動IDと外れる訳

`@angular/localize` の自動IDは原文から作られるため、英語の原文を1文字直すだけで別のメッセージ扱いになり、既存の訳が使われなくなります。画像の title を「Angular logo」から「Angular logos」に変えて抽出し直すと、ID は 392942015236586892 から 7454670045277118849 に変わりました。原文を頻繁に直す画面では `@@introductionHeader` のようにカスタムIDを付けておくと、訳の対応関係を保ったまま原文だけ直せます。ただし、原文の意味が変わったのにIDを使い回すと古い訳が残ったまま出荷されるので、意味を変える修正ではIDも変えます。

## 擬似ロケールによる国際化漏れの画面検査

擬似ローカライズ（pseudo-localization）は、原文を「読めるが明らかに加工された文字列」に機械変換した偽の言語でアプリをビルドし、画面を見て国際化の漏れを探す検査です。Microsoft は実在の言語に翻訳せずにローカライズ可能性を検証する方法と説明し（[Pseudolocalization](https://learn.microsoft.com/en-us/globalization/methodology/pseudolocalization)）、Android は擬似ロケールの用途にハードコードされた文字列・伸長によるレイアウト崩れ・文字列の連結の発見を挙げています（[Test your app with pseudolocales](https://developer.android.com/guide/topics/resources/pseudolocales)）。`ng extract-i18n` が出力した XLIFF 1.2 から擬似ロケール en-XA 用の翻訳ファイルを作る簡易スクリプトです。`<x>` のプレースホルダ、`&amp;` などの実体参照、ICU 式の変数名・`plural`・`select`（入れ子も含む）は変換せず、表示される文字列だけを加工します。

```
// pseudo.mjs：ng extract-i18n が出力した XLIFF 1.2 から擬似ロケール用の翻訳ファイルを作る
import fs from 'node:fs';
const [, , src, out, lang] = process.argv;
const map = { a:'á', c:'ç', e:'é', i:'í', n:'ñ', o:'ö', u:'ü', y:'ý', A:'Å', C:'Ç', E:'É', I:'Î', N:'Ñ', O:'Ö', U:'Ü' };
const accent = (t) => t.replace(/[A-Za-z]/g, (ch) => map[ch] ?? ch);
function pseudo(s) {
  let out = '', depth = 0, letters = 0, caseLetters = 0;
  for (const part of s.split(/(<x [^>]*\/>|&[#\w]+;)/)) {   // プレースホルダと実体参照（&amp; など）は変換しない
    if (part.startsWith('<x ') || part.startsWith('&')) { out += part; continue; }
    for (const ch of part) {
      if (ch === '{') { depth++; out += ch; if (depth % 2 === 0) { out += '['; caseLetters = 0; } continue; }
      if (ch === '}') { if (depth % 2 === 0) out += '~'.repeat(Math.ceil(caseLetters * 0.4)) + ']'; depth--; out += ch; continue; }
      if (depth % 2 === 1) { out += ch; continue; }   // 奇数の深さ＝ICU の変数名・plural・select・=0 などは変換しない
      if (/[A-Za-z]/.test(ch)) { letters++; caseLetters++; }
      out += accent(ch);
    }
  }
  if (s.trimStart().startsWith('{')) return out;   // ICU は各分岐の中だけを括る
  return `[${out}${'~'.repeat(Math.ceil(letters * 0.4))}]`;   // 訳文が4割長くなる想定で伸ばす
}
let xml = fs.readFileSync(src, 'utf8').replace('source-language="en-US"', `source-language="en-US" target-language="${lang}"`);
xml = xml.replace(/<source>([\s\S]*?)<\/source>/g, (m, s) => `${m}\n        <target>${pseudo(s)}</target>`);
fs.writeFileSync(out, xml);

// $ node pseudo.mjs src/locale/messages.xlf src/locale/messages.en-XA.xlf en-XA
```

angular.json の `locales` に `"en-XA": "src/locale/messages.en-XA.xlf"` を足してビルドし、Chrome 156 で `/en-XA/` を表示した結果です。

| 要素           | en-XA の表示                            | 判定        |
| ------------ | ------------------------------------ | --------- |
| 見出し          | \[Héllö í18ñ!\~\~\~\]                | 印付け済み     |
| ICU（count=3） | \[3 ítéms íñ ýöür çárt\~\~\~\~\~\~\] | 印付け済み     |
| $localize    | \[Sávéd 3 ítéms\~\~\~\~\]            | 印付け済み     |
| 画像の title    | \[Åñgülár lögö\~\~\~\~\~\]           | 印付け済み     |
| Total: 3     | Total: 3                             | 印の付け忘れ    |
| DatePipe     | Friday, October 2, 2026              | en の書式で表示 |

加工されずに残った「Total: 3」が、i18n 属性の付け忘れです。ビルドは警告なしで通るので、こうした漏れは擬似ロケールの画面か、テンプレートの静的検査・表示文字列に対する自動テストで拾うことになります。`[ ]` の片側が欠けていれば、文字列を連結しているか、要素の幅で切れています。en-XA は Angular にロケールデータが無く、日付は英語の書式になりました（ビルド時の警告もありません）。書式の確認は ja など実在のロケールで行い、擬似ロケールは文字列の検査に使い分けます。

翻訳会社へ発注する前にこの検査を回すと、納品後に未訳箇所が見つかる手戻りを防げます。既存サイトの多言語化を設計から任せたい場合は、[英語サイト制作・多言語サイト制作](https://www.issoh.co.jp/service/web/global/)で相談を受けています。

## よくある質問

### i18nの読み方は？

英語では「アイエイティーンエヌ」、日本では「あいじゅうはちエヌ」とも読みます。internationalization の i と n の間に18文字あることから来た略記で、同じ作り方の略記に l10n や a11y があります。

### i18nとl10nの違いは？

i18n はどの言語にも載せ替えられる構造を作る開発側の工程、l10n はその構造に特定の言語・地域向けの訳や書式を入れる工程で、対応言語を増やすたびに発生します。

### Angularの標準i18nで画面上から言語を切り替えられますか？

リロードなしでは切り替えられません。`@angular/localize` はロケールごとに別の配布物を作る方式なので、言語の切り替えは `/ja/` から `/en-US/` への遷移になります。その場で切り替えたい場合は ngx-translate か Transloco を使います。

### Angularのi18nとngx-translateはどちらを使うべきですか？

言語の切り替えが再読み込み（`/ja/` から `/en-US/` への遷移）で済むなら `@angular/localize`、再読み込みなしで切り替える・翻訳をデプロイなしで差し替えるなら ngx-translate です。ngx-translate を選んだ場合は、日付や通貨の書式が `LOCALE_ID` に従って英語のまま残る点を別に手当てします。

### ngx-translateでTranslateModuleが見つからないのはなぜですか？

ngx-translate 18.0.0 で `TranslateModule` が削除されたためです。`app.config.ts` の providers に `provideTranslateService()` を書き、コンポーネントでは `TranslatePipe` を imports に入れます。`defaultLang` 系の別名も 18 で削除されたので `fallbackLang` を使います。18.1.0 からは `fallbackLangs` で複数指定もできます。

## 関連記事

- [i18nextとは：翻訳ファイルの設計と複数形・補間・SSR読み込みの実装手順【v26対応】](/tech/details/18711/)
- [Angular 22.1とは？v22系の変更点とリリース体制の転換を実装目線で解説](/tech/details/15980/)
- [ローカライズとは？翻訳・国際化との違いと対象範囲・実施可否の判断基準](/column/details/17255/)
- [hreflangとは？書き方・3つの実装方法と多言語サイトSEO対策の検証手順](/column/details/7508/)

---

出典: [i18n（国際化）とは？読み方・l10nとの違いとAngularでの実装手順【Angular 22】](<https://www.issoh.co.jp/tech/details/8884/>)（株式会社一創）
