📘 SQL Mother · 部署笔记 & 环境备忘
📝 本文档为个人部署笔记，包含 Node.js 环境配置、npm 镜像设置、常见问题及核心概念摘录。所有命令已验证可用（Linux 环境）。
⚙️
环境搭建 · 命令流水
📌 推荐 Node 版本：v18.19.1 LTS (兼容性最佳) 或 v20 LTS
以下步骤基于腾讯云镜像 + 软链接，适配 sql-mother 项目。
以下步骤基于腾讯云镜像 + 软链接，适配 sql-mother 项目。
1️⃣ 克隆项目
git clone https://github.com/liyupi/sql-mother.git
cd sql-mother2️⃣ 安装 Node.js (v18.19.1) & 全局软链
wget https://mirrors.tencent.com/nodejs-release/v18.19.1/node-v18.19.1-linux-x64.tar.xz
mv node-v18.19.1-linux-x64 /usr/local/nodejs
ln -sf /usr/local/nodejs/bin/node /usr/bin/node
ln -sf /usr/local/nodejs/bin/npm /usr/bin/npm
ln -sf /usr/local/nodejs/bin/npx /usr/bin/npx3️⃣ NPM 镜像（国内源）& 安装依赖
npm config set registry https://registry.npmmirror.com/
npm get registry
npm cache clean --force
rm -rf node_modules package-lock.json # 可选的完全清理
npm install
npm run dev
✅ 启动后默认访问开发服务地址（常见
🔁 若需检查 Node 版本是否匹配，查看项目
http://localhost:5173）。🔁 若需检查 Node 版本是否匹配，查看项目
package.json 中 engines 字段。
💡 验证工具版本：
推荐使用 nvm 管理多版本 →
node -v && npm -v && npx -v推荐使用 nvm 管理多版本 →
nvm install 18.19.1 && nvm use
📋
笔记问答 · 核心概念
💰 1. fund 是什么？
资金支持 项目中的 “fund” 指「资金支持」，通常指开源项目维护的经济资助渠道（捐赠、赞助等）。
🔍 2. 如何确定 Node.js 项目所需版本？
- package.json 中的 “engines” 字段
- .nvmrc 文件声明
- README.md 文档说明
- 报错信息 含版本不兼容提示
- 新语法特性 无法识别时需升级版本
示例: “engines”: { “node”: “>=18.0.0” } 表示必须 ≥18。
🛠️ 3. node / npm / npx 职责区分
| Node.js | JS 运行时，执行脚本 (node app.js) |
|---|---|
| npm | 包管理器，安装/卸载依赖 (npm install express) |
| npx | 执行包内命令，免全局安装 (npx create-react-app my-app) |
🪄 4. 有没有“万金油” Node 版本？
Node.js 18 LTS (18.19.1) 是目前兼容性最广的稳定版；Node 20 LTS 同样可靠，适合需要较新特性的场景。两者均可作为首选。
📌 笔记补充
npm 镜像设置：
npm 镜像设置：
registry.npmmirror.com
📦
NPM 镜像 & 依赖管理
为了加速国内安装，配置阿里镜像源（npmmirror），相关命令：
npm config set registry https://registry.npmmirror.com/
npm config get registry # 验证
📌 常见清理重建步骤：
npm cache clean --force + rm -rf node_modules package-lock.json → 重新 npm install
若遇到包安装失败，可检查 node 版本是否符合项目 engines 要求，或切换镜像源回默认。
⚠️
常见报错与排查记录
- command not found: node → 检查软链接或 PATH，重做 ln 命令。
- npm ERR! code EINTEGRITY → npm cache clean –force 后重装。
- Error: 依赖安装失败，node-gyp 报错 → 安装 build-essential 及 python。
- 端口占用 (EADDRINUSE) → 更换端口或 kill 占用进程。
- 引擎不兼容 → 使用 nvm 切换至正确版本，参照 package.json 中的 engines 说明。
🔍 验证环境配置：
node -v , npm -v , npx -v 分别输出版本。
📹 相关视频参考（多媒体备忘）
文件: 外部资源，仅作笔记附件。
评论（0）
暂无评论