大家好,作为常年接触前端与后端工程化开发的从业者,每次带领新手入门学习,总会被问到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最新测试版。
- LTS版:运行状态平稳、兼容效果出色、出错概率极低,还有官方长期维护更新,不管是日常学习还是工作开发都很适配,十分推荐大家选用;
- Current版:虽说搭载了最新功能,但运行状态不够稳定,还极易出现依赖不兼容的故障,不建议新手上手使用。
下载的方式很简单,直接打开Node.js官方下载页面,系统会自动识别当前使用的电脑系统,推送适配的安装包供大家下载。
三、Windows 系统安装步骤(保姆级)
1. 下载安装包
进入官网之后,挑选Windows系统对应的LTS版.msi格式安装包,这款安装包采用可视化安装流程,全程只需要点击鼠标就能完成,不需要手动配置系统环境变量。
2. 开始安装
- 双击下载完成的.msi格式文件,弹出安装引导窗口后直接点击Next按钮;
- 勾选同意用户使用协议,接着继续点击Next推进安装流程;
- 选择对应的安装路径,尽量不要将程序安装在C盘,可自行修改存放路径,例如D:\Nodejs,方便后续查找文件、调整程序权限;
- 关键操作步骤,在「Tools for Native Modules」页面保持默认不勾选,无需安装额外的编译工具,以此节省电脑磁盘空间;
- 点击Install按钮开始安装,等待安装进度加载完毕,最后点击Finish按钮完成全部安装操作。
3. 验证安装是否成功
安装操作全部结束后,一定要查询对应版本信息,确认环境是否正常搭建完成。
- 按下Win+R组合快捷键,输入cmd指令打开命令提示符窗口;
依次输入下方两条指令,按下回车键运行即可查看对应信息。
node -v
npm -v
若是窗口能分别显示对应版本号,例如v20.10.0、10.2.3,就代表Node.js和npm已经安装成功,系统环境变量也自动配置完毕。
四、Mac 系统安装步骤
方法一:可视化安装包安装(推荐新手)
- 前往官网下载Mac系统对应的LTS版.pkg格式安装包;
- 双击下载好的安装包,跟着页面提示依次点击继续、同意、安装选项,输入电脑开机密码完成权限验证;
- 安装结束后打开终端工具,输入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盘用户文件夹中,长期使用会占用大量磁盘空间,建议大家将存放路径更换至非系统盘。
- 在Node.js安装文件夹中,例如D:\Nodejs,新建两个文件夹,分别命名为node_global、node_cache;
打开命令行窗口,依次运行下方两条设置指令。
npm config set prefix "D:\Nodejs\node_global"
npm config set cache "D:\Nodejs\node_cache"- 配置环境变量,右键此电脑选择属性,再找到高级系统设置,点击进入环境变量页面;
- 在系统变量的Path选项中,添加D:\Nodejs\node_global这条路径;
- 点击确定保存所有设置,后续全局安装的npm包都会自动存放在这个自定义路径中。
- 修改 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全套的安装以及配置教程,步骤清晰易懂、全程避开坑点。