Skip to content

双端复用机制 ​

手机版不是电脑版的复制品,而是「移动外壳 + 共享内核」。目标是:同一份工具逻辑,两套交互界面,永不出现两份实现各自修 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折叠面板

差异只发生在「视图层」,算法与数据一行不改。

新增工具时的判断 ​

  1. 组件在 375px 宽度下能用 → 直接复用,什么都不用改;
  2. 按钮太小、表单太密 → 在 mobile-web/src/tools/ 写移动版,在手机版数据映射里指向它;
  3. 必须用大屏(如 PDF 多页预览)→ 保留入口,页面顶部提示「建议在电脑上使用」。

已知约束 ​

  • 手机版与 pc-web 必须在同一仓库、同级目录,单拷 mobile-web 会编译失败;
  • 升级 Vue 时两个 package.json 要一起升,版本不一致会出现运行时警告;
  • pc 组件里不要直接引用 window、document 的桌面特性(如右键菜单),手机版没有。

文档随仓库一起更新,站点内容全部在浏览器本地运行。