用途:在测试应用就绪度、验证运行时行为,或发布前与代码改动后进行验证时使用。它通过四步顺序工作流校验 Wix CLI 应用:包安装、TypeScript 编译检查、构建、预览。任一步骤失败即停止并报告错误。
主要能力与用法:
第一步包安装。先检测包管理器:存在 package-lock.json 用 npm,存在 yarn.lock 用 yarn,存在 pnpm-lock.yaml 用 pnpm,无锁文件默认 npm。命令分别为 npm install、yarn install、pnpm install。成功标准为退出码 0、依赖安装完成、node_modules 存在且包含预期包。失败时报告安装错误并停止。
第二步 TypeScript 编译检查。全项目检查:npx tsc --noEmit。也可只检查特定文件或目录,例如 npx tsc --noEmit src/extensions/dashboard/pages/survey//*.ts src/extensions/dashboard/pages/survey//*.tsx,也支持 dashboard pages、site widgets、dashboard modals、backend 等范围的定向检查。实现单个扩展后或调试特定区域时用定向检查;最终验证、改动影响共享类型或构建部署前用全项目检查。
第三步构建验证:npx wix build,检查编译错误。
第四步预览部署:npx wix preview,启动预览服务器并从终端输出解析站点与仪表盘两个预览 URL,提供给用户手动验证。
完成后输出汇总:依赖、TypeScript、构建、预览各项通过或失败,失败时说明步骤与具体错误并给出修复建议。
限制与排错:出错时可读取项目根目录 .wix/debug.log 获取完整错误栈,该目录由 Wix CLI 自动创建,不要编辑。常见问题包括安装失败(删 node_modules 与锁文件重装)、类型错误、构建失败、预览端口冲突或配置问题,需检查 wix.config.json;配置变更后出现异常可删除 .wix/ 重新构建。未提供的收费、价格与平台信息暂未提供。