Appearance

02 快速开始 ​

2.1 环境要求 ​

  • Node.js ^20.19.0
  • pnpm ^10.13.0，项目声明版本为 10.13.0

2.2 安装依赖 ​

bash
pnpm install --frozen-lockfile

2.3 配置环境变量 ​

复制 .env.example 为 .env，至少确认 API 地址：

bash
NUXT_PUBLIC_API_BASE=/api

连接独立后端时配置完整地址，例如：

bash
NUXT_PUBLIC_API_BASE=https://your-domain.com/api/h5app

常用配置包括：

  • NUXT_PUBLIC_BUSINESS_MODE：业务模式，默认 b2c。
  • NUXT_PUBLIC_COMPANY_ID：公司/租户标识。
  • NUXT_PUBLIC_API_TIMEOUT：接口超时时间。
  • NUXT_PUBLIC_AI_ASSISTANT：是否启用 AI 导购及其相关地址。
  • NUXT_PUBLIC_DECORATION_ADMIN_ORIGINS：装修预览来源白名单。

NUXT_PUBLIC_ 变量会暴露到客户端，不要放置密钥等敏感信息。

2.4 本地开发 ​

bash
pnpm dev

默认开发服务监听 0.0.0.0:3000。

2.5 常用命令 ​

bash
pnpm build       # 构建生产版本
pnpm generate    # 生成静态站点（仅适用于可静态化页面）
pnpm preview     # 预览构建结果
pnpm test        # 执行 Vitest
pnpm lint        # ESLint 检查
pnpm lint:fix    # 自动修复 ESLint 问题
pnpm format      # Prettier 格式化

修改 NUXT_* 环境变量后，需要重新执行 pnpm build 才会进入生产产物。