Node.js安装后node -v和npm -v报错说明PATH未正确配置，根本原因是安装时未勾选Add to PATH（Windows）或未手动将Node路径加入shell配置文件（macOS/Linux），需重启VSCode使环境变量生效。
node -v 和 npm -v 报错或显示“不是内部或外部命令”
说明 Node.js 没有正确加入系统 PATH，VSCode 终端无法识别 node 或 npm。这不是 VSCode 本身的问题，而是环境变量没生效。
- 安装 Node.js 时务必勾选 Add to PATH（Windows 安装向导里有该选项）；macOS/Linux 用户需手动将
/usr/local/bin（或~/.nvm/versions/node/vX.X.X/bin）加入 shell 配置文件（如~/.zshrc）并执行source ~/.zshrc - VSCode 启动后，如果终端仍不识别命令，**必须重启 VSCode** —— 它只在启动时读取一次系统环境变量
- 验证方式：在系统终端（非 VSCode）中运行
node -v，成功后再打开 VSCode 测试；若系统终端也不行，重装 Node.js 并确认勾选 PATH
用 express-generator 初始化项目后，node www 启动失败
常见报错是 Error: Cannot find module 'express' 或 Cannot find module './www'，本质是模块路径或工作目录错位。
-
express myserver创建完后，必须先cd myserver，再运行npm install—— 否则node_modules不会生成，node www必然失败 -
www文件在bin/www，不是项目根目录下，所以启动前要cd myserver/bin，再执行node www；或者直接在项目根目录运行npm start（它会自动调用bin/www） - 如果你改过
package.json的"main"字段或删了bin目录，npm start就可能失效，此时应恢复默认结构或显式指定入口：node ./bin/www
想快速起一个静态文件服务器，但不想用 Express
Express 太重，纯 HTML/CSS/JS 小项目只需一个轻量 HTTP 服务，npx serve 或 npx http-server 更合适，且无需初始化项目。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 临时起服务：在项目根目录运行
npx serve -s（自动找index.html，支持 SPA fallback）或npx http-server -c-1（禁用缓存，适合开发） - 它们不修改本地文件、不生成
node_modules，适合单页原型、文档预览、静态资源调试 - 注意：这些命令依赖网络下载临时包，首次运行稍慢；若离线，可全局安装：
npm install -g serve，之后直接用serve -s - 别和
Live Server插件混淆 —— 它只服务当前打开的 HTML 文件，不处理路由或 API，而npx serve是完整静态服务器
调试 app.js 时断点不命中或提示 “No source available”
VSCode 调试器找不到源码映射，通常因为启动方式不对或 launch.json 配置偏离实际入口。
立即学习“前端免费学习笔记（深入）”；
- 确保
launch.json的program字段指向真实入口文件，比如"program": "${workspaceFolder}/app.js"，而不是bin/www（后者是 Express 默认入口，但常 require app.js） - 如果用
npm start启动，应配置runtimeExecutable为npm，args设为["start"]，并启用console: "integratedTerminal"便于观察日志 - 检查文件编码是否为 UTF-8 无 BOM；某些复制粘贴的代码含不可见字符，会导致 Node 解析失败，断点失效
- 修改代码后务必保存（Ctrl+S），VSCode 调试器不会热重载，需手动重启调试会话
Node.js 本地服务器的复杂点不在命令本身，而在路径、工作目录、模块加载三者的耦合关系——少一个 cd，多一个斜杠，都可能让 require 找不到文件。动手前先 pwd 确认位置，比反复重装更省时间。
