应使用 lang="ja" 而非 lang="ja-JP"，因其符合 ISO 639-1 标准、兼容性最强；必须写在 <html> 标签上，局部英文内容需显式标注 lang="en" 等，SPA 中需服务端预设并配合重读技巧确保辅助技术正确识别。
直接写 lang="ja" 就对了，不需要加地区后缀（比如 ja-JP），除非你明确按国家做内容区分；写错或漏写会导致屏幕阅读器读音错乱、Chrome 翻译按钮不出现、Google Search Console 报“未指定语言”。
为什么用 lang="ja" 而不是 lang="ja-JP"
日语内容默认适用 lang="ja" —— 这是 ISO 639-1 标准的合法语言代码，被所有主流浏览器、NVDA、VoiceOver 和 Google 完全支持。加 -JP 只在你需要精准区分“日本本土日语”和“海外日语教学页”等极少数场景才必要。
-
lang="ja"✅ 通用、简洁、兼容性最强，适用于绝大多数面向全球用户的日文页面 -
lang="ja-JP"⚠️ 合法但冗余，部分 CDN 或缓存策略可能因地区码触发错误路由 -
lang="ja_jp"❌ 下划线非法，浏览器静默降级为und（未知语言） -
lang="japanese"❌ 非标准字符串，完全无效
lang="ja" 必须写在 <html> 标签上
写在 <body>、<div> 或 <meta> 里都等于没写。浏览器和屏幕阅读器只认 <html lang="ja"> 这个位置。
- 错误示例：
<body lang="ja">→ Chrome 翻译按钮不出现，VoiceOver 按系统默认语种朗读 - 错误示例：
<meta http-equiv="Content-Language" content="ja">→ HTML5 已弃用，无任何效果 - 正确写法：
<html lang="ja">，且必须在文档最顶层、无父容器
混排英文术语时怎么处理 lang
表格、代码块、产品名等局部英文内容，不能靠全局 lang="ja" 覆盖，必须显式标注真实语言，否则“API”会被读成“阿皮”，useState 可能被中文引擎硬切音节。
立即学习“前端免费学习笔记（深入）”；
- 技术词写在
<code lang="en">里：<code lang="en">fetch</code> - 表格单元格单独声明：
<td lang="en">React Router</td> - 引文或外语短语用
<blockquote lang="en">或<p lang="fr"> - 避免嵌套无语义容器：
<td><span lang="en">CSS</span></td>不如直接<td lang="en">CSS</td>（<td>本身支持lang）
SPA 切换语言时 lang 容易失效
React/Vue 应用里执行 document.documentElement.lang = "ja" 后，已激活的屏幕阅读器会继续用旧语言朗读——因为辅助技术在初始解析阶段就锁定了根节点语言。
- 最稳妥方式：服务端渲染时就输出正确的
<html lang="ja"> - 客户端补救：修改
lang后，强制触发重读：document.title = document.title（空赋值） - 别忽略动态插入内容：JS 渲染的弹窗、表格行、富文本区块，都要同步设置其内部元素的
lang - 第三方脚本生成的内容（如评论组件）往往不带
lang，需用 MutationObserver 监听并补全
真正难的不是写对一个 lang="ja"，而是让每个 DOM 节点的语言上下文，在 SSR、CSR、微前端、第三方 SDK 共存的复杂链路中始终准确可追溯。
