必须在浏览器中测试：保存html→用live server打开→按f12→点手机图标进入响应式设计模式，拖动窗口或选预设设备查看断点、flex-wrap、图片溢出等真实效果。
VSCode里打开HTML后怎么测自适应效果
直接在 VS Code 里点开 HTML 文件，看到的只是源码或静态预览，webVisualEditor 插件能提供带交互的实时预览，但**它不模拟真实浏览器的 viewport 行为**——比如缩放、设备像素比、滚动条宽度这些都会影响布局判断。真正靠谱的自适应测试，必须落到浏览器里。
正确路径是：保存 HTML → 用浏览器打开 → 按 F12 → 点手机图标进入响应式设计模式。这时候拖动窗口、选 iPhone SE 或 iPad Pro，才看得清 max-width 断点是否生效、flex-wrap 有没有触发、图片会不会溢出容器。
-
viewport标签缺失或写错（比如漏了initial-scale=1）会导致整个测试失真，页面在模拟器里缩成一团，不是代码问题，是元信息没生效 - VS Code 内置的 Live Server 插件起的服务地址是
http://localhost:5500/xxx.html，这个环境才支持 JS 执行和相对路径解析，比直接双击文件更接近生产环境 - 如果用了
webVisualEditor，记得关掉webVisualEditor.allowScript再测纯布局——否则 JS 动态插入的 class 可能掩盖 CSS 媒体查询失效的问题
为什么Live Server比直接双击HTML更准
双击打开的 file:// 协议下，浏览器会禁用跨域请求、阻止部分 fetch 和 XMLHttpRequest，CSS 中的 @import 或字体文件若用相对路径，可能加载失败；而 Live Server 启动的是本地 HTTP 服务，所有资源按标准 Web 规则加载，连 service worker 都能注册。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 路径解析差异：
./css/style.css在file://下可能被解析为当前目录的子目录，但在 Live Server 下严格按 URL 路径匹配 - 媒体查询断点依赖视口宽度，而
file://页面在某些浏览器（如 Safari）中默认不触发resize事件，导致@media (max-width: 768px)无法动态响应拖拽 - Live Server 支持热重载，改完 CSS 保存后浏览器自动刷新，不用手动
F5，减少人为遗漏
常见自适应排版失效的三个硬伤
不是媒体查询写得不够多，而是基础结构塌了。以下三点一错，再多断点也白搭：
-
<meta name="viewport" content="width=device-width, initial-scale=1">没加在里，或被注释掉了——这是 90% 的移动端文字过小、横向滚动问题的根因 - 用了固定宽度单位（如
width: 320px）替代流式单位（width: 100%或flex: 1），导致在窄屏下内容强制换行或溢出 - CSS 中写了
overflow-x: hidden却没处理内部元素的white-space: nowrap，结果文字挤成一坨还切不换行
VSCode里怎么快速验证响应式CSS是否写对
别等打开浏览器才发现错。在 VS Code 编辑器里，把光标停在某个媒体查询块上（比如 @media (min-width: 768px)），按 Ctrl + Shift + P 输入 Developer: Toggle Developer Tools，再看右下角状态栏——如果插件识别出当前是 CSS 文件且有有效断点，会显示“Media Query Active”提示。但这只是语法校验，不能代替运行时检查。
- 真正有效的办法是：在
webVisualEditor预览面板里右键 → “Inspect Element”，看计算后的computed样式里width、flex-basis是否符合预期值 - 如果用了
html.format.indentInnerHtml，确保设为true，否则嵌套深的<div><section><article> 结构容易缩进错乱，人工 review 时一眼看不出父子关系断裂 <li>注意 <code>editor.tabSize和html.format.wrapLineLength的组合影响：前者控制缩进空格数，后者控制单行最大字符数，超长 CSS 声明（如一整行grid-template-areas）被折行后，可能破坏可读性甚至误删内容
最易被忽略的是：viewport 设置必须在 HTML 文件最开始的 里，且不能被任何条件注释或 JS 动态插入干扰——它得在浏览器解析第一行 CSS 前就生效。其他所有调试手段，都建立在这个前提之上。
