Node.js安装后node -v报“command not found”是因PATH未配置；nvm提示“command not found”是因未加载shell配置；npm start报错“Cannot find module”是因依赖未安装；VS Code调试HTML需用本地服务器而非file://协议。
Node.js 安装后 node -v 报“command not found”
说明系统没把 Node.js 的可执行路径加进 $PATH，常见于 macOS 手动下载 .pkg 安装、或 Windows 非默认路径安装后没勾选“Add to PATH”。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- macOS：检查
/usr/local/bin/node是否存在；若存在但无效，运行sudo ln -sf /usr/local/bin/node /usr/bin/node（仅临时绕过，推荐重装时选“Install Command Line Tools”） - Windows：打开“系统属性 → 高级 → 环境变量”，在“系统变量”中找到
Path，添加类似C:\Program Files\nodejs\的路径（注意不是子文件夹） - 验证是否生效：新开终端（不是当前已打开的窗口），再跑
node -v和npm -v
用 nvm 切换 Node.js 版本却提示 nvm: command not found
nvm 是 shell 级工具，安装后必须手动加载到当前 shell 配置里，否则每次重启终端都失效。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确认安装成功：检查
~/.nvm目录是否存在 - 加载 nvm：在
~/.zshrc（macOS Catalina+）或~/.bash_profile末尾追加export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" - 重载配置：
source ~/.zshrc（或对应 shell 配置文件） - 再执行
nvm install 18.18.2和nvm use 18.18.2，然后验证node -v
HTML 项目里跑 npm start 卡住或报错 Cannot find module 'webpack'
这不是 Node.js 环境问题，而是项目依赖缺失或未正确初始化。现代 HTML 开发常依赖构建工具，package.json 存在但 node_modules 没装，就会这样。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 先确认项目根目录下有
package.json，且含"scripts": { "start": "..." }字段 - 运行
npm install（不是npm i，虽等价但显式写全更防手误）——这步必须做，哪怕你刚 clone 下来 - 如果报 EACCES 权限错误，别用
sudo npm install，改用npm config set prefix ~/.local再重试 - 某些模板（如 Vite）需先
npm create vite@latest初始化，不能直接npm start
VS Code 里调试 HTML + JS 时断点不触发，控制台也看不到 console.log
VS Code 默认不自动 attach 到浏览器，它只管本地 Node.js 进程。纯 HTML 文件双击打开是走浏览器本地文件协议（file://），跨域且无服务上下文，很多调试能力被禁用。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 别双击打开 HTML，改用轻量服务器：在项目根目录运行
npx serve或npx http-server，然后访问http://localhost:5000 - VS Code 中按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入 “Debug: Open Configuration”，选 “Chrome” 或 “Edge”，生成.vscode/launch.json - 确保
launch.json里url指向的是http://地址，不是file:// - 启动调试前，先关掉所有已打开的同端口浏览器实例，避免端口占用或调试器冲突
