本文介绍在 TYPO3（v10+）中准确判断当前页面是否已本地化的多种方法，重点推荐基于 Site API 的 siteLanguage 条件语法，并对比传统字段判断的局限性，帮助开发者写出健壮、可维护的多语言条件逻辑。
本文介绍在 typo3（v10+）中准确判断当前页面是否已本地化的多种方法，重点推荐基于 site api 的 `sitelanguage` 条件语法，并对比传统字段判断的局限性，帮助开发者写出健壮、可维护的多语言条件逻辑。
在 TYPO3 的现代多语言站点中，判断“当前页面是否有本地化版本”不能简单依赖 page["localized"] == 1（该字段并不存在于 TYPO3 核心数据结构中），也不能直接用 SQL 风格的条件如 page["uid"] IN (l10_parent)——这类写法既不符合 TypoScript 语法，也忽略了 Site API 对语言上下文的抽象封装。
✅ 正确且推荐的方式是利用 TYPO3 的 Site API 条件语法，通过 siteLanguage() 函数获取当前请求的语言上下文信息。例如：
[siteLanguage("locale") != "en_US.UTF-8"]
# 当前语言不是默认语言（如 en_US），说明处于本地化上下文中
page.40 = TEXT
page.40.value = This is a localized version
[global]
更精准的做法是检查 siteLanguage("navigationTitle") 或 siteLanguage("title") 是否非空，或结合 siteLanguage("twoLetterIsoCode") 进行判断：
[siteLanguage("twoLetterIsoCode") != "en"]
page.config.metaRobots = noindex, follow
[global]
[siteLanguage("isDefaultLanguage") == false]
page.100 = TEXT
page.100.value = ? Localized content loaded
[global]
⚠️ 注意事项：
- siteLanguage("isDefaultLanguage") 是最语义清晰的判断依据，返回布尔值，明确标识当前是否为默认语言；
- 避免使用 page["l10n_parent"] > 0 等字段判断——因为未翻译页面的 l10n_parent 仍为 0，而根页面或独立语言页可能无父级，导致误判；
- 所有 siteLanguage() 条件仅在启用 Site Configuration（即 config/sites/ 下定义了 site.yaml）时生效，确保你的站点已正确配置多语言 site variants；
- 条件块必须以 [global] 显式结束，否则会影响后续 TypoScript 解析范围。
? 总结：TYPO3 多语言逻辑应围绕 siteLanguage 展开，而非操作底层数据库字段。它不仅提升可读性与可维护性，还天然兼容未来版本的国际化增强（如区域变体、内容维度等）。始终优先使用 siteLanguage("isDefaultLanguage") 或 siteLanguage("twoLetterIsoCode") 进行可靠判断。
