前言

Node.js 官网上可以直接下载到各个平台的安装包,可以直接安装使用。

但是需要注意!!

直接通过下载安装包安装,并不最佳实践!!!

直接通过下载安装包安装,并不最佳实践!!!

国内用户通过官网下载一般速度很慢,安装后部分用户还会遇到一些权限问题 (导致执行 node 得加 sudo 切换管理员权限),

同时在实际开发场景中,一般会接触到多个项目,每个项目对 Node 的版本要求也是不一样的,所以咱需要一个 Node.js 的版本管理工具,

当然如果就想使用安装包安装的话,推荐使用国内镜像:npmmirror 进行下载,速度更快,无需魔法。

下面按照流行程度 (star⭐️ 数量) 分别介绍一下如下三个工具:

使用体感上,nvm 相对后 2 者相对慢一点,具体可以看这篇文章:安装 nvm 后终端启动变慢,更快的 Node 版本管理工具推荐

读者选择上述三个中的一个工具安装成功即可!

读者选择上述三个中的一个工具安装成功即可!

读者选择上述三个中的一个工具安装成功即可!

安装多个可能会导致相互冲突。


下面开始介绍安装和简单使用方法 (分操作系统展开),读者可以先看一下大概的安装步骤和使用方法,最后再选择一个自己喜欢 (安装顺利) 的即可

当然笔者推荐 Mac 和 Linux 使用 fnm 或者 volta,Windows 使用 nvm

1 安装 Node.js 版本管理工具

由于网络原因,部分工具安装过程可能不顺利,笔者本章节涉及的安装脚本和安装包都会汇总在最后的云盘资源中

本小节主要介绍不同操作系统如何安装 nvmfnmvolta 等这些工具,并在国外网站资源访问不通畅导致资源下载慢的情况下,提供了一些简单的解决方案。

示例使用设备如下。

| Mac | Linux | Windows | | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: | | Mac mini (M1, 2020),macOS Monterey 12.6 | Deepin V20 | Windows10 | | | | - |

1.1 Mac & Linux

nvm

方式 1:直接执行一键安装的脚本即可。

sh curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

可能由于网络原因会导致 raw.githubusercontent.com 的资源拉取失败。

方式 2:可以先将资源 v0.39.3-install.sh 下载到本地,然后通过 bash 执行,

sh bash ./v0.39.3-install.sh

最新的版本资源可以访问 GitHub:nvm-sh/nvm 获取

完成安装执行后,将会 提示配置环境变量

将下面这段配置添加到 ~/.zshrc 或者 ~/.bashrc 中,

sh export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion

可以通过 echo $0 来查看默认的终端工具,来确定修改哪个文件

配置完后,重启终端工具,验证结果如下。

fnm

方式 1:一键安装脚本。

sh curl -fsSL https://fnm.vercel.app/install | bash

方式 2:同理也可以先将资源 fnm-install.sh 下载到本地,然后 bash 执行。

sh bash ./fnm-install.sh

配置环境变量,将下面这段内容加入到 ~/.zshrc 或者 ~/.bashrc 中,

可以通过 echo $0 来查看默认的终端工具,来确定修改哪个文件

sh eval "$(fnm env --use-on-cd)"

volta

方式 1:一键安装脚本。

sh curl https://get.volta.sh | bash

方式 2:资源下载到本地 get.volta.sh,再自行安装。

sh bash ./get.volta.sh

1.2 Windows

推荐终端工具使用 Git Bash (随 Git 安装附带),更加适合日常开发。

当然没安装也不要紧,可以先用系统自动的 powershell 进行后续的操作。

nvm

window 上需要安装 nvm-window

下载安装包,一路下一步就行。

fnm

全程使用管理员权限的 PowerShell 操作

使用 Chocolatey 进行安装 (Chocolatey 是 windows 上的软件包管理工具),

如果没有 choco 指令,可以运行下述脚本一键安装 (这段脚本在官网也有)。

sh Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

接下来是安装 fnm

sh choco install fnm

查看版本,检查安装情况。

配置环境变量!!! 重要

(推荐 😄) 使用 Git Bash 作为终端工具,

将下面的内容添加到 ~/.bashrc 中即可。

sh eval "$(fnm env --use-on-cd)"

推荐使用内置 vi 编辑器直接进行文件内容的编辑,下面是操作演示:

(不推荐 😞) 如果使用 powershell 将下面的内容添加到 ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 中。

也可通过 $PROFILE 获取到这个文件的路径

powershell fnm env --use-on-cd | Out-String | Invoke-Expression

volta

同样需要通过安装包进行安装,

一路回车下一步即可。

验证一下是否安装成功。

2 安装 Node.js

本小节主要介绍各个包管理工具如何 安装Node查看已安装Node版本切换Node版本 等常规操作,

通过 Node.js Release 仓库我们可以看到当下各版本的 EOF(End-of-life) 时间。

------------ 2023-12-07 截图 ------------- image.png

可以看到当下的 LTS (长期支持) 版本是 v20,

由于编写时间原因教程示例使用 18 展开,读者可以安装当下最新的或者 v18 均可(使用上不会有任何区别)

下面读者选取一个自己设备上安装的 Node 版本管理工具开始安装即可。

2.1 nvm

① 设置镜像源

先设置国内镜像源,加快安装速度。

```sh

linux 和 mac使用下面这条

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

windows 使用

nvm node_mirror https://npmmirror.com/mirrors/node/ ```

② 安装 Node

安装目标版本。

sh nvm install v18.16.0

③ 查看已安装 Node 版本

sh nvm ls

④ 切换到已安装的其它版本

sh nvm use v16.17.0

更多指令见官方文档 nvm-shnvm-windows

2.2 fnm

① 设置国内镜像源

sh export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node"

② 安装 Node

将需要安装的版本记录到文件里 .node-version

sh echo 18.16.0 >.node-version

执行安装。

sh fnm install

③ 查看已安装的版本

sh fnm list

④ 切换版本

```sh fnm use

demo

fnm use 16 fnm use 18 ```

更多指令详见官方文档 fnm:docs/commands.md

2.3 volta

暂不支持修改 Node 镜像源,但可以通过设置终端代理加速下载,前提是自己拥有代理服务

```sh

终端中执行如下指令,临时设置变量

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890 ```

① 安装目标版本

sh volta install node@18.16.0

② 查看已安装版本

sh volta list node

③ 切换版本

切换全局默认版本,同样执行 install 指令 (已存在的不会重复安装)。

```sh volta install node@version

demo

volta install node@18

volta install node@18.16.0 ```

设置项目默认版本,也可以为某个项目设置要使用的版本 (相关配置会自动添加到 package.json 文件中)。

sh volta pin node@16

这样针对多人协作项目也能保持版本一致 (前提是都用 volta),

更多指令详见官方文档 volta

3 安装&配置 IDE

本小节主要介绍编码的时候使用的工具 VS Code 以及一些推荐的插件及用法。

3.1 安装 VS Code

直接访问官网,安装即可,

安装过程中,无特殊情况,直接按照默认配置一直下一步 (Next) 即可,

各平台 logo 大体一致。

| mac | windows | linux | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | · | | |

VS Code 安装同时会注册一个 code 指令,方便快速通过终端打开文件或文件夹,

```sh

打开某个文件

code filepath

打开文件夹

code dirPath ```

如果提示指令不存在,可以打开 VS Code,按 F1 在对话框里输入 shell 自动完成相关环境变量的添加。

TIP:当然不习惯指令打开文件的用户,可以直接将目录或者文件拖拽到编辑器中打开

3.2 必要插件安装

本小节介绍几个常用的插件,方便后续开发,

在编辑器的左侧可以看到安装插件的入口。

简体中文支持

对于英文不习惯的,可以安装汉化插件,对高频操作场景都做了汉化处理。

Code Runner

右键菜单中加入一个,唤起终端工具直接执行脚本的入口。

Error Lens

会将错误信息直接显示在代码旁边。

4 下载资源汇总

小结

这一节主要介绍了在不同平台上安装 Node 的最佳实践,以及如何使用 nvm、fnm、volta 等工具管理多个 Node 版本,最后介绍了 VS Code 的安装和常用插件的安装。