diff --git a/.env b/.env index ea089275..8d5e301e 100644 --- a/.env +++ b/.env @@ -17,5 +17,5 @@ VUE_APP_I18N_FALLBACK_LOCALE=en VUE_APP_ELEMENT_COLOR=#409EFF # 后台接口地址(代理目标) -VUE_APP_BASE_URL=http://127.0.0.1:8787/background/ +VUE_APP_BASE_URL=http://127.0.0.1:22666/background/ diff --git a/.node-version b/.node-version index 6d80269a..5bd68117 100644 --- a/.node-version +++ b/.node-version @@ -1 +1 @@ -18.16.0 +20.19.0 diff --git a/README.md b/README.md index 614ea4b2..c2acaa6d 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ | 工具 | 锁定版本 | 作用 | | --- | --- | --- | -| **Node.js** | `18.16.0` | JavaScript 运行时(`.node-version` 文件) | +| **Node.js** | `20.19.0` | JavaScript 运行时(`.node-version` 文件) | | **pnpm** | `10.33.0` | 包管理器(`package.json` → `packageManager` 字段) | > 配置文件说明: @@ -80,20 +80,20 @@ pnpm --version # 应输出 10.33.0 git clone <仓库地址> cd mes-ui -# Volta 检测到 .node-version 后,自动下载并安装 Node.js 18.16.0 -# 如果你本机没有这个版本,Volta 会提示 "Fetching node@18.16.0" —— 等它完成即可 -node --version # 应输出 v18.16.0 +# Volta 检测到 .node-version 后,自动下载并安装 Node.js 20.19.0 +# 如果你本机没有这个版本,Volta 会提示 "Fetching node@20.19.0" —— 等它完成即可 +node --version # 应输出 v20.19.0 # 安装依赖 pnpm install ``` -> **没有安装 Node 18.16.0 怎么办?** +> **没有安装 Node 20.19.0 怎么办?** > **Volta 用户**:无需手动操作。进入项目目录时 Volta 会自动检测 `.node-version`,如果本机缺这个版本,它会**自动下载安装**,你只需等待几秒终端提示完成即可。 -> **nvm 用户**:执行 `nvm install 18.16.0 && nvm use 18.16.0`。 -> **手动安装**:去 [nodejs.org](https://nodejs.org/) 下载 Node.js 18.16.0 安装包。 +> **nvm 用户**:执行 `nvm install 20.19.0 && nvm use 20.19.0`。 +> **手动安装**:去 [nodejs.org](https://nodejs.org/) 下载 Node.js 20.19.0 安装包。 > -> 装完后建议运行 `node --version` 确认输出 `v18.16.0`,否则 `pnpm install` 会因为 `engine-strict=true` 直接报错拒绝安装。 +> 装完后建议运行 `node --version` 确认输出 `v20.19.0`,否则 `pnpm install` 会因为 `engine-strict=true` 直接报错拒绝安装。 ### 第四步:配置环境变量 @@ -135,10 +135,10 @@ pnpm serve ``` 项目根目录 -├── .node-version → 18.16.0(Volta 自动读取切换) +├── .node-version → 20.19.0(Volta 自动读取切换) ``` -- Volta 进入项目目录时自动将 Node.js 切换为 `18.16.0` +- Volta 进入项目目录时自动将 Node.js 切换为 `20.19.0` - 如果该版本未安装,Volta 会自动下载并安装 - 传统方案(nvm)也兼容:`nvm use` 读取 `.nvmrc`,本项目同时提供 `.node-version` 供 Volta 使用 @@ -203,7 +203,7 @@ mes-ui/ ├── .env / .env.development / .env.preview # 环境变量 ├── .eslintignore / .eslintrc.js # ESLint 配置 ├── .gitignore # Git 忽略配置 -├── .node-version # Volta Node.js 版本锁定(18.16.0) +├── .node-version # Volta Node.js 版本锁定(20.19.0) ├── .npmrc # pnpm 配置(版本强校验) ├── .postcssrc.js # PostCSS 配置 ├── babel.config.js # Babel 配置 @@ -307,7 +307,7 @@ mes-ui/ **先排查版本:** ```bash -node --version # 项目要求 >=18.16.0 <19 +node --version # 项目要求 >=20.19.0 <19 pnpm --version # 项目要求 >=10.33.0 <11 ``` @@ -315,9 +315,9 @@ pnpm --version # 项目要求 >=10.33.0 <11 | 情景 | 解决办法 | | --- | --- | -| **用 Volta**(推荐) | `volta install node@18.16.0` + `volta install pnpm@10.33.0`,进入项目目录自动生效 | -| **用 nvm** | `nvm install 18.16.0 && nvm use 18.16.0`,再 `npm install -g pnpm@10.33.0` | -| **手动安装** | 去 [nodejs.org](https://nodejs.org/) 下载 18.16.0,再 `npm install -g pnpm@10.33.0` | +| **用 Volta**(推荐) | `volta install node@20.19.0` + `volta install pnpm@10.33.0`,进入项目目录自动生效 | +| **用 nvm** | `nvm install 20.19.0 && nvm use 20.19.0`,再 `npm install -g pnpm@10.33.0` | +| **手动安装** | 去 [nodejs.org](https://nodejs.org/) 下载 20.19.0,再 `npm install -g pnpm@10.33.0` | | **已有正确版本但切换不生效** | 重新打开终端,确保 `volta` / `nvm` 已正确加载 | > 版本验证通过后,重新执行 `pnpm install`。