企业官网建设流程全解析

1. 移动端适配为什么总在真机上翻车

移动端适配这件事，说穿了就是让同一套页面在 320px 的老机型、375px 的主流机、414px 的大屏机、乃至 768px 的折叠屏上都不出现横向滚动条、不出现文字挤成一团、不出现按钮点不到。听起来简单，但真正落到项目里，问题往往出在三个地方：根字号没算对、视口单位用混了、弹性布局和固定尺寸打架。

我见过太多项目在 Chrome 的设备模拟器里看着完美，一上真机就发现 1px 边框变成 2px、弹窗宽度溢出、底部安全区被遮挡。根因通常不是某个方案本身有问题，而是 rem、vw、flex 三套体系被随手混用，postcss 配置又只配了一半。比如只装了 postcss-pxtorem 却没动态设置 html 的 font-size，或者用了 vw 却在媒体查询里写死 px，结果大屏上元素被拉得离谱。

这篇要解决的场景很具体：你手上有一个移动端 H5 或 WebView 页面，设计稿宽度 375px，需要一套能直接复制进项目的 postcss 配置骨架，把 rem、vw、flex 三种方案各管一段——rem 管整体缩放，vw 管视口相关的间距和字体，flex 管局部弹性排布。同时，这套配置要在 TaoToken 统一 Key/API 通道下跑通构建，最后用真机或模拟器核对不同宽度下的根字号、视口单位和弹性布局表现。

适合谁看：正在做移动端 H5、小程序 WebView、混合 App 内嵌页的前端同学；被适配问题反复折磨、想一次性把 postcss 配置理清楚的人；以及需要一套可复现验证流程、而不是只抄一段配置就完事的开发者。

核心检索词先摆出来：移动端适配、rem、vw、flex、postcss 配置。下面从环境准备开始，一步步把骨架搭起来。

2. TaoToken 统一 Key 的前置准备

在动 postcss 之前，先把 API 通道理顺。TaoToken 在这里的角色是统一 Key 和统一 API 入口，让你在构建、调试、真机验证这几个环节不用来回切换不同的密钥和地址。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 根地址是 https://taotoken.net/api ，注意 API 地址不加 UTM 参数。

你需要先拿到一个可用的 Key。进入控制台创建 API Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。创建时建议按项目命名，比如mobile-adapt-dev，方便后面在构建脚本里区分环境。Key 拿到后不要硬编码进前端代码，放到.env.local或构建机的环境变量里。

如果你只是想在本地快速验证模型对话或接口连通性，可以用模型对话页面直接试： https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 。这个页面适合在配置 postcss 之前先确认 Key 是通的，避免后面把构建失败误判成适配配置的问题。

对于长期做移动端编码、需要 Agent 辅助改样式的场景，可以看 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。Claude Code 相关接入参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude-code-anthropic&utm_campaign=rewrite 。

注意：Key 只用于服务端或构建期调用，不要写进会被打包进客户端的代码里。移动端页面本身不需要暴露 Key。

环境变量建议这样组织：

# .env.local TAOTOKEN_API_BASE=https://taotoken.net/api TAOTOKEN_API_KEY=sk-你的key

构建脚本里读取这两个变量即可。这样做的目的是让适配验证和 API 调用解耦：postcss 配置负责样式，TaoToken 负责通道，两边互不干扰。

3. 可复制的 postcss 配置骨架

这一节是全文的核心。目标是一份能直接落地的postcss.config.js，同时处理 rem 和 vw，并给 flex 留出不被转换的白名单。先装依赖：

npm i -D postcss postcss-preset-env postcss-pxtorem postcss-px-to-viewport autoprefixer

然后写配置。注意 rem 和 vw 两个插件不能对同一批属性同时生效，否则会互相覆盖。我的做法是：默认走 rem，用propList控制范围；对需要视口单位的场景，用selectorBlackList或单独的文件后缀区分。

// postcss.config.js module.exports = { plugins: [ require('postcss-preset-env')({ stage: 3, features: { 'nesting-rules': true } }), require('autoprefixer')({ overrideBrowserslist: [ 'Android >= 4.4', 'iOS >= 9', 'last 2 versions' ] }), require('postcss-pxtorem')({ rootValue: 37.5, // 设计稿 375px 的 1/10 unitPrecision: 5, propList: ['*'], // 全部属性参与转换 selectorBlackList: [ '.no-rem', // 加了这个类名的选择器不转换 /^\.flex-/, // flex 工具类不转换 'html' ], replace: true, mediaQuery: false, // 媒体查询里的 px 不转换 minPixelValue: 2, // 小于等于 2px 不转换，保住 1px 边框 exclude: /node_modules/i }), require('postcss-px-to-viewport')({ unitToConvert: 'px', viewportWidth: 375, unitPrecision: 5, propList: ['*'], viewportUnit: 'vw', fontViewportUnit: 'vw', selectorBlackList: [ '.no-vw', /^\.flex-/, 'html' ], minPixelValue: 2, mediaQuery: false, replace: true, exclude: [/node_modules/, /src\/styles\/rem-only/] }) ] };

这里有几个关键参数必须解释清楚，否则你抄过去大概率会踩坑。

rootValue: 37.5对应 375px 设计稿。如果你设计稿是 750px，改成 75。这个值决定了 1rem 等于多少 px，进而决定所有 rem 尺寸的缩放基准。

minPixelValue: 2是为了保住 1px 边框。移动端高清屏下 1px 物理像素的边框如果被转成 rem 或 vw，会出现粗细不均。设成 2 表示只有大于 2px 的值才转换，1px 和 2px 原样保留。

selectorBlackList里放.flex-和.no-rem、.no-vw，是为了让 flex 弹性布局相关的工具类不被转换。flex 布局本身依赖flex: 1、flex-basis这类属性，如果被转成 rem 或 vw，弹性计算会失真。

mediaQuery: false表示媒体查询里的 px 不转换。媒体查询的断点应该用固定 px，比如@media (min-width: 414px)，如果被转成 vw 就失去断点意义了。

exclude里排除rem-only目录，是为了让某些只走 rem 的样式文件不被 vw 插件二次处理。

配套的 html 根字号动态设置，用一段小脚本搞定，不要依赖 lib-flexible 这种老库：

// src/utils/rem.js const DESIGN_WIDTH = 375; const BASE_FONT_SIZE = 37.5; function setRootFontSize() { const html = document.documentElement; const clientWidth = html.clientWidth || window.innerWidth; // 限制最大宽度，避免大屏上元素被无限放大 const width = Math.min(clientWidth, 768); const fontSize = (width / DESIGN_WIDTH) * BASE_FONT_SIZE; html.style.fontSize = fontSize + 'px'; } setRootFontSize(); window.addEventListener('resize', setRootFontSize); window.addEventListener('pageshow', function (e) { if (e.persisted) { setRootFontSize(); } });

这段脚本做了三件事：按设计稿比例算根字号、限制最大宽度 768px、监听 resize 和 pageshow 重新计算。pageshow里的e.persisted判断是为了处理从缓存恢复页面的场景，iOS 上返回上一页时经常遇到根字号没更新的问题。

视口 meta 标签也要配对：

<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0, viewport-fit=cover">

viewport-fit=cover是为了适配 iPhone 的刘海屏和安全区，配合env(safe-area-inset-bottom)使用。

flex 弹性布局部分，建议单独抽一层工具类，不参与单位转换：

/* src/styles/flex.css */ .flex-row { display: flex; flex-direction: row; align-items: center; } .flex-col { display: flex; flex-direction: column; } .flex-1 { flex: 1; min-width: 0; } .flex-wrap { flex-wrap: wrap; }

min-width: 0是 flex 子项里最容易被忽略的一行。没有它，子项里的长文本或图片会把容器撑破，导致横向滚动。这个坑我在真机上踩过不止一次。

4. 构建与真机验证的完整动作

配置写完后，跑一次构建，然后在真机上核对三个指标：根字号、视口单位、弹性布局。

先确认构建能过：

npm run build

如果用的是 Vite，postcss 配置会自动读取；如果是 webpack，确认postcss-loader已接入。构建产物里搜一下rem和vw，确认转换生效：

grep -o 'font-size:[^;]*rem' dist/assets/*.css | head -5 grep -o 'width:[^;]*vw' dist/assets/*.css | head -5

然后起本地服务，用真机访问。真机调试有两种方式：一是用 Chrome 的chrome://inspect远程调试 Android；二是用 Safari 的开发菜单调试 iOS。如果只是快速核对，用 Chrome DevTools 的设备模拟器切几个宽度也能看出大部分问题。

验证根字号：在控制台执行getComputedStyle(document.documentElement).fontSize，在 375px 宽度下应该得到37.5px，在 414px 下应该得到41.4px，在 320px 下应该得到32px。如果数值不对，检查 rem.js 是否在样式加载前执行。

验证视口单位：找一个用了 vw 的元素，在控制台看它的width计算值。375px 宽度下，26.667vw应该等于100px。切换设备宽度，这个值应该按比例变化。

验证弹性布局：把页面缩到 320px，看 flex 容器里的子项是否还在同一行、有没有溢出。重点看带flex: 1的子项，它的宽度应该是剩余空间而不是固定值。

如果你在验证过程中需要调用接口确认数据渲染是否正常，可以用 TaoToken 的模型对话页面快速发一个请求： https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 。这样能把样式问题和数据问题分开排查。

一个可复现的验证清单：

这张表可以直接拿去当验收标准。每一项对不上，就回到对应配置里找原因。

5. 本篇常见错排查

5.1 根字号没生效，rem 全部按 16px 算

最常见的原因是 rem.js 执行时机太晚，或者被 CSS 里的html { font-size: ... }覆盖了。检查两点：rem.js 是否在入口文件最顶部 import；CSS 里有没有对 html 写死 font-size。如果有，删掉或改成用 JS 控制。

另一个原因是selectorBlackList里放了'html'，导致 html 上的 font-size 被 pxtorem 转换。这个是有意为之，但如果你在 html 上写了 px 的 font-size，它不会被转，需要确认这是你想要的。

5.2 1px 边框变粗或消失

minPixelValue设成 2 之后，1px 和 2px 都不转换。但如果你的边框写的是0.5px，它小于 2，也不会转换，在普通屏上可能显示不出来。移动端 1px 边框的推荐做法是用transform: scaleY(0.5)或box-shadow模拟，不要依赖小数 px。

5.3 vw 和 rem 同时作用于同一个属性

如果某个选择器既不在.no-rem也不在.no-vw黑名单里，两个插件都会处理它。pxtorem 先执行，把 px 转成 rem；然后 px-to-viewport 再执行，此时已经没有 px 了，所以不会重复转换。但如果你调整了插件顺序，就可能出问题。保持 pxtorem 在前、px-to-viewport 在后。

5.4 flex 子项在 iOS 上被压缩

这是min-width: 0缺失的典型症状。flex 子项默认min-width: auto，内容宽度会撑开容器。加上min-width: 0后，子项才能正确收缩。如果子项里有图片，还要加max-width: 100%。

5.5 真机上根字号在横竖屏切换后不更新

resize 事件在部分 Android WebView 里横竖屏切换时触发不稳定。补一个orientationchange监听：

window.addEventListener('orientationchange', function () { setTimeout(setRootFontSize, 100); });

延迟 100ms 是为了等 WebView 完成尺寸更新。

5.6 构建报错找不到 postcss 插件

检查postcss.config.js的导出格式。如果项目是 ESM 模块，需要改成export default。另外确认postcss-preset-env和autoprefixer的版本兼容，两者都装最新版一般没问题。

6. 后续怎么把这套骨架用顺

这套配置骨架的核心思路是分工：rem 管整体缩放，vw 管视口相关尺寸，flex 管局部弹性，postcss 负责自动转换，TaoToken 负责 API 通道。四者各司其职，不要越界。

实际项目里，我建议把rem.js和flex.css作为基础层固定下来，业务样式里只写 px，让 postcss 去转换。遇到不需要转换的，加.no-rem或.no-vw类名。这样团队里每个人写样式的方式一致，适配问题会少很多。

如果你需要长期维护多个移动端项目，可以把这套配置抽成一个 npm 包或模板仓库，新项目直接复制。API 通道方面，统一用 TaoToken 的 Key 管理，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，Key 在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 管理。需要 Agent 辅助批量改样式或做适配重构时，Coding Plan 在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。

最后留一个实用技巧：在开发阶段给 body 加一个调试类，显示当前根字号和视口宽度，真机上一眼就能看出适配是否正常。

.debug-adapt::after { content: 'root: ' attr(data-root) ' | vw: ' attr(data-vw); position: fixed; bottom: 0; left: 0; font-size: 12px; background: rgba(0, 0, 0, 0.6); color: #fff; padding: 2px 6px; z-index: 9999; }

配合 JS 更新data-root和data-vw属性，调试完移除即可。这套流程跑通一次之后，后面每个移动端项目都能直接复用。