前端开发
在 Magento 2 的 Hyvä 主题中编译…
当需要为 Hyvä 主题构建/生成 Tailwind CSS,或模板改动后样式未生效、部分样式缺失时,重新编译 Tailwind 样式表。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在 Magento 2 的 Hyvä 主特定
解决思路
- 使用 hyva-exec-shell-cmd 技能检测运行环境并确定命令包装方式,后续所有 npm 命令都按检测到的环境进行包装。
- 若未提供主题路径,调用 hyva-theme-list 技能发现可用主题;默认只保留 app/design/frontend/ 下的主题,vendor/hyva-themes/ 下的主题需用户明确要求才处理。
- 若未找到任何主题:告知用户在 app/design/frontend/ 中未找到带 Tailwind 配置的 Hyvä 主题,询问是否改为检查 vendor/hyva-themes/,或是否需要先用 hyva-child-theme 技能创建子主题。
- 默认执行生产构建,除非用户明确要求 watch、watch mode 或 live reload。
- 仅当 <theme-path>/web/tailwind/node_modules 不存在时安装依赖:cd <theme-path>/web/tailwind && npm ci。
- 生产构建(默认):cd <theme-path>/web/tailwind && npm run build。
- 监听模式(仅在用户明确要求时):cd <theme-path>/web/tailwind && npm run watch。
- 验证输出:编译后的 CSS 位于 <theme-path>/web/css/styles.css,通过检查文件修改时间确认其已更新。
- 排查 node_modules 缺失:运行 npm ci。
- 排查样式过时:清除浏览器缓存;在生产模式下运行 bin/magento setup:static-content:deploy。
适用边界 · 注意事项
- 用户未明确要求 watch/watch mode/live reload 时不要使用监听模式,应默认生产构建。
- 不要默认处理 vendor/hyva-themes/ 下的主题,除非用户明确要求。
- node_modules 已存在时无需重复运行 npm ci。