VS Code Live Server：使用iframe时index.html无法自动热更新问题

已验证的场景异常特征 #

• 手动保存触发的页面更新功能本身运行正常，仅自动刷新逻辑存在异常
• index.html通过iframe标签引入navigation.html时，修改navigation.html内容可被Live Server正常检测、自动触发页面刷新
• 相同嵌套场景下，修改index.html内容无法触发页面自动更新
• 扩展调试控制台无报错，可正常捕获到 [Extension Host] Change detected 的变更检测日志
• 移除index.html内的iframe标签后，Live Server自动热更新功能可恢复完全正常
• 因实际开发需求必须使用iframe嵌入页面，无法简单移除嵌套结构

可落地的调整方法 #

• 检查Live Server扩展设置项，开启*全量重载（Full Reload）*选项：部分版本的扩展在检测到页面存在iframe嵌套时，会默认走局部热更新的逻辑分支，若主文档的变更没有匹配到对应的局部更新规则，就会出现日志显示检测到变更但页面无响应的问题；开启全量重载后，只要检测到关联文件变更，就会强制刷新整个宿主页面，不会因iframe的存在中断刷新流程。
• 调整iframe的src路径写法：不要使用纯相对路径的无协议嵌入方式，给src加上明确的Live Server服务端口前缀，避免扩展的变更检测逻辑把主文档与iframe加载的资源判定为跨域资源，导致主文档变更后的刷新请求被跨域校验逻辑拦截。
• 自定义项目级配置绕开默认逻辑：在项目根目录新建 .vscode/settings.json，写入Live Server的强制刷新监听规则，指定index.html等核心文件的变更直接触发全量页面重载，绕开扩展在iframe场景下的默认判断分支。

异常原因说明 #

该场景确实属于Live Server扩展的已知功能bug：扩展的变更推送逻辑在页面存在iframe嵌套时，会错误将主文档的变更归类为iframe内部的资源变更，导致刷新指令仅推送给iframe上下文，宿主页面没有接收到刷新触发信号，这也是为什么可以在扩展日志中捕捉到变更检测记录，但实际页面无刷新响应的核心原因。

内容的提问来源于stack exchange，提问作者Daniel