Node.js安装成功需满足：下载LTS版msi包，安装时勾选“Add to PATH”和“Automatically install tools”，默认路径安装后执行node -v与npm -v均返回版本号；若失败则重开终端或检查PATH配置，并建议配置国内镜像源及重定向全局模块路径至node_global。
在Windows系统上搭建Node.js运行环境是开发Vue、React等前端项目的第一步，必须确保node和npm命令能在任意目录下直接调用，否则创建脚手架会失败、依赖安装中断、本地服务无法启动。
下载并安装Node.js官方LTS版本
打开浏览器，访问 https://www.php.cn/link/837d74cd0d4fbc51ead6d12738e01cba，点击绿色【Download Node.js LTS】按钮，下载后缀为 .msi 的 Windows 安装包（当前最新LTS版为 v22.14.0，适用于 Windows 10/11 64位系统）。
双击运行下载的 node-v22.14.0-x64.msi 文件，全程点击【Next】，在“Custom Setup”页面务必勾选：【Add to PATH】 和 【Automatically install the necessary tools】——前者让命令行识别 node/npm，后者避免后续执行 npm install 时因缺少 Python 或 VS Build Tools 报错。
安装路径可保持默认 C:\Program Files\nodejs\，不建议改到含中文或空格的路径（如 D:\我的项目\nodejs），否则某些 CLI 工具会解析失败。
立即学习“前端免费学习笔记（深入）”；
验证安装是否生效
按 Win + R 输入 cmd 回车，打开命令提示符。
依次执行以下两条命令：
node -v
npm -v
若均返回类似 v22.14.0 和 10.8.1 的版本号，说明安装成功；若提示“不是内部或外部命令”，请关闭所有终端窗口后重开，或检查安装时是否漏选了【Add to PATH】。
配置国内镜像源与全局模块路径
方法一：一键切换 npm 镜像源（解决下载慢、超时问题）
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档，供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图，还原页面结构与交互，强制套用固定文档模板，抽取跨页面共享规则，或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
在命令提示符中执行：
npm config set registry https://registry.npmmirror.com
执行后立即生效，无需重启终端。此后所有 npm install 均走国内镜像，速度提升5–10倍。
方法二：重定向全局模块安装位置（避免C盘权限冲突与磁盘占用）
在 C:\Program Files\nodejs\ 目录下手动新建两个文件夹：node_global 和 node_cache。
以管理员身份运行命令提示符（右键开始菜单→“命令提示符(管理员)”），执行：
第一步：npm config set prefix "C:\Program Files\nodejs\node_global"
第二步：npm config set cache "C:\Program Files\nodejs\node_cache"
第三步：将 C:\Program Files\nodejs\node_global 添加进系统环境变量 PATH（右键“此电脑”→属性→高级系统设置→环境变量→系统变量→Path→编辑→新建→粘贴该路径→确定）。
这一步做完，以后执行 npm install -g yarn 就不会因权限不足被拒绝，也不再污染 C 盘根目录。
