Skip to content

两个前端共用一套组件,踩过的三个坑 ​

电脑版和手机版是两套交互:电脑版左侧列表 + 右侧操作区,手机版单列卡片 + 底部 tab。但如果连工具逻辑也复制一份,88 个工具很快就会变成「改一个 bug 修两遍」。

所以手机版的做法是:外壳自己写,内核直接用 pc-web 的。

js
// mobile-web/vite.config.js
resolve: {
  alias: {
    '@pc': path.resolve(root, '../pc-web/src'),
  },
  dedupe: ['vue', '@vue/runtime-core', '@vue/runtime-dom', '@vue/reactivity', '@vue/shared'],
},

组件里这么用:

js
import WordCounter from '@pc/tools/WordCounter.vue'

看起来只是加个别名,实际踩了三个坑。

坑一:两个 Vue 实例 ​

第一版只加了别名,没加 dedupe。页面能渲染,但输入框里打字没有反应,computed 也不更新。

原因:WordCounter.vue 里写的是 import { ref } from 'vue'。Vite 解析时:

  • 手机版自己的文件 → mobile-web/node_modules/vue
  • @pc 指向的文件 → 优先找到 pc-web/node_modules/vue

两个不同路径的 Vue 各自初始化了一套响应式系统。组件用 A 的 ref 创建状态,页面用 B 的渲染器去读,依赖收集对不上。

修复就是 dedupe 那五个包。@vue/runtime-core 这几个也要列上,因为 Vue 内部会直接引用它们,只 dedupe vue 不够。

判断是不是这个问题:在浏览器里看 app._instance 的构造函数来源,或者临时打印 import('vue').then(m => m.version) 两边是否同一个对象。

坑二:CSS 写死了像素 ​

共享组件沿用的是电脑版的设计令牌:

css
/* pc-web/src/styles/app.css */
:root {
  --accent: #0e7c66;
  --radius: 10px;
  --gap: 16px;
}

但 pc 组件里偶尔会有硬编码:

css
.tool-row { padding: 18px 24px; font-size: 14px; }

在 375px 屏幕上,24px 的左右内边距 + 双列布局直接溢出。手机版不可能去改 pc 组件的样式(会影响电脑版),于是加了一层映射文件 src/styles/pc-compat.css:

css
/* 把 pc 的类名映射到手机版的令牌 */
.tool-row {
  padding: var(--m-pad-y) var(--m-pad-x);
  font-size: var(--m-font-base);
}

这层映射能救急,但它暴露了一个约定:pc 组件里只能使用令牌,不能写死尺寸。新增工具时如果随手写 width: 320px,手机版就要再补一条覆盖规则。

后来我们把这条写进了开发约定,新增组件先按 375px 宽度自查一遍。

坑三:目录不能单独拷走 ​

手机版的 @pc 指向 ../pc-web/src,这意味着:

bash
cp -r mobile-web ~/somewhere   # 编译失败

报错是 Failed to resolve import "@pc/tools/..."。第一次部署时有人想「手机版小,单独打包上传」,结果在服务器上构建失败。

所以 README 里写死了:两个目录必须在同一仓库、同级位置。发布脚本也是从仓库根目录整体构建,不会单独搬 mobile-web。

还有几个小问题 ​

基础路径。手机版挂在 /m/ 下,base 必须是 './':

js
base: './'

如果用默认的 '/',构建产物里的资源路径是 /assets/xxx.js,放到 /m/ 下就 404。用相对路径后,产物可以挂到任意子目录,也可以直接丢进 CDN。

hash 路由。手机版用 /m/#/t/text/word-counter 这种路径,而不是 /m/text/word-counter。原因是 history 路由需要 nginx 为每个深链 rewrite,而 hash 路由只需要一条 fallback:

nginx
location /m/ {
    try_files $uri $uri/ /m/index.html;
}

分享到微信里,hash 也不会被截断。

开发服务器的目录权限。@pc 在项目目录之外,Vite 默认不允许读:

js
server: { fs: { allow: [path.resolve(root, '..')] } }

不加会返回 403,页面白屏。

依赖版本要一起升。两个 package.json 各自锁了 Vue 版本,只升一个会出现运行时警告,严重时又是双实例问题。现在的做法是升级时两个文件一起改,npm install 一起跑。

结果 ​

现在新增一个工具的标准流程是:

  1. 在 pc-web 写组件、加数据、npm run gen;
  2. 375px 下能用 → 手机版自动复用,什么都不用做;
  3. 375px 下不能用 → 在 mobile-web/src/tools/ 写移动版,数据映射指向它。

88 个工具里,只有少数需要第 3 步。剩下的 80 多个,两边共用同一份实现、同一份文案、同一套算法。

这套方案的核心不是技术,而是接受一点点 CSS 映射的丑陋,换取永不分裂的逻辑。

记录方案,而不是记录结论。