chore: 更新Node.js版本和后端接口端口
Some checks failed
Release pipeline / publish (push) Has been cancelled
Release pipeline / Always run job (push) Has been cancelled

1. 将.node-version中的Node版本从18.16.0升级到20.19.0
2. 更新README.md中所有相关的Node版本说明文档
3. 将后端接口地址端口从8787修改为22666
This commit is contained in:
sheng
2026-06-23 16:08:36 +08:00
parent e11366ab0c
commit 7ede037dd3
3 changed files with 17 additions and 17 deletions

2
.env
View File

@@ -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/

View File

@@ -1 +1 @@
18.16.0
20.19.0

View File

@@ -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.0Volta 自动读取切换)
├── .node-version → 20.19.0Volta 自动读取切换)
```
- 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`。