主题
两个前端共用一套组件,踩过的三个坑
电脑版和手机版是两套交互:电脑版左侧列表 + 右侧操作区,手机版单列卡片 + 底部 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 一起跑。
结果
现在新增一个工具的标准流程是:
- 在 pc-web 写组件、加数据、
npm run gen; - 375px 下能用 → 手机版自动复用,什么都不用做;
- 375px 下不能用 → 在
mobile-web/src/tools/写移动版,数据映射指向它。
88 个工具里,只有少数需要第 3 步。剩下的 80 多个,两边共用同一份实现、同一份文案、同一套算法。
这套方案的核心不是技术,而是接受一点点 CSS 映射的丑陋,换取永不分裂的逻辑。