在 Node.js 官网上可以直接下载到各个平台的安装包,可以直接安装使用。
但是需要注意!!
直接通过下载安装包安装,并不最佳实践!!!
直接通过下载安装包安装,并不最佳实践!!!
国内用户通过官网下载一般速度很慢,安装后部分用户还会遇到一些权限问题 (导致执行 node 得加 sudo
切换管理员权限),
同时在实际开发场景中,一般会接触到多个项目,每个项目对 Node 的版本要求也是不一样的,所以咱需要一个 Node.js 的版本管理工具,
当然如果就想使用安装包安装的话,推荐使用国内镜像:npmmirror 进行下载,速度更快,无需魔法。
下面按照流行程度 (star⭐️ 数量) 分别介绍一下如下三个工具:
使用体感上,nvm
相对后 2 者相对慢一点,具体可以看这篇文章:安装 nvm 后终端启动变慢,更快的 Node 版本管理工具推荐。
读者选择上述三个中的一个工具安装成功即可!
读者选择上述三个中的一个工具安装成功即可!
读者选择上述三个中的一个工具安装成功即可!
安装多个可能会导致相互冲突。
下面开始介绍安装和简单使用方法 (分操作系统展开),读者可以先看一下大概的安装步骤和使用方法,最后再选择一个自己喜欢 (安装顺利) 的即可。
当然笔者推荐 Mac 和 Linux 使用 fnm
或者 volta
,Windows 使用 nvm
。
由于网络原因,部分工具安装过程可能不顺利,笔者本章节涉及的安装脚本和安装包都会汇总在最后的云盘资源中。
本小节主要介绍不同操作系统如何安装 nvm
,fnm
,volta
等这些工具,并在国外网站资源访问不通畅导致资源下载慢的情况下,提供了一些简单的解决方案。
示例使用设备如下。
| Mac | Linux | Windows | | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: | | Mac mini (M1, 2020),macOS Monterey 12.6 | Deepin V20 | Windows10 | | | | - |
方式 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
来查看默认的终端工具,来确定修改哪个文件。
配置完后,重启终端工具,验证结果如下。
方式 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)"
方式 1:一键安装脚本。
sh
curl https://get.volta.sh | bash
方式 2:资源下载到本地 get.volta.sh,再自行安装。
sh
bash ./get.volta.sh
推荐终端工具使用 Git Bash (随 Git 安装附带),更加适合日常开发。
当然没安装也不要紧,可以先用系统自动的 powershell 进行后续的操作。
window 上需要安装 nvm-window,
下载安装包,一路下一步就行。
全程使用管理员权限的 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
同样需要通过安装包进行安装,
一路回车下一步即可。
验证一下是否安装成功。
本小节主要介绍各个包管理工具如何 安装Node
,查看已安装Node版本
,切换Node版本
等常规操作,
通过 Node.js Release 仓库我们可以看到当下各版本的 EOF(End-of-life) 时间。
------------ 2023-12-07 截图 -------------
可以看到当下的 LTS (长期支持) 版本是 v20,
由于编写时间原因教程示例使用 18 展开,读者可以安装当下最新的或者 v18 均可(使用上不会有任何区别)
下面读者选取一个自己设备上安装的 Node 版本管理工具开始安装即可。
① 设置镜像源
先设置国内镜像源,加快安装速度。
```sh
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
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-sh,nvm-windows。
① 设置国内镜像源
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
fnm use 16 fnm use 18 ```
更多指令详见官方文档 fnm:docs/commands.md。
暂不支持修改 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
volta install node@18
volta install node@18.16.0 ```
设置项目默认版本,也可以为某个项目设置要使用的版本 (相关配置会自动添加到 package.json
文件中)。
sh
volta pin node@16
这样针对多人协作项目也能保持版本一致 (前提是都用 volta),
更多指令详见官方文档 volta。
本小节主要介绍编码的时候使用的工具 VS Code 以及一些推荐的插件及用法。
直接访问官网,安装即可,
安装过程中,无特殊情况,直接按照默认配置一直下一步 (Next) 即可,
各平台 logo 大体一致。
| mac | windows | linux | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | · | | |
VS Code 安装同时会注册一个 code
指令,方便快速通过终端打开文件或文件夹,
```sh
code filepath
code dirPath ```
如果提示指令不存在,可以打开 VS Code,按 F1
在对话框里输入 shell 自动完成相关环境变量的添加。
TIP:当然不习惯指令打开文件的用户,可以直接将目录或者文件拖拽到编辑器中打开。
本小节介绍几个常用的插件,方便后续开发,
在编辑器的左侧可以看到安装插件的入口。
对于英文不习惯的,可以安装汉化插件,对高频操作场景都做了汉化处理。
右键菜单中加入一个,唤起终端工具直接执行脚本的入口。
会将错误信息直接显示在代码旁边。
这一节主要介绍了在不同平台上安装 Node 的最佳实践,以及如何使用 nvm、fnm、volta 等工具管理多个 Node 版本,最后介绍了 VS Code 的安装和常用插件的安装。