Node.js 与 npm 的安装与配置(详细教程)

· Java技术教程

大家好,作为常年接触前端与后端工程化开发的从业者,每次带领新手入门学习,总会被问到Node.js和npm该如何安装、怎样配置才能避开各类问题,毕竟这是前端开发以及Node后端开发的基础运行环境,若是安装与配置环节出现疏漏,后续安装项目依赖、运行项目都会频繁出现报错情况。

这篇教程会一步步带着大家完成操作,全程没有复杂难懂的操作,同时覆盖Windows、Mac两款常用电脑系统,从安装包下载、版本信息查询,到npm下载提速、全局包存放路径修改,再到各类常见问题的解决方法,一篇内容就能讲清全部知识点,新手跟着操作就能完成全套环境配置。

一、先搞懂:Node.js 和 npm 是什么关系

不少刚接触的朋友都会把这两款工具弄混淆,其实二者之间的关联特别好理解。

Node.js:依托Chrome V8引擎搭建的JavaScript运行载体,可以让JS代码脱离浏览器单独运行,还能实现后端接口开发、项目工程化搭建等多种实用功能。

npm:全称是Node Package Manager,属于Node.js自带的包管理工具,主要用来下载、管控各类项目所需依赖,比如Vue、React、Express这类第三方框架和工具库都能靠它管理。

说白了大家只要记住,安装Node.js的过程中,npm会自动同步安装到位,不用单独去下载对应程序,这也是我们后续搭建环境的核心方式。

二、安装前:版本选择很关键

Node.js官网会提供两款不同版本,新手直接挑选LTS版本(长期维护版)就可以,千万不要选择Current最新测试版。

下载的方式很简单,直接打开Node.js官方下载页面,系统会自动识别当前使用的电脑系统,推送适配的安装包供大家下载。

三、Windows 系统安装步骤(保姆级)

1. 下载安装包

进入官网之后,挑选Windows系统对应的LTS版.msi格式安装包,这款安装包采用可视化安装流程,全程只需要点击鼠标就能完成,不需要手动配置系统环境变量。

2. 开始安装

  1. 双击下载完成的.msi格式文件,弹出安装引导窗口后直接点击Next按钮;
  2. 勾选同意用户使用协议,接着继续点击Next推进安装流程;
  3. 选择对应的安装路径,尽量不要将程序安装在C盘,可自行修改存放路径,例如D:\Nodejs,方便后续查找文件、调整程序权限;
  4. 关键操作步骤,在「Tools for Native Modules」页面保持默认不勾选,无需安装额外的编译工具,以此节省电脑磁盘空间;
  5. 点击Install按钮开始安装,等待安装进度加载完毕,最后点击Finish按钮完成全部安装操作。

3. 验证安装是否成功

安装操作全部结束后,一定要查询对应版本信息,确认环境是否正常搭建完成。

  1. 按下Win+R组合快捷键,输入cmd指令打开命令提示符窗口;
  2. 依次输入下方两条指令,按下回车键运行即可查看对应信息。

    node -v
    npm -v

若是窗口能分别显示对应版本号,例如v20.10.0、10.2.3,就代表Node.js和npm已经安装成功,系统环境变量也自动配置完毕。

四、Mac 系统安装步骤

方法一:可视化安装包安装(推荐新手)

  1. 前往官网下载Mac系统对应的LTS版.pkg格式安装包;
  2. 双击下载好的安装包,跟着页面提示依次点击继续、同意、安装选项,输入电脑开机密码完成权限验证;
  3. 安装结束后打开终端工具,输入node -v和npm -v指令查询版本,能够正常显示版本号就代表安装成功。

方法二:Homebrew 安装(适合有 brew 环境)

若是电脑已经提前安装好Homebrew,直接打开终端工具,运行一条指令就能完成Node.js的安装操作。

brew install node

安装结束后,依旧用前文提到的两条指令查询版本,全程会自动完成环境配置,不需要手动进行额外操作。

五、npm 核心配置(必做,解决两大痛点)

安装成功之后,npm默认设置存在两处问题,一是依赖包下载速度迟缓,二是全局包默认存放至C盘,既占用磁盘空间还容易触发权限报错,下面就一步步调整优化。

1. 切换国内镜像源(加速下载)

npm默认镜像部署在海外,下载项目依赖时常出现卡顿、连接失败的情况,换成国内npmmirror镜像,也就是原先的淘宝镜像,能大幅提升依赖下载的速度。

打开命令行窗口,Windows系统用cmd、Mac系统用终端,运行下方这条指令。

npm config set registry https://registry.npmmirror.com

想要检查镜像是否替换成功,运行下方指令即可查看。

npm config get registry

页面显示https: //registry.npmmirror.com这条链接,就代表镜像切换完成。

2. 修改 npm 全局包安装路径(Windows)

npm全局包默认存放在C盘用户文件夹中,长期使用会占用大量磁盘空间,建议大家将存放路径更换至非系统盘。

  1. 在Node.js安装文件夹中,例如D:\Nodejs,新建两个文件夹,分别命名为node_global、node_cache;
  2. 打开命令行窗口,依次运行下方两条设置指令。

    npm config set prefix "D:\Nodejs\node_global"
    npm config set cache "D:\Nodejs\node_cache"

  3. 配置环境变量,右键此电脑选择属性,再找到高级系统设置,点击进入环境变量页面;
  4. 在系统变量的Path选项中,添加D:\Nodejs\node_global这条路径;
  5. 点击确定保存所有设置,后续全局安装的npm包都会自动存放在这个自定义路径中。
  6. 修改 npm 全局包安装路径(Mac)

打开终端工具,新建专门存放全局包的文件夹。

mkdir ~/.npm-global

修改npm全局包的默认存放路径。

npm config set prefix '~/.npm-global'

配置系统环境变量,让终端工具可以正常识别全局运行指令。

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

六、常见问题排查

1. 输入命令提示“不是内部或外部命令”

出现这类提示的根源,就是环境变量没有配置到位。

处理办法很简单,Windows系统手动将Node.js安装路径添加到系统Path变量中,Mac系统重启终端工具,重新运行环境变量配置指令即可。

2. npm 全局安装包报错,权限不足

出现这类报错,是因为默认安装路径没有对应的操作权限。

处理办法就是按照前文教程修改全局包存放路径,避开系统盘权限受限的目录,Windows用户还可以右键Node.js安装文件夹,开启用户完全控制权限。

3. 切换镜像后下载依旧慢

处理办法为先清理npm本地缓存,重新运行镜像切换指令,也可以临时用cnpm替代npm,运行对应指令完成cnpm安装后再下载依赖。

七、最后测试

全部配置操作结束后,全局安装一款常用工具包,测试环境是否正常运行。

npm install -g nodemon

安装完毕后输入nodemon -v指令查询版本,能正常显示版本号,就说明全局包路径、镜像配置都已经生效。

以上就是Node.js与npm全套的安装以及配置教程,步骤清晰易懂、全程避开坑点。