sheng/mes-ui-d2
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

2
.env
View File

@@ -17,5 +17,5 @@ VUE_APP_I18N_FALLBACK_LOCALE=en
VUE_APP_ELEMENT_COLOR=#409EFF 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/

2
.node-version
View File

@@ -1 +1 @@
18.16.0 20.19.0

30
README.md
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` 字段） | | **pnpm** | `10.33.0` | 包管理器（`package.json` → `packageManager` 字段） |
> 配置文件说明： > 配置文件说明：
@@ -80,20 +80,20 @@ pnpm --version # 应输出 10.33.0
git clone <仓库地址> git clone <仓库地址>
cd mes-ui cd mes-ui
# Volta 检测到 .node-version 后，自动下载并安装 Node.js 18.16.0 # Volta 检测到 .node-version 后，自动下载并安装 Node.js 20.19.0
# 如果你本机没有这个版本，Volta 会提示 "Fetching node@18.16.0" —— 等它完成即可 # 如果你本机没有这个版本，Volta 会提示 "Fetching node@20.19.0" —— 等它完成即可
node --version # 应输出 v18.16.0 node --version # 应输出 v20.19.0
# 安装依赖 # 安装依赖
pnpm install pnpm install
``` ```
> **没有安装 Node 18.16.0 怎么办？** > **没有安装 Node 20.19.0 怎么办？**
> **Volta 用户**：无需手动操作。进入项目目录时 Volta 会自动检测 `.node-version`，如果本机缺这个版本，它会**自动下载安装**，你只需等待几秒终端提示完成即可。 > **Volta 用户**：无需手动操作。进入项目目录时 Volta 会自动检测 `.node-version`，如果本机缺这个版本，它会**自动下载安装**，你只需等待几秒终端提示完成即可。
> **nvm 用户**：执行 `nvm install 18.16.0 && nvm use 18.16.0`。 > **nvm 用户**：执行 `nvm install 20.19.0 && nvm use 20.19.0`。
> **手动安装**：去 [nodejs.org](https://nodejs.org/) 下载 Node.js 18.16.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 会自动下载并安装 - 如果该版本未安装，Volta 会自动下载并安装
- 传统方案（nvm）也兼容：`nvm use` 读取 `.nvmrc`，本项目同时提供 `.node-version` 供 Volta 使用 - 传统方案（nvm）也兼容：`nvm use` 读取 `.nvmrc`，本项目同时提供 `.node-version` 供 Volta 使用
@@ -203,7 +203,7 @@ mes-ui/
├── .env / .env.development / .env.preview # 环境变量 ├── .env / .env.development / .env.preview # 环境变量
├── .eslintignore / .eslintrc.js # ESLint 配置 ├── .eslintignore / .eslintrc.js # ESLint 配置
├── .gitignore # Git 忽略配置 ├── .gitignore # Git 忽略配置
├── .node-version # Volta Node.js 版本锁定（18.16.0） ├── .node-version # Volta Node.js 版本锁定（20.19.0）
├── .npmrc # pnpm 配置（版本强校验） ├── .npmrc # pnpm 配置（版本强校验）
├── .postcssrc.js # PostCSS 配置 ├── .postcssrc.js # PostCSS 配置
├── babel.config.js # Babel 配置 ├── babel.config.js # Babel 配置
@@ -307,7 +307,7 @@ mes-ui/
**先排查版本：** **先排查版本：**
```bash ```bash
node --version # 项目要求 >=18.16.0 <19 node --version # 项目要求 >=20.19.0 <19
pnpm --version # 项目要求 >=10.33.0 <11 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`，进入项目目录自动生效 | | **用 Volta**（推荐） | `volta install node@20.19.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` | | **用 nvm** | `nvm install 20.19.0 && nvm use 20.19.0`，再 `npm install -g pnpm@10.33.0` |
| **手动安装** | 去 [nodejs.org](https://nodejs.org/) 下载 18.16.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` 已正确加载 | | **已有正确版本但切换不生效** | 重新打开终端，确保 `volta` / `nvm` 已正确加载 |
> 版本验证通过后，重新执行 `pnpm install`。 > 版本验证通过后，重新执行 `pnpm install`。