HTML国际化怎么规范？团队开发维护标准-html教程-PHP中文网

lang属性必须使用iana注册值（如zh-cn），禁用cn、ch等简写，否则导致屏幕阅读器发音不准、chrome翻译按钮不出现、搜索引擎语言识别失败，ie及旧safari甚至退化至怪异模式。

html国际化怎么规范？团队开发维护标准

lang 属性必须用 IANA 注册值，不能简写

很多团队把 lang="zh" 当成“够用”，实际会导致屏幕阅读器发音不准、Chrome 翻译按钮不出现、搜索引擎语言识别失败。IE 和旧 Safari 甚至会退化到怪异模式——不是“翻译不好”，是根本没触发翻译逻辑。

中文站点固定用 zh-CN（简体大陆）、zh-TW（繁体台湾）、zh-HK（繁体香港），不能写 cn、ch 或 zh
多语言页面必须动态改 document.documentElement.lang，不能只靠模板里静态写死
服务端渲染（SSR）时，lang 值必须和真实语言一致，否则 hydration mismatch 会报错

meta charset 必须在 head 最开头，且不能有前置内容

<meta charset="UTF-8"> 不是“加了就行”，它必须是里的第一个标签，前面不能有任何东西——包括空格、BOM、注释、<script></script> 或 <style></style>。否则浏览器会在解析到它之前，按系统默认编码（如 Windows-1252 或 GBK）解码前面的 <title></title>，造成标题乱码，且 JS 无法修复。

VS Code 默认保存可能带 BOM，需手动选 “UTF-8 without BOM”
Sublime / Notepad++ 同样要确认“UTF-8”，而非“UTF-8 with BOM”
检查最终 HTML 输出：用 Chrome DevTools → Network → Headers → Response Headers，确认 Content-Type 包含 charset=UTF-8，且与 <meta> 一致

form 提交必须显式声明 accept-charset

即使页面已设 <meta charset="UTF-8">，<form method="post"></form> 在部分 Safari 和旧 Android 浏览器中仍可能用 ISO-8859-1 编码提交中文，导致后端收到乱码。这不是浏览器 bug，是规范允许的 fallback 行为。

html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载

每个 <form></form> 都要加 accept-charset="UTF-8"，不能依赖 meta 继承
AJAX 提交（如 fetch）需手动设置 header：headers: { 'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8' }
后端也得配合：PHP 要设 mb_internal_encoding('UTF-8')，Node.js Express 要确保 express.urlencoded() 未覆盖 encoding

团队落地靠自动化，不是靠文档

光写 Wiki 没用。新人第一天写，没人提醒，错误就进了 Git。真正起效的是编辑器和 CI 里的硬约束：

Prettier + VS Code editor.formatOnSave 强制格式，但不校验 lang 或 charset —— 这块得靠 ESLint 插件或自定义 HTML validator
husky + lint-staged 在 pre-commit 阶段跑脚本，检查 lang 是否匹配正则 ^zh-[CN|TW|HK]$、meta charset 是否在 head 第一行
CI 流水线里加 HTML validator（如 html-validate），对 doctype 位置、lang 值、meta charset 顺序做 fatal error 拦截