chore: 更新Node.js版本和后端接口端口
1. 将.node-version中的Node版本从18.16.0升级到20.19.0 2. 更新README.md中所有相关的Node版本说明文档 3. 将后端接口地址端口从8787修改为22666
This commit is contained in:
2
.env
2
.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/
|
||||
|
||||
|
||||
@@ -1 +1 @@
|
||||
18.16.0
|
||||
20.19.0
|
||||
|
||||
30
README.md
30
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`。
|
||||
|
||||
Reference in New Issue
Block a user