快速开始 ​

环境要求 ​

  • Node.js：>= 20.12.0（模板 package.json 中约束）
  • pnpm：>= 11.0.0（推荐与仓库 packageManager 字段一致）
  • 可访问内网 Nexus：https://nexus.in.whatspos.cn

建议使用 fnm 或 nvm 管理 Node 版本。

1. 配置内网 npm 私服 ​

在用户目录的 ~/.npmrc 中配置：

ini
registry=https://nexus.in.whatspos.cn/repository/pax-npm-group/
@uniboot:registry=https://nexus.in.whatspos.cn/repository/pax-npm-release/

如果私服需要登录：

bash
npm login --registry=https://nexus.in.whatspos.cn/repository/pax-npm-release/

确认 registry 已生效：

bash
pnpm config get registry

2. 创建项目 ​

推荐通过 create-uniboot 创建项目：

bash
pnpm create uniboot my-app

按提示选择模板：

text
simple - 简单前端项目
auth   - 含授统一认证授权服务中心（Auth Service）和管理后台服务（Admin Service）

也可以直接指定模板：

bash
pnpm create uniboot my-app --template simple
pnpm create uniboot my-app --template auth

TIP

如果本机不方便修改 ~/.npmrc，可以使用环境变量临时指定 registry：

bash
NPM_CONFIG_REGISTRY=https://nexus.in.whatspos.cn/repository/pax-npm-group/ pnpm create uniboot my-app

更多安装方式见 create-uniboot。

3. 安装依赖并启动 ​

bash
cd my-app
pnpm install
pnpm dev

该命令会直接启动 Vite 本地开发服务器，监听地址与端口以项目中的 vite.config.ts（默认端口为 3002，可通过 VITE_PORT 环境变量配置）为准。