前端系列：Node.js安装与配置（详细步骤）

---

Node.js安装与配置（详细步骤）

前言

本篇博文记录了Node.js安装与环境变量配置的详细步骤，旨在为将来再次配置Node.js时提供指导方法。

另外：Node.js版本请根据自身系统选择，安装位置、全局模块存放位置和环境变量应根据自身实际情况进行更改。

一、安装Node.js

1.下载

Node.js官网下载
根据自身系统下载对应的安装包（我这里为Windows11 64位，故选择下载第一个安装包）

2.安装

双击安装包，点击Next，勾选使用许可协议，点击Next，选择安装位置（可根据个人情况更换路径，我这里选择安装在E:\devTools\nodejs）

继续点击Next，点击Next，点击Install，点击Finish完成安装。

3.添加环境变量

3.1 进入环境变量，编辑【系统变量】下的变量【Path】

3.2 添加Node.js的安装路径（此处为E:\devTools\nodejs\）

二、验证是否安装成功

进入cmd命令行窗口，输入node -v查看nodejs版本

node -v

输入npm -v查看npm版本

npm -v

如下图所示，即为安装成功：

三、修改模块下载位置

此步骤修改以后npm全局下载模块的保存位置，可根据自身情况选择是否更改。

1.查看npm默认存放位置

使用npm get prefix查看npm全局模块的存放路径

npm get prefix

使用npm get cache查看npm缓存默认存放路径

npm get cache

如上图所示，npm 全局模块存放位置以及cache的存放位置，默认是在 C 盘 “C:\Users\用户\AppData” 下。

2.在 nodejs 安装目录下，创建 “node_global” 和 “node_cache” 两个文件夹

3.修改默认文件夹

设置全局模块的安装路径到 “node_global” 文件夹，

npm config set prefix "E:\devTools\nodejs\node_global"

设置缓存到 “node_cache” 文件夹

npm config set cache "E:\devTools\nodejs\node_cache"

如下图所示：

注意：由于 node 全局模块大多数都是可以通过命令行访问的，还要把【node_global】的路径“E:\devTools\nodejs\node_global”加入到【系统变量 】下的【PATH】 变量中，方便直接使用命令行运行，如下图所示：

4.测试默认位置是否更改成功

经过上面的步骤，nodejs下载的模块就会自动下载到我们自定义的目录，接下来我们测试一下是否更改成功。输入下面的命令：

npm install express -g

或者

npm install express --global

注意：“-g”等同于“–global”，“-g” 是全局安装，不加“-g”就是默认下载到当前目录。“-g” 表示安装到之前设置的【node_global】目录下，同时nodejs会自动地在node_global文件夹下创建【node_modules】子文件夹， 即自动下载到“E:\devTools\nodejs\node_global\node_modules” 路径下。

如上图所示，下载express模块成功，然后在文件管理器中查看是否保存到上面自定义的路径下。

可以看到，express模块已经成功地下载到【E:\devTools\nodejs\node_global\node_modules】下。

注意：若执行命令npm install express -g出现如下报错：

是由于对文件夹操作的权限不够，右击Nodejs文件夹->属性->安全，点击编辑，将所有权限都✔即可。

※执行npm install express -g仍然出错的话继续将nodejs下【node_cache】、【node_global】、【node_modules】这三个文件夹的所有权限勾选，再次执行：

npm install express -g

即可下载成功。

四、设置淘宝镜像

1.将npm默认的registry修改为淘宝registry

说明：npm 默认的 registry ,也就是下载 npm 包时会从国外的服务器下载，国内下载会很慢，可以更换为国内镜像：https://registry.npm.taobao.org（官方已更换域名） https://registry.npmmirror.com。

1.1 查看当前使用的镜像路径

npm config get registry

1.2 更换npm为国内镜像

# npm config set registry https://registry.npm.taobao.org
npm config set registry https://registry.npmmirror.com

1.3 检查镜像是否配置成功

再次执行npm config get registry，检查当前的镜像路径：

npm config get registry

如上图所示，npm默认的registry已修改为国内镜像registry。

2.全局安装基于淘宝源的cnpm

说明：由于npm的服务器在海外，所以访问速度比较慢，访问不稳定 ，cnpm的服务器是由淘宝团队提供，服务器在国内，cnpm是npm镜像，一般会同步更新，相差在10分钟，所以cnpm在安装一些软件时候会比较有优势。但是cnpm一般只用于模块安装，在项目创建与卸载等相关操作时仍使用npm。

2.1 全局安装基于淘宝源的cnpm

# npm install -g cnpm --registry=https://registry.npm.taobao.org
npm install -g cnpm --registry=https://registry.npmmirror.com

2.2 本地查看cnpm模块

2.3 执行命令查看cnpm是否安装成功

cnpm -v

如下图所示，即代表cnpm配置成功。

五、总结大家的问题

--------------------------- 分割线 2022.10.20 总结大家提的问题 ---------------------------
非常感谢大家踊跃评论，可能部分评论的问题没有及时作出回答，在此道歉。
下面是大家提出的一些问题并总结回答如下：

1.勾选文件夹权限后，下载模块时仍然报错。

回答：
将node.js的安装路径和下面的【node_cache】、【node_global】、【node_modules】几个子文件夹的权限都勾选上。

如果执行npm install命令安装模块仍然报错，可以再根据报错信息中的path将文件夹的权限都勾选上。

2.使用npm install express --global安装express时提示：

npm WARN config global `--global`, `--local` are deprecated. Use `--location=global` instead.

回答：

这仅是一条警告，不是报错，仍可以正常下载模块，可以忽略，意思是npm不建议使用–global（等价于-g）或者–local，应该使用--location=global替代。
如果仍使用-g且不想让npm报warn，请自行百度查找解决办法。

3.cnpm -v只能在cnpm目录下才可以正常显示版本号。

回答：cnpm -v只能在cnpm安装的目录才能运行，应是未使用-g或–global进行全局安装导致。

4.安装完cnpm时 运行cnpm -v 出现’cnpm’ 不是内部或外部命令，也不是可运行的程序。

回答：
①首先确认是否使用的-g全局安装

npm install -g cnpm --registry=https://registry.npm.taobao.org

②如果是，检查npm模块本地存放位置是否有cnpm文件夹
③新建一个管理员身份的cmd命令行窗口再次执行cnpm -v

ps：如果将npm默认的registry修改为淘宝registry后，使用npm下载时就会使用国内的淘宝镜像，如果大家安装cnpm遇到报错或者安装后仍然有问题，就可以不用再安装cnpm了，npm淘宝镜像和cnpm两种方案选择其一即可。当然，小朋友才做选择，作为成年人，大家也可以都要（不是

六、底下评论

1. 作者大大，为什么我输入npm -v不显示版本号

A：环境变量配置好了吗？

Q：我的也是npm不显示版本号，后面的express模块也安表情包装不了
环境变量配置好了

A：是【Win+R】输入cmd打开的命令行窗口吗？
输入node -v可以查看到node的版本吗？

2. npm config set prefix “E:\devTools\nodejs\node_global”，为什么没用55555

A：
①需要先手动创建node_global文件夹
②npm config set prefix "E:\devTools\nodejs\node_global"更改保存路径
③使用npm get prefix查看npm全局模块的存放路径
④设置环境变量
⑤修改文件夹权限

3. 第四步遇到问题了，我输入C:\Users\Lenovo>npm install express --global

Q：它显示

npm WARN config global `--global`, `--local` are deprecated. Use `--location=global` instead.

Q：请问作者大大怎么解决。

Q1：你试试用管理员模式打开命令行，之前看那样打开的就不显示那个了，或者是需要设置一个文件，具体是什么你去搜一下应该就出来了

A：

npm WARN config global --global, --local are deprecated. Use --location=global instead.

这仅仅是一条警告，不是报错可以忽略，意思是npm不建议使用--global（等价于-g）或者--local，应该使用--location=global替代。
如果仍使用-g且不想让npm报warn，请自行百度查找解决办法。

4. 你好，我第一次跟着你步骤，然后我删了最版本装了旧的，发现npm报错，因为你改了那个路径，npm默认存放位置，怎么回去，谢谢了

A：
npm config set prefix "默认路径"和npm config set cache "默认路径"更改回去就好了。默认路径的话可以参考三.1查看默认存放位置的路径，ly是我电脑的用户名，替换成你自己的就行了。

5. 博主最后一步cnpm -v可以在C盘目录下窗口正常运行是又添加了路径吗，我直接在C盘根目录下打不开，要在cnpm目录下才可以运行该命令

A:
1、不需要再添加路径或变量了，按照前面的步骤配置就能全局正常使用cnpm了，另外设置淘宝镜像的话，把npm的原registry修改成阿里镜像后，使用npm也是使用的是国内的淘宝镜像，可以不用再安装cnpm了，两者自己看情况怎么选择，可以都配置，也可以仅配置一项目。
2、至于你的cnpm只能在cnpm目录才能运行，你是不是没有使用-g或–global全局安装。

6. 安装模块 它安装到node_cache里面了 这是啥情况

A：把下载路径设置错了吧，设置完后可以再用npm get prefix看看设置的路径是否正确
Q：弄好了

7. 你好，我这个第四步权限都勾上了但还是报错怎么办，求解，谢谢了

A：把nodejs安装路径下面的几个子文件夹的权限也勾选上了吗？

Q：我也是和他一样的问题，子文件也全都勾上了

8. 楼主你好，在安装完cnpm时 运行cnpm -v 出现’cnpm’ 不是内部或外部命令，也不是可运行的程序，该怎么解决呢

A: 是使用的-g全局安装吗

npm install -g cnpm --registry=https://registry.npm.taobao.org

如果是，再看一下npm模块本地存放位置是否有cnpm文件夹

Q：我也是最后一步这个问题 咋解决的

Q：重开一个命令行再运行cnpm -v

Q：这个可以表情包

9. 谢谢博主好文章，大家如果遇到安装完cnpm时出现不是内部或外部命令，也不是可运行的程序。需要重新打开cmd才能正常安装。

10. npm install express -g报错怎么办

佬，请问你解决了吗，我的也是

解决了吗

佬，请问你解决了吗，我的也是

11. 全能技术师

12. npm config set registry= 网页链接 这个镜像快得多

A：你访问一下https://registry.npm.taobao.org/地址试试，已经已被301重定向至https://registry.npmmirror.com/了，当然https://registry.npm.taobao.org/这个地址目前也能使用。

13. 1.勾选文件夹权限后，下载模块时仍然报错 解决方法：以管理员身份运行cmd, 然后执行命令就可以了

Q：就是管理员身份然后还是抱错了怎么解决

14. 为啥我的安装完expess和cnpm都在node_cache这个文件夹里面表情包

Q：你解决了吗，我也是的

A：在cmd窗口使用npm get prefix看一下设置的模块下载位置是不是你需要存放的位置呢

Q：重新设置一下
就好了，应该是之前搞错了

Q：那该怎么改一下子呢，确实是使用npm install express -g
这个口令

15. 按照步骤走的，第四步报错是为什么呀?

npm ERR! code ECONNRESET
npm ERR! network aborted
npm ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network
npm ERR! network If you are behind a proxy, please make sure that the
npm ERR! network 'proxy' config is set properly. See: 'npm help config'

npm ERR! A complete log of this run can be found in:
npm ERR! D:\Program Files (x86)\nodejs\node_cache\_logs\2023-04-26T02_41_47_747Z-debug-0.log

Q：我也出这个错，搞了好久都没弄出来，只要命令行有install就会卡在这里，网上查了各种都是说啥换源，但还是不行，大哥你解决了吗表情包

16. 下载淘宝镜像时4048

errno: -4048,
npm ERR! code: 'EPERM',
npm ERR! syscall: 'rename',

这个怎么解决

Q：咋解决的

Q：删缓存 重装了

Q：咋解决的

npm ERR! errno: -4048,
npm ERR! code: 'EPERM',
npm ERR! syscall: 'rename',
npm ERR! path: 'C:\\Program Files\\nodejs\\node_global\\node_modules\\cnpm\\node_modules\\npm\\node_modules\\.node-gyp.DELETE\\node_modules\\@npmcli',
npm ERR! dest: 'C:\\Program Files\\nodejs\\node_global\\node_modules\\cnpm\\node_modules\\npm\\node_modules\\node-gyp\\node_modules\\@npmcli',
npm ERR! parent: 'npm'
npm ERR! }
npm ERR!
npm ERR! The operation was rejected by your operating system.
npm ERR! It's possible that the file was already in use (by a text editor or antivirus),
npm ERR! or that you lack permissions to access it.
npm ERR!
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator.

17. 管理员身份命令cnpm -v也是显示非内外部文件是不是也就是安装失败但是不用管了

Q：不管会有影响吗？指的是运行方面。

Q：目前来看是没有影响，具体不清楚为什么会这样

18. 我的显示是华为cloud的镜像路径 用更换吗

19. 可以修改默认下载包路径吗

20. 安装环境频率太低，安完就忘了。失败的原因有很多，也有可能是网络问题，网速太慢，下载不了依赖。多找点资料试试吧

注意两点：
1、原先装有node.js的要先卸载，卸载程序，删除目录，还要删除环境变量。
2、使用 npm install express -g时，必须用管理员身份，否则会失败。打开命令窗时，要用管理员身份。

Q：我是用这个命令，成功了，但是没有生成相关的文件

Q：没生成文件，那就是配置不对

Q：佬，按照评论又试了一遍，还是不行呀表情包

21. 为什么我卡在了第二步，“不是内部或外部命令…”表情包

没装对

环境变量那里少配了

22. 我的用户变量有Path 系统变量没有

在系统变量里创建一个呗

23. 最新版是没有“node_global” 和 “node_cache” 这两个文件夹吗，我安装好几次都只有node_module其他两个都没有

安装express模块老出错的话可以把安装路径和C盘中的node.js文件的权限都打对勾，省的再一个个排查哪不对，然后就是我是安装完express成功后才出现了上面我提到没有的两个文件夹，而且没有配置改缓存路径express就自动在node.js安装的目录下生成“node_global” 和 “node_cache” 两个文件夹并且在node_global中自动生成一个node_module文件夹express安到了这里

这两个不是为了方便查看自己建的新文件夹吗（博客说的很清楚呐）

24. 我cnpm安装完了，但是一直显示不是内部的命令。

Q：系统变量path 加上 \node_global 并且安装cnpm之后 将弹窗关闭重新打开就有了

Q：试过了，还是不行，重启也试过了，都不行

Q：有用，感谢

25. 十分感谢，整体下来，镜像安装时需要重新打开cmd，其余跟着做就ok

26. 一直报错的先执行这个：npm config set strict-ssl false。原理自行上网查找

27. 为什么我卡在了第二步，“不是内部或外部命令…”表情包

Q：没装对

Q：环境变量那里少配了

28. 我的用户变量有Path 系统变量没有

Q：在系统变量里创建一个呗

29. 最新版是没有“node_global” 和 “node_cache” 这两个文件夹吗，我安装好几次都只有node_module其他两个都没有

Q：安装express模块老出错的话可以把安装路径和C盘中的node.js文件的权限都打对勾，省的再一个个排查哪不对，然后就是我是安装完express成功后才出现了上面我提到没有的两个文件夹，而且没有配置改缓存路径express就自动在node.js安装的目录下生成“node_global” 和 “node_cache” 两个文件夹并且在node_global中自动生成一个node_module文件夹express安到了这里

Q：这两个不是为了方便查看自己建的新文件夹吗（博客说的很清楚呐）

30. 如果cnpm-v显示不是内部或外部命令可以去环境变量path加个“地址\node_global\node_modules\npm”然后关闭再重新打开cmd窗口

31. 老师们我安装完cnpm时 运行cnpm -v 出现’cnpm’ 不是内部或外部命令，也不是可运行的程序。

然后输入圈一之后报错了怎么解决啊

没有将命令所在路径加入到环境变量中

32. 补充一下，如果遇到网络代理的问题，在利用镜像处理cnpm时，最好不要使用校园网，可能同一时间段有多次访问，从而访问失败，可以换自己的手机热点！！

33. 你好，卡最后一步了cnpm输入了然后显示

changed 66 packages in 41s
59 packages are looking for funding
run `npm fund` for details

但是还是没有cnpm文件，权限都拉满了，环境变量也弄了，为啥啊

34. 卡在第4步的去C:\Users{你的用户名} 这里把.npmrc文件给删了，记得打开显示隐藏文件才能找到这个文件

额，删了好像不行，继续按照下面的提示来就行了

35. node global 上的权限顺序不正确，可能导致某些数据项无法作用,这是怎么回事

写在最后

安装Node.js后，可通过安装Vue.js运行vue项目，Vue.js安装与创建默认项目可见下一篇博文：
https://blog.csdn.net/weixin_54626591/article/details/140082027

---

liyitongxue

Node.js安装与配置（详细步骤）