Node.js安装与配置(详细步骤)
作者:mmseoamin日期:2023-12-05

前言

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

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

Node.js安装与配置

  • 一、安装Node.js
    • 1.下载
    • 2.安装
    • 3.添加环境变量
    • 二、验证是否安装成功
    • 三、修改模块下载位置
      • 1.查看npm默认存放位置
      • 2.在 nodejs 安装目录下,创建 “node_global” 和 “node_cache” 两个文件夹
      • 3.修改默认文件夹
      • 4.测试默认位置是否更改成功
      • 四、设置淘宝镜像
        • 1.将npm默认的registry修改为淘宝registry
        • 2.全局安装基于淘宝源的cnpm
        • 五、总结大家的问题
          • 1.勾选文件夹权限后,下载模块时仍然报错。
          • 2.使用`npm install express --global`安装express时提示:
          • 3.`cnpm -v`只能在cnpm目录下才可以正常显示版本号。
          • 4.安装完cnpm时 运行`cnpm -v `出现'cnpm' 不是内部或外部命令,也不是可运行的程序。

            一、安装Node.js

            1.下载

            Node.js官网下载

            根据自身系统下载对应的安装包(我这里为Windows11 64位,故选择下载第一个安装包)

            Node.js安装与配置(详细步骤),在这里插入图片描述,第1张

            2.安装

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第2张

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

            3.添加环境变量

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

            Node.js安装与配置(详细步骤),选择Path变量,第3张3.2 添加Node.js的安装路径(此处为E:\devTools\nodejs\)

            Node.js安装与配置(详细步骤),写入Node.js安装路径,第4张

            二、验证是否安装成功

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

            node -v
            

            输入npm -v查看npm版本

            npm -v
            

            如下图所示,即为安装成功:

            Node.js安装与配置(详细步骤),验证是否安装成功,第5张

            三、修改模块下载位置

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

            1.查看npm默认存放位置

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

            npm get prefix
            

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

            npm get cache
            

            Node.js安装与配置(详细步骤),在这里插入图片描述,第6张

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

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第7张

            3.修改默认文件夹

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

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

            设置缓存到 “node_cache” 文件夹

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

            如下图所示:

            Node.js安装与配置(详细步骤),在这里插入图片描述,第8张

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第9张

            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” 路径下。

            Node.js安装与配置(详细步骤),在这里插入图片描述,第10张如上图所示,下载express模块成功,然后在文件管理器中查看是否保存到上面自定义的路径下。

            Node.js安装与配置(详细步骤),在这里插入图片描述,第11张可以看到,express模块已经成功地下载到【E:\devTools\nodejs\node_global\node_modules】下。

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第12张

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第13张

            执行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
            

            Node.js安装与配置(详细步骤),在这里插入图片描述,第14张

            1.2 更换npm为国内镜像

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第15张1.3 检查镜像是否配置成功

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

            npm config get registry
            

            Node.js安装与配置(详细步骤),在这里插入图片描述,第16张如上图所示,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
            

            Node.js安装与配置(详细步骤),在这里插入图片描述,第17张

            2.2 本地查看cnpm模块

            Node.js安装与配置(详细步骤),在这里插入图片描述,第18张

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

            cnpm -v
            

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

            Node.js安装与配置(详细步骤),在这里插入图片描述,第19张

            五、总结大家的问题

            --------------------------- 分割线 2022.10.20 总结大家提的问题 ---------------------------

            非常感谢大家踊跃评论,可能部分评论的问题没有及时作出回答,在此道歉。

            下面是大家提出的一些问题并总结回答如下:

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

            回答:

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

            如果执行npm install命令安装模块仍然报错,可以再根据报错信息中的path将文件夹的权限都勾选上。Node.js安装与配置(详细步骤),在这里插入图片描述,第12张

            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两种方案选择其一即可。当然,小朋友才做选择,作为成年人,大家也可以都要(不是

            写在最后

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