微信内置浏览器默认启用HTML5，无需手动开启；其兼容性取决于X5内核版本，需按Chrome 60–70标准开发，适配缺失API、移除document.write、补全polyfill，并通过HTTPS+JS-SDK调用原生能力。
怎么确认当前页面在微信内置浏览器中运行
很多兼容性问题源于“没搞清运行环境”，先做精准判断：
- 用
navigator.userAgent检测是否含MicroMessenger和QQBrowser（X5内核标识） - 避免只查
WeChat：部分安卓微信会伪装成MQQBrowser/6.2，但仍是X5内核 - 不要依赖
isWeChat()这类简陋函数，建议用更健壮的检测逻辑：
function isWechatInX5() {
const ua = navigator.userAgent;
return /MicroMessenger/i.test(ua) && /QQBrowser\/\d+\.\d+/i.test(ua);
}
返回 true 才代表你正面对微信X5内核——此时所有“开启HTML5”的动作，其实是适配它，而非激活它。
为什么有些HTML5特性在微信里不工作
不是HTML5被禁用了，而是X5内核对标准的支持有延迟或裁剪。典型表现：
-
IntersectionObserver在旧版X5（如5.4）中完全不可用，需降级为getBoundingClientRect()轮询 -
fetch()在部分低版本X5中缺失，必须引入whatwg-fetchpolyfill - CSS中的
aspect-ratio、container-query等新属性基本不支持 -
document.write()在X5中会直接报错中断执行，必须移除
关键点：X5内核更新滞后于Chrome，不能按 Chrome 110+ 的标准写代码；建议以 Chrome 60–70 的兼容范围为基准开发。
立即学习“前端免费学习笔记（深入）”；
HTTPS + JS-SDK 是调用微信原生能力的前提
想用分享、支付、扫码等微信特有能力，光靠HTML5不行，必须走官方JS-SDK流程：
- 域名必须备案 + 支持有效HTTPS，否则
https://链接都打不开 - 在公众号后台配置“JS接口安全域名”，不是随便填，要和页面URL的
location.hostname完全一致 -
wx.config()必须传入服务端签名后的参数，前端不能自己算signature - 常见失败原因：
invalid signature（时间戳/nonceStr/URL三者不匹配）、config:fail（HTTPS证书链不完整）
没有这些，wx.ready() 永远不会触发，所有 wx.* 方法都是 undefined。
调试时别信“看起来能跑”
微信开发者工具模拟的是简化环境，真机上X5内核行为可能完全不同：
- 远程调试安卓微信需用 Chrome
chrome://inspect+ adb，但看到的渲染层是X5，不是WebKit，DOM结构和事件流可能异常 - iOS微信只能通过 Safari Web Inspector，但仅限 macOS + 真机连接，Windows用户基本无解
- 最可靠方式：加
console.log+alert+ 把错误上报到后端日志，尤其关注try/catch捕获不到的异步错误（如Promise rejection）
很多“线上白屏”问题，是因为X5加载某个CSS或JS失败后静默终止，连错误事件都不抛——所以资源加载一定要加 onerror 监听并兜底。
