主题
双端复用机制
手机版不是电脑版的复制品,而是「移动外壳 + 共享内核」。目标是:同一份工具逻辑,两套交互界面,永不出现两份实现各自修 bug。
三层结构
mobile-web/src/views 页面骨架、导航、弹层
mobile-web/src/shell 底部 tab、顶部栏、通用移动组件
mobile-web/src/tools 少数为手机重写的工具(大按钮、单列、底部操作栏)
↕ @pc 别名
pc-web/src/tools 88 个工具组件(共享内核)
pc-web/src/data 工具定义、栏目文案(共享数据)
pc-web/src/utils 纯函数算法(共享算法)关键配置
js
// mobile-web/vite.config.js
export default defineConfig({
base: './',
resolve: {
alias: {
'@pc': path.resolve(root, '../pc-web/src'),
'@': path.resolve(root, 'src'),
},
dedupe: ['vue', '@vue/runtime-core', '@vue/runtime-dom', '@vue/reactivity', '@vue/shared'],
},
server: { fs: { allow: [path.resolve(root, '..')] } },
})逐条解释:
| 配置 | 不这样会怎样 |
|---|---|
@pc 别名 | 只能复制组件,改一处要改两处 |
dedupe: ['vue'] | pc 组件与手机版各自解析出 Vue 实例,响应式失效、事件不触发 |
base: './' | 产物只能用绝对路径挂载,换子目录或 CDN 就 404 |
server.fs.allow | 开发服务器拒绝读取仓库上级目录,报 403 |
样式如何兼容
电脑版组件的类名沿用 app.css 的设计令牌(--accent、--bg、--radius 等)。手机版在 src/styles/pc-compat.css 里把这些变量和类名映射到移动端的令牌:
- 间距按小屏重算;
- 输入框高度加大,避免触屏误触;
- 表格改为横向滚动容器;
- 弹层用
position: fixed+ 安全区 padding。
好处是不用改 pc 组件里的任何一行样式,手机版也能看。代价是 pc 组件必须始终使用令牌,不能写死像素值——这是新增工具时要遵守的约定。
hash 路由
js
// /m/#/t/text/word-counter
// /m/#/assess/cog/logic
// /m/#/my选择 hash 而不是 history 路由的原因:
- 部署在
/m/子目录,history 路由需要 nginx 为每个深链 rewrite; - 分享出去的链接在微信里打开不会被截断;
- 断网、离线打开时行为一致。
nginx 端只需要:
nginx
location /m/ {
try_files $uri $uri/ /m/index.html;
}真正的差异在哪
| 维度 | 电脑版 | 手机版 |
|---|---|---|
| 布局 | 左栏工具列表 + 右侧操作区 | 单列卡片 + 底部 tab |
| 导航 | 顶部栏目导航 + 页脚 | 底部 4 个 tab |
| 输入 | 多列并排、可拖拽 | 单输入框、粘贴优先 |
| 结果 | 表格 + 复制按钮 | 大号结果卡 + 一键复制 |
| 详情 | 侧栏 FAQ | 折叠面板 |
差异只发生在「视图层」,算法与数据一行不改。
新增工具时的判断
- 组件在 375px 宽度下能用 → 直接复用,什么都不用改;
- 按钮太小、表单太密 → 在
mobile-web/src/tools/写移动版,在手机版数据映射里指向它; - 必须用大屏(如 PDF 多页预览)→ 保留入口,页面顶部提示「建议在电脑上使用」。
已知约束
- 手机版与 pc-web 必须在同一仓库、同级目录,单拷
mobile-web会编译失败; - 升级 Vue 时两个
package.json要一起升,版本不一致会出现运行时警告; - pc 组件里不要直接引用
window、document的桌面特性(如右键菜单),手机版没有。