meta name="theme-color"仅在安卓Chrome/Edge/三星浏览器HTTPS环境下生效，需静态写于head内、十六进制色值、未被manifest覆盖；iOS Safari完全不支持；深色模式需并列media标签；颜色亮度影响图标清晰度。
HTML 的 meta name="theme-color" 标签能提升移动端 Chrome、Edge 和三星浏览器地址栏的视觉一致性，但它不是万能开关——效果取决于环境、写法和平台限制。用对了，品牌色就能从页面延伸到系统 UI；用错了，就只是段被忽略的 HTML。
只在特定条件下生效
这个标签只对部分安卓浏览器起作用，且必须同时满足四个硬性条件：
- 页面运行在 HTTPS 或
localhost下；HTTP 站点会被 Chromium 内核静默跳过 -
<meta name="theme-color">必须静态写在<head>最前面，建议紧贴<title>后 -
content值只能是纯十六进制格式，比如#4285f4或简写#45f；不支持rgb()、hsl()、命名色（如red）、CSS 变量或带透明度的写法（如#4285f480） - 网站未注册 PWA，或已注册但
manifest.json中没定义theme_color字段；一旦定义，它会直接覆盖 HTML 中的 meta 标签
iOS Safari 完全不支持
无论你怎么调 content、怎么清缓存、怎么重写标签，在 iPhone 的 Safari 上它都不会生效。Apple 从未实现该特性。想控制 iOS 状态栏，只能走两条有限路径：
-
<meta name="apple-mobile-web-app-status-bar-style" content="black">：仅切换文字/图标颜色（default/black/black-translucent），不改背景色，且只在「添加到主屏幕」或 PWA 全屏模式下起效 - PWA
manifest.json中的status_bar字段：需用户安装为 PWA 才触发，与theme-color无关
适配深色/浅色模式的正确写法
浏览器不会监听系统主题切换并实时重绘地址栏，所谓“自动适配”其实是加载时一次性匹配。你需要静态并列写两个带 media 的标签：
立即学习“前端免费学习笔记（深入）”；
<meta name="theme-color" content="#ffffff" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#121212" media="(prefers-color-scheme: dark)">
- 两个标签都必须写死在 HTML 源码的
<head>中，JS 动态插入无效 - 旧版 Android Chrome 可能不识别
media属性，建议额外加一条无条件 fallback：<meta name="theme-color" content="#ffffff"> - 用户中途切换系统主题，地址栏颜色不会更新——没有事件可监听，也没有重绘机制
确保状态栏图标清晰可见
即使颜色生效，图标也可能发虚或变灰。这不是 bug，而是 Chromium 内核根据颜色的感知亮度（luminance）自动决定图标配色（白/黑）的结果：
- 它只计算 RGB 值的亮度，不看你主观觉得“这个蓝够深”
- 例如
#3367d6可能触发白字但显示偏灰；#1e3a8a更稳定出清晰白字 - 没有 JS API 可控该行为，推荐用 WCAG 对比度检测工具辅助选值
