脚本专家 发表于 2026-6-12 21:00:04

Node.js和Vue开发环境搭建:从下载到全局工具链配置指南

在开始 Vue 项目开发之前,需要先搭建 Node.js 运行环境并安装 Vue CLI 等全局工具。本文基于 Windows 系统,详细记录从 Node.js 下载、环境变量配置到 Vue CLI、cnpm、express 等模块安装的完整流程。

一、下载与安装 Node.js

访问 Node.js 官方下载页(https://nodejs.org/en/download/),根据操作系统选择对应的安装包(注意区分 32 位与 64 位)。安装时建议修改默认路径(如 C:\node),避免安装在 Program Files 目录下可能引发的权限问题。一路 Next 完成安装后,打开 CMD 验证:


node -v   # 显示版本号即安装成功
npm -v    # 显示版本号即安装成功


二、配置 npm 全局模块与缓存目录

Node.js 安装完成后,需要调整 npm 的全局安装路径和缓存路径,避免占用系统盘空间或出现权限错误。

1. 在 Node.js 安装目录(例如 C:\node)下创建两个文件夹:node_global 和 node_cache。

2. 打开 CMD 执行以下命令设置路径:


npm config set prefix "C:\node\node_global"
npm config set cache "C:\node\node_cache"


3. 配置系统环境变量:
   - 右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。
   - 在“系统变量”中新建变量 NODE_PATH,值为 C:\node\node_global\node_modules。
   - 在“用户变量”中找到 Path,编辑新增 C:\node\node_global(替换原有 Node.js 路径或追加)。
   - 点击确定保存所有窗口。

三、安装 Vue 脚手架与常用全局模块

环境变量配置完成后,重新打开 CMD(使新配置生效),依次安装以下工具:

1. 安装 Vue CLI 2.x(旧版)(可选):

cnpm install --global vue-cli
vue -V   # 注意 V 大写,查看版本


2. 升级 npm 自身:

cnpm install npm -g
npm -v   # 查看 npm 版本(小写 v)


3. 安装 cnpm(淘宝镜像):

npm install cnpm -g
# 或指定镜像源安装
npm install -g cnpm --registry=https://registry.npm.taobao.org


4. 安装 Vue CLI 3.x/4.x(新版):

npm install -g @vue/cli


5. 安装 Express 框架(按需):

npm install express -g   # -g 表示全局安装


安装完成后,可通过
vue --version

express --version
验证全局命令是否可用。

注意事项

- 如果使用淘宝镜像,建议优先安装 cnpm,后续全局包均可通过 cnpm install 加速下载。
- 环境变量配置后必须重新打开 CMD 窗口才能生效。
- 全局模块安装路径若未正确设置,可能出现“无法识别 vue 命令”的错误,请检查 NODE_PATH 和 Path 是否指向 node_global。

以上步骤在 Windows 10 及 Windows 11 上测试通过,适用于个人开发机或团队统一环境搭建。

热心网友5 发表于 2026-6-12 21:10:00

Re: Node.js和Vue开发环境搭建:从下载到全局工具链配置指南

非常详细的教程,步骤清晰,尤其是环境变量配置和目录设置这两块,对新手特别友好。补充一点:如果后续需要同时维护多个Node版本,可以考虑装一个nvm-windows来管理,切换版本更方便。另外现在Vue官方推荐Vite作为构建工具,官方脚手架也升级成了`create-vue`,不过你介绍的`@vue/cli`依然稳定可用。感谢分享!

热心网友2 发表于 2026-6-18 18:10:02

Re: Node.js和Vue开发环境搭建:从下载到全局工具链配置指南

感谢楼主分享这么详细的搭建指南!步骤写得很清晰,特别是环境变量那部分,很多新手容易卡在 `vue` 命令找不到的问题上,你把 `NODE_PATH` 和 `Path` 都点出来了,非常实用。 补充一个小建议:如果电脑上需要同时维护多个 Node.js 版本(比如有些老项目要用低版本),可以考虑先装一个 `nvm-windows`,再用 `nvm` 切换版本,这样全局模块也能按版本隔离,避免冲突。当然,如果只是固定用一两个版本,按楼主的方法直接装也挺省事的。 另外,在设置 `prefix` 和 `cache` 时,路径里的反斜杠 `\` 在 CMD 里没问题,但有些 PowerShell 或 Git Bash 环境可能需要改成双反斜杠 `\\` 或正斜杠 `/`,供遇到报错的朋友参考。 再次感谢楼主的整理,收藏了!

热心网友3 发表于 2026-6-18 22:30:04

Re: Node.js和Vue开发环境搭建:从下载到全局工具链配置指南

教程写得非常详细,特别是关于环境变量配置和全局路径设置的部分,对新入门的同学来说特别实用。我之前在第一次装Vue CLI时就因为没改`prefix`导致全局命令找不到,按你的方法一步步配下来一次就成功了,感谢分享!另外想请教一下,如果电脑上同时有多个Node版本(比如需要老项目用旧版),有没有推荐的管理工具?比如nvm-windows的配置方法和你的这套流程能否兼容?
页: [1]
查看完整版本: Node.js和Vue开发环境搭建:从下载到全局工具链配置指南