2026-07-16
更新概览
- React SPA 模板：升级 Vite、Legacy 插件、ESLint、MSW、Autoprefixer 与 Lucide，并加固懒加载路由测试的等待上限。
- Vue 3 SPA 模板：升级 Vite、Vue 插件、Oxc 工具链、MSW、Node 类型、vue-tsc 与 Lucide。
- React SSR 模板：升级测试与工具依赖，改用 Next.js 官方 ESLint flat config，并显式固定 Turbopack 项目根目录。
- Vue 3 SSR 模板：升级 ESLint/Oxc、测试工具、Node 类型、Vue 插件、vue-tsc 与 Lucide。
- 本次验证：四套模板均通过安装、peer 检查、类型检查、lint、单测、覆盖率、组件测试守卫、生产构建和 Playwright E2E。
React SPA 模板 (vite_react_init)
依赖版本变更
| 依赖 | 旧版本 | 新版本 | 类型 | 影响说明 |
|---|---|---|---|---|
| autoprefixer | 10.5.2 | 10.5.3 | patch | CSS 后处理补丁追平，现有配置不变。 |
| lucide-react | 1.23.0 | 1.24.0 | minor | 图标库追平，现有按需导入保持兼容。 |
| @vitejs/plugin-legacy | 8.1.0 | 8.2.0 | minor | 与 Vite 8 保持兼容的旧浏览器构建插件更新。 |
| eslint | 10.6.0 | 10.7.0 | minor | flat config lint 基线追平。 |
| msw | 2.14.6 | 2.15.0 | minor | 请求 mock 工具更新，现有测试 API 无需修改。 |
| vite | 8.1.3 | 8.1.4 | patch | Vite 8 生产构建补丁追平。 |
| code-inspector-plugin | 1.6.5 | 1.6.6 | lockfile-only | 保持 1.x 配置接口，仅由锁文件解析到兼容补丁。 |
升级内容说明
- Vite 8.1.4、Legacy 插件 8.2.0 与现有 Node
^20.19.0 || >=22.12.0基线兼容。 - React、React DOM、React Router DOM、TypeScript、Zustand、Tailwind CSS 与 Axios 本次保持不变。
- React SSR 仓库当前位于 React SPA 工作区下，但它是独立 Git 仓库；外层 ESLint 已明确忽略该目录，避免跨仓库加载不同 ESLint 插件。
- 懒加载路由测试在多仓库并行覆盖率运行时可能超过 Testing Library 默认 1 秒等待，断言上限调整为 5 秒，不改变测试语义。
模板影响
package.json、pnpm-lock.yaml、README 与 AGENTS 基线已同步。- 业务路由、状态管理、API 封装与 UI 组件实现无需迁移。
Vue 3 SPA 模板 (vite_vue3_init)
依赖版本变更
| 依赖 | 旧版本 | 新版本 | 类型 | 影响说明 |
|---|---|---|---|---|
| @lucide/vue | 1.23.0 | 1.24.0 | minor | Vue 图标库追平，现有按需导入兼容。 |
| @types/node | 26.1.0 | 26.1.1 | patch | Node 脚本与 Vite 配置类型补丁更新。 |
| @vitejs/plugin-legacy | 8.1.0 | 8.2.0 | minor | 与 Vite 8 配套升级。 |
| @vitejs/plugin-vue | 6.0.7 | 6.0.8 | patch | Vue SFC 编译插件补丁更新。 |
| autoprefixer | 10.5.2 | 10.5.3 | patch | CSS 后处理补丁更新。 |
| msw | 2.14.6 | 2.15.0 | minor | 网络 mock 工具更新。 |
| oxfmt | 0.58.0 | 0.59.0 | minor | Oxc formatter 追平，现有命令不变。 |
| oxlint | 1.73.0 | 1.74.0 | minor | Oxc linter 追平，--deny-warnings 继续通过。 |
| vite | 8.1.3 | 8.1.4 | patch | Vite 8 生产构建补丁追平。 |
| vue-tsc | 3.3.6 | 3.3.7 | patch | Vue/TypeScript 类型检查补丁更新。 |
| code-inspector-plugin | 1.6.5 | 1.6.6 | lockfile-only | 保持 1.x 配置接口，仅更新兼容补丁解析。 |
升级内容说明
- Vue 3.5.39、Vue Router 5.1.0、Pinia 3.0.4、TypeScript 6.0.3 与 Tailwind CSS 4.3.2 保持不变。
- Vite DevTools 保持 0.3.4：Vite 8.1.4 的 peer 范围仍要求
@vitejs/devtools ^0.3.0，暂不采用 0.4.x。
模板影响
package.json、pnpm-lock.yaml、README 与 AGENTS 基线已同步。- Oxc、类型检查、单测、覆盖率、构建和 E2E 均无需源码迁移。
React SSR 模板 (vite_react_ssr_init)
依赖版本变更
| 依赖 | 旧版本 | 新版本 | 类型 | 影响说明 |
|---|---|---|---|---|
| lucide-react | 1.23.0 | 1.24.0 | minor | 图标库追平。 |
| @commitlint/cli | 21.2.0 | 21.2.1 | patch | 提交信息校验补丁更新。 |
| @types/node | 26.1.0 | 26.1.1 | patch | Node/Next 配置类型补丁更新。 |
| eslint | 10.6.0 | 9.39.5 | compatibility | 对齐 Next 16 当前 React/import/a11y 插件的 ESLint 9 peer 范围。 |
| eslint-plugin-tailwindcss | 4.0.6 | 4.2.0 | minor | Tailwind CSS 4 lint 规则更新。 |
| msw | 2.14.6 | 2.15.0 | minor | 请求 mock 工具更新。 |
| oxfmt | 0.58.0 | 0.59.0 | minor | formatter 更新。 |
| @antfu/eslint-config | 9.1.0 | 移除 | tooling | 改用已安装的 Next.js 官方 flat config。 |
| @eslint-react/eslint-plugin | 5.11.2 | 移除 | tooling | Next.js 官方配置已提供 React 规则链。 |
| eslint-plugin-format | 2.0.1 | 移除 | tooling | 仅服务于原 Antfu 配置，切换后不再需要。 |
| eslint-plugin-react-refresh | 0.5.3 | 移除 | tooling | Next App Router 不使用 Vite React Refresh lint 规则。 |
| code-inspector-plugin | 1.6.5 | 1.6.6 | lockfile-only | 保持 1.x Turbopack 配置接口。 |
升级内容说明
- Next.js 16.2.10、React 19.2.7、TypeScript 6.0.3、Zustand 5.0.14 与 Tailwind CSS 4.3.2 保持不变。
- ESLint 配置改为
eslint-config-next/core-web-vitals与eslint-config-next/typescript，继续叠加 Tailwind 规则；peer 检查与 lint 均通过。 next.config.ts显式设置turbopack.root为模板目录，避免模板处于多锁文件父目录时错误推断 workspace 根目录。- Server Component 默认边界不变；浏览器 API 仍只允许在客户端组件中使用，特权请求与密钥相关代码继续留在
src/server。
模板影响
- 两个旧 React Refresh 禁用注释随插件移除一并清理，不影响组件行为。
package.json、pnpm-lock.yaml、ESLint 配置、Next 配置、README 与 AGENTS 已同步。
Vue 3 SSR 模板 (vite_vue3_ssr_init)
依赖版本变更
| 依赖 | 旧版本 | 新版本 | 类型 | 影响说明 |
|---|---|---|---|---|
| @lucide/vue | 1.23.0 | 1.24.0 | minor | Vue 图标库追平。 |
| @commitlint/cli | 21.2.0 | 21.2.1 | patch | 提交信息校验补丁更新。 |
| @types/node | 26.1.0 | 26.1.1 | patch | Node/Nuxt 配置类型补丁更新。 |
| @typescript-eslint/parser | 8.63.0 | 8.64.0 | minor | ESLint TypeScript 解析器更新，继续兼容 TypeScript 6。 |
| @vitejs/plugin-vue | 6.0.7 | 6.0.8 | patch | Vue SFC 编译插件补丁更新。 |
| eslint | 10.6.0 | 10.7.0 | minor | ESLint 工具链追平。 |
| eslint-plugin-tailwindcss | 4.0.6 | 4.2.0 | minor | Tailwind CSS 4 lint 规则更新。 |
| msw | 2.14.6 | 2.15.0 | minor | 请求 mock 工具更新。 |
| oxfmt | 0.58.0 | 0.59.0 | minor | Oxc formatter 更新。 |
| oxlint | 1.73.0 | 1.74.0 | minor | Oxc linter 更新。 |
| vue-tsc | 3.3.6 | 3.3.7 | patch | Nuxt/Vue 类型检查补丁更新。 |
| code-inspector-plugin | 1.6.5 | 1.6.6 | lockfile-only | 保持 1.x 配置接口。 |
升级内容说明
- Nuxt 4.4.8、Vue 3.5.39、Pinia 3.0.4、
@pinia/nuxt0.11.3、TypeScript 6.0.3 与 Tailwind CSS 4.3.2 保持不变。 - 安装后重新执行
nuxt prepare，刷新.nuxt中引用 pnpm 虚拟路径的生成类型；源配置无需改造。 - 浏览器行为继续放在
.client插件、onMounted或import.meta.client保护中，服务端能力继续留在src/server。
模板影响
package.json、pnpm-lock.yaml与 README 基线已同步。- Nuxt/Nitro 生产构建、首屏 SSR 与 hydration E2E 均通过。
文档与锁文件
- 四套模板均通过 pnpm 11.10.0 更新
pnpm-lock.yaml，未删除或整体重建锁文件。 create-wl-app保持 1.0.8；四个模板标识、仓库映射和交互分组无需变化。cwa-docs当前使用 React/Vite 自动加载log/*.md，本日志会自动进入更新日志列表；同时补充了标题映射与 React SSR 工程规范说明。
验证结果
| 模板 | 单测 | 覆盖率 statements | 组件守卫 | E2E | 其他门禁 |
|---|---|---|---|---|---|
| React SPA | 15 files / 40 tests | 79.52% | 19 components | 3 passed | install、peers、typecheck、lint、build 通过 |
| Vue 3 SPA | 14 files / 29 tests | 79.22% | 19 components | 3 passed | install、peers、typecheck、lint、build 通过 |
| React SSR | 11 files / 17 tests | 93.97% | 13 components | 3 passed | install、peers、typecheck、lint、Next build 通过 |
| Vue 3 SSR | 8 files / 13 tests | 93.33% | 27 components | 3 passed | install、peers、typecheck、lint、Nuxt build 通过 |
注意事项
- TypeScript 7.0.2 未采用：typescript-eslint 8 当前 peer 范围为
<6.1.0。 - Pinia 4.0.2 与
@pinia/nuxt1.0.0 未采用：Vue Router 5.1.0 当前 peer 仍要求 Pinia 3.0.4。 - code-inspector-plugin 2 未采用：它引入
@code-inspector/core与node-pty构建脚本，会触发 pnpm 构建许可门禁；模板保留 1.x 兼容线。 - pnpm 11.13.1 未采用：其 engine 要求 Node >=22.13，与两套 SPA 的 Node 20 支持基线冲突。
- 本地 Node 24.1.0 不满足 SSR 模板声明的
^24.11.0，因此 SSR 命令会显示 engine warning；命令本身均完成并通过。 - Nuxt 构建仍有上游 module-preload sourcemap 与 VueUse PURE 注释位置警告，构建产物和 E2E 不受影响。
- SSR lint 会提示少量 Tailwind 任意值可简化建议，不阻塞 lint 或模板运行。