viewport 是移动端页面正常显示的底线，必须写在 最前面且内容为 width=device-width, initial-scale=1，缺一不可；否则 ios safari 默认按 980px 渲染，文字过小、布局错乱。
viewport 设置不是“可选优化”，而是移动端页面能正常显示的底线。没它，iOS Safari 会按默认 980px 宽度渲染，文字小到看不清，用户必须双指放大才能阅读。
为什么 viewport 必须写在
浏览器是顺序解析 HTML 的，viewport 必须在首次渲染前生效。如果它出现在 里、被注释挡住、或由 JS 动态插入，iOS Safari 和部分 Android WebView 会直接忽略——已经按默认视口画完首屏了，再改也来不及。
-
<meta name="viewport" content="width=device-width, initial-scale=1">必须紧贴开始位置，前面不要有其他<meta>、<script></script>或注释 - 服务端渲染（SSR）时，确保这行 HTML 字符串出现在输出流最开头，别被框架占位符挤到后面
- Chrome DevTools 的设备模拟器只模拟尺寸，不模拟真实解析时机，真机测试不可跳过
width=device-width 和 initial-scale=1 缺一不可
只写 width=device-width，某些旧版 UC 浏览器仍会缩放；只写 initial-scale=1，部分安卓 WebView 可能忽略设备宽度计算，导致横向滚动。二者必须共存，才构成稳定起点。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
width=device-width告诉浏览器：“用设备当前的 CSS 像素宽度（比如 iPhone 14 是 390px）当视口宽度” -
initial-scale=1表示“加载瞬间就以 1:1 比例渲染，不放大也不缩小” - 硬写
width=375是高危操作——在折叠屏、平板或新 iPhone 上必然溢出或留白
别碰 maximum-scale=1 和 user-scalable=no
这两项连用等于锁死所有缩放能力，iOS 13+ 会降权提示“该网站可能无法正常工作”，更严重的是：它直接禁用系统级辅助功能，比如「更大字体」或「辅助缩放」，导致视力障碍用户文字被截断、按钮点不到。
- WCAG 2.1 明确要求保留用户缩放控制权
- 真实业务场景中，
user-scalable=yes应为显式声明，默认值不可靠 - 如确需限制（如自助终端 kiosk），必须确认设备无辅助需求，且不接入公共网络
viewport 解决不了图片模糊和布局错乱
viewport 只管“画布怎么铺开”，不管内容怎么画。它不提升图片清晰度，也不自动修复固定宽度容器。
-
<img src="icon.png">是 20×20 像素，在 2x 屏上会被拉伸模糊——得靠srcset或 CSSbackground-image配合媒体查询 -
.header { width: 375px; }在非 375px 设备上必出问题——应改用width: 100vw或媒体查询 + flex - 字体仍用
px？那initial-scale=1下小屏字体会过小——优先用rem或em
viewport 不透传——父页设得再准，子页也得自己单独声明。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
