坑所属项目 ↗2026-10-03

AstroWind Build 失败:Waline 评论组件缺依赖

npm run build 报 Rolldown 无法解析 "@waline/client":AstroWind 模板自带 Waline.astro 组件引用 @waline/client,但 package.json 未声明、node_modules 未安装。修复:npm install @waline/client。

  • AstroWind
  • Build
  • 依赖

现象

npm run build 失败,末尾报错:

[vite]: Rolldown failed to resolve import "@waline/client" from
"src/components/custom/Waline.astro?astro&type=script&index=0&lang.ts"

排查

  • package.json 中无任何 waline 相关声明(grep 无结果)
  • node_modules/@waline 不存在
  • 但 src/components/custom/Waline.astro 中确有:
    • import { init } from '@waline/client';
    • import '@waline/client/waline.css';

即:模板组件引用了依赖,但依赖从未被安装(模板裁剪/初始安装时漏装)。

修复

npm install @waline/client
# added 25 packages, changed 1 package

重跑 npm run build 通过(48 页构建成功)。

注意

  • 这是 AstroWind 模板的既有缺口,与新增内容无关;遇到任何”组件 import 了但依赖缺失”的 build 失败,先查 package.json 声明 + node_modules 实存,再补装,不要改组件代码。