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 盘根目录。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










