node.js安装只需确保node -v和npm -v正常返回版本号，无需配置全局路径、cnpm或webpack；推荐用npx create-vite@latest创建项目，镜像源设为https://registry.npmmirror.com即可。
能直接用 npm 装 vite 或 @vue/cli，就不用折腾全局路径、cnpm、webpack 等冗余步骤——Node 环境本身只要 node -v 和 npm -v 能正常返回版本号，Vue 开发就已经具备基础条件。
确认 Node.js 安装是否真正可用
很多“安装成功”只是假象：命令行能运行 node -v，但后续 npm install 报错或卡死，大概率是环境变量没生效或权限/路径冲突。
- 打开全新终端（不是旧窗口重开），执行
node -v和npm -v—— 两者都必须有输出，且版本号不为v0.0.0或异常值 - 如果提示
'node' 不是内部或外部命令，说明系统 PATH 没包含 Node.js 安装目录（如C:\Program Files\nodejs\），需手动添加到「系统环境变量」的Path中 - 如果
npm -v报错或无响应，可能是杀毒软件拦截了npm的网络请求，或旧版 npm 存在 bug（Node.js v20+ 自带 npm v10+，基本稳定；低于 v18 的建议重装 LTS 版）
跳过全局路径重定向，避免 node_global 和 node_cache 坑
网上大量教程教你在 Node 安装目录下建 node_global、改 prefix、加 NODE_PATH，其实对 Vue 开发纯属多余，还容易引发插件识别失败、VSCode 终端找不到命令等问题。
- Vue 项目依赖（包括
vite、vue、eslint）默认走本地node_modules，根本不需要全局安装（npm install -g） -
npm config set prefix改全局路径后，VSCode 可能仍从默认%AppData%\npm加载 shell，导致终端里vue或vite找不到命令 - 除非你真要频繁用
vue create或vite命令行创建多个项目，否则直接用npx更安全：npx create-vite@latest临时调用，不污染全局
VSCode 终端必须能识别 npm，否则项目跑不起来
VSCode 内置终端有时会继承错误的 shell 环境（比如 PowerShell 加载了旧 profile，或 Git Bash 没读取系统 PATH），导致 npm run dev 报 command not found。
- 在 VSCode 中按
Ctrl+Shift+`打开终端，先运行which npm（macOS/Linux）或where npm（Windows）确认路径是否指向你安装的 Node.js 目录 - 如果路径不对，点击终端右上角「+」→ 选择「Command Prompt」或「PowerShell」（Windows）、「zsh」（macOS），再试一次
- 如果仍不行，在 VSCode 设置中搜索
terminal.integrated.defaultProfile，设为系统默认 shell（如 Windows 是PowerShell），并勾选terminal.integrated.inheritEnv（确保继承系统环境变量）
镜像源只设一次，别反复切 cnpm 和 npm
国内用户最常踩的坑是：装了 cnpm，结果 VSCode 里跑 npm install 失败，又去查 cnpm install 怎么配，最后两个命令混用导致依赖不一致。
- 只需执行一次：
npm config set registry https://registry.npmmirror.com/（阿里云镜像，2026 年仍稳定） - 验证：
npm config get registry返回该地址即可，不用装cnpm——npm本身已支持镜像，cnpm是历史兼容方案，现在反而容易和package-lock.json冲突 - 如果某次
npm install卡住，优先Ctrl+C中断，再npm cache clean --force，而不是换工具
真正卡住 Vue 启动的，90% 不是 Node 环境本身，而是 VSCode 终端没加载对 shell、或者你用管理员权限运行了 cmd 却在普通权限 VSCode 里敲命令——环境变量根本不同步。先关掉所有终端窗口，重启 VSCode，再从头跑一遍 npx create-vite@latest，比调半天 prefix 实在得多。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
