# ruoyi-ui 添加 .nvmrc 实施记录

## 文档信息

- 保存路径：`docs/reports/implementation/2026-04-22-ruoyi-ui-nvmrc-implementation.md`
- 实施日期：2026-04-22
- 关联范围：`ruoyi-ui` 前端工程本地 Node 版本约束

## 本次修改内容

1. 确认 `docs/` 内近期前端实施计划与实施记录均使用 `nvm use 14.21.3` 作为 `ruoyi-ui` 的实际 Node 版本。
2. 在 `ruoyi-ui` 目录新增 `.nvmrc`，写入 `14.21.3`，统一本地开发、构建与测试时的 Node 版本入口。
3. 保持 `package.json` 现有 `engines` 配置不变，本次仅补充 `nvm` 版本声明文件，不扩展其他构建配置。

## 影响范围

- 前端：`ruoyi-ui/.nvmrc`
- 文档：本实施记录

## 验证情况

1. 版本依据核对：
   - 已核对 `docs/plans/frontend/` 与 `docs/reports/implementation/` 中近期前端构建命令，当前统一使用 `nvm use 14.21.3`。
2. 本地命令校验：
   - 执行命令：`source ~/.nvm/nvm.sh && cd ruoyi-ui && nvm use`
   - 预期结果：自动读取 `.nvmrc` 并切换到 `v14.21.3`。
3. 说明：
   - 本次为 Node 版本声明文件补充，不涉及业务代码、页面交互或接口行为变更，未执行额外前端构建与页面测试。