mirror of
https://github.com/qianguyihao/Web.git
synced 2024-11-01 13:34:46 +08:00
663 lines
16 KiB
Markdown
663 lines
16 KiB
Markdown
---
|
||
title: 03-Node.js开发环境安装
|
||
publish: true
|
||
---
|
||
|
||
<ArticleTopAd></ArticleTopAd>
|
||
|
||
|
||
## Node.js 版本常识
|
||
|
||
- 偶数版本为稳定版（0.6.x ，8.10.x）
|
||
|
||
- 奇数版本为非稳定版（0.7.x ，9.11.x）
|
||
|
||
- LTS（Long Term Support）
|
||
|
||
参考链接：[node.js 中 LTS 和 Current 的区别](https://blog.csdn.net/u012532033/article/details/73332099)
|
||
|
||
## Node.js 运行环境配置：通过 Node.js 安装包（不推荐）
|
||
|
||
去 Node.js 的[官网](https://nodejs.org/en/)下载安装包：
|
||
|
||
|
||
|
||
我们也可以在<https://nodejs.org/en/download/releases/> 里下载历史版本。
|
||
|
||
|
||
|
||
注意，我们以一定要用偶数版（V4、V6 等)，不要用奇数版（比如 V5），因为奇数版不稳定。
|
||
|
||
后续如果需要安装其他版本，可以这样做：重新下载最新的安装包，覆盖安装即可。
|
||
|
||
但我们并不推荐直接采用 Node.js.msi（windows）或者 Node.js.pkg（Mac） 安装包进行安装，因为会产生如下问题。
|
||
|
||
**通过 Node.js 安装包产生的问题**：
|
||
|
||
- 安装新版本时，需要覆盖就版本；而且以前版本安装的很多全局工具包，需要重新安装。
|
||
|
||
- 无法回滚到之前的旧版本。
|
||
|
||
- 无法在多个版本之间切换（很多时候，不同的项目需要使用特定版本。或者，我想临时尝鲜一下新版本的特性）
|
||
|
||
因此，我们暂时先不用安装 Node.js，稍后用 NVM 的方式来安装 Node.js。通过 NVM 的方式，可以让多个版本的 Node.js 共存，并灵活切换。
|
||
|
||
|
||
|
||
## Node.js 运行环境安装：通过 NVM（推荐）
|
||
|
||
**[NVM](https://github.com/nvm-sh/nvm)**：node.js version manager，用来管理 node 的版本。
|
||
|
||
**我们可以先安装 NVM，然后通过 NVM 安装 Node.js**。这是官方推荐的做法。
|
||
|
||
Windows 和 Mac 下安装的 Node.js 的步骤如下。
|
||
|
||
### Windows 系统安装 Node.js
|
||
|
||
**1、安装 NVM**：
|
||
|
||
（1）我们去 <https://github.com/coreybutler/nvm-windows/releases> 下载 NVM 的安装包：
|
||
|
||
|
||
|
||
下载下来后，直接解压到 `D:\web`目录下：
|
||
|
||
|
||
|
||
（2）在上面的目录中，新建一个`settings.txt`文件，里面的内容填充如下：
|
||
|
||
```bash
|
||
root: D:\web\nvm
|
||
path: D:\web\nodejs
|
||
arch: 64
|
||
proxy
|
||
```
|
||
|
||
上方内容的解释：
|
||
|
||
- root 配置为：当前 nvm.exe 所在的目录
|
||
|
||
- path 配置为：node 快捷方式所在的目录
|
||
|
||
- arch 配置为：当前操作系统的位数（32/64）
|
||
|
||
- proxy 不用配置
|
||
|
||
（3）配置环境变量：
|
||
|
||
- `NVM_HOME` = `D:\web\nvm`（当前 nvm.exe 所在目录）
|
||
|
||
- `NVM_SYMLINK` = `D:\web\nodejs` （node 快捷方式所在的目录）
|
||
|
||
- PATH += `;%NVM_HOME%;%NVM_SYMLINK%`
|
||
|
||
配置成功后，重启资源管理器。
|
||
|
||
**2、验证：**(在 cmd 命令行中输入命令)
|
||
|
||
（1）输入`nvm`命令查看环境变量是否配置成功：
|
||
|
||
|
||
|
||
（2）输入 `nvm ls`，查看已安装的所有 node 版本。
|
||
|
||
（3）输入 `nvm -v`，查看 已安装的 nvm 版本。
|
||
|
||
（4）输入 `node -v`，查看正在使用的 node 版本。
|
||
|
||
|
||
如果 Node 安装失败，可以参考上面这个链接。
|
||
|
||
**3、安装指定版本的 Node.js**：
|
||
|
||
```bash
|
||
nvm install 版本号
|
||
|
||
# 安装举例
|
||
nvm install 12.20.0
|
||
|
||
# 使用该版本
|
||
nvm use 12.20.0
|
||
```
|
||
|
||
输入 `node -v`，查看当前使用的 node 版本。
|
||
|
||
关于 NVM 的常用命令，详见下一段。
|
||
|
||
补充：
|
||
|
||
如果 Node 安装失败，可以在上方的 `settings.txt`文件中，新增如下两行，修改镜像源：
|
||
|
||
```
|
||
node_mirror: https://npm.taobao.org/mirrors/node/
|
||
npm_mirror: https://npm.taobao.org/mirrors/npm/
|
||
```
|
||
|
||
- 参考链接：[安装 npm，nvm，node](https://segmentfault.com/a/1190000011114680)
|
||
|
||
|
||
### Mac 系统安装 Node.js
|
||
|
||
**1、安装 [NVM](https://github.com/nvm-sh/nvm)**：
|
||
|
||
（1）打开 终端.app，输入：
|
||
|
||
```bash
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
|
||
```
|
||
|
||
安装成功的界面：
|
||
|
||
|
||
|
||
完成后，nvm 就被安装在了`~/.nvm`下。我们可以点开 home目录，然后按快捷键「Cmd + Shift + .」，看看 `.nvm`这个文件夹在不在。
|
||
|
||
问题1、如果安装时提示 `Failed to connect to raw.githubusercontent.com port 443: Connection refused`。解决办法：我们直接访问 https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh ，将安装文件保存到本地，然后`bash install.sh` 执行这个本地文件，即可安装成功。
|
||
|
||
问题2、如果发现安装失败：
|
||
|
||
|
||
|
||
原因：Xcode 软件进行过更新。解决办法：打开 Xcode 软件，同意相关内容即可。
|
||
|
||
|
||
|
||
（2）配置环境变量：
|
||
|
||
编辑器打开`~/.bash_profile`文件，如果不会就在命令行输入`open ~/.bash_profile`。
|
||
|
||
（补充：如果你的 Mac 电脑里找不到`~/.bash_profile`文件，那就找找有没有`~/.profile`文件，或者`~/.bashrc`文件，或者`~/.zshrc`文件。如果还是没有，那你就手动创建一个`~/.bash_profile`文件）。
|
||
|
||
在最后一行输入：
|
||
|
||
```bash
|
||
export NVM_DIR="$HOME/.nvm"
|
||
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
|
||
```
|
||
|
||
如果你发现文件中已经存在了上面这行代码，就不用往里面加了。这一步的作用是每次新打开一个 bash，nvm 都会被自动添加到环境变量中。
|
||
|
||
最后，输入 `source ~/.bash_profile`重启环境变量的配置。
|
||
|
||
PS：NVM 现在已经不支持 Homebrew 的方式来安装了。
|
||
|
||
参考链接：<https://www.jianshu.com/p/a3f8778bc0a1>
|
||
|
||
|
||
|
||
参考链接：<https://blog.csdn.net/science_Lee/article/details/79214127>
|
||
|
||
**2、验证：**(在 终端命令行中输入命令)
|
||
|
||
（1）输入 `nvm` 命令查看环境变量是否配置成功。
|
||
|
||
（2）输入 `nvm ls`，查看已安装的所有 node 版本。
|
||
|
||
（3）输入 `nvm -v`，查看 已安装的 nvm 版本。
|
||
|
||
（4）输入 `node -v`，查看正在使用的 node 版本。
|
||
|
||
**3、安装指定版本的 Node.js**：
|
||
|
||
和 Windows 下一样，也是执行如下命令：
|
||
|
||
```bash
|
||
nvm install 版本号
|
||
|
||
# 举例
|
||
nvm install 12.18.0
|
||
```
|
||
|
||
网速有点慢，要稍等。
|
||
|
||
|
||
|
||
输入 `node -v`，查看当前使用的 node 版本。
|
||
|
||
安装好 `Node` 之后，`npm` 也会自动安装的，输入 `npm -v`，查看 npm 的版本。
|
||
|
||
关于 NVM 的常用命令，详见下一段。
|
||
|
||
**4、让 `.bash_profile` 环境变量永久生效**：
|
||
|
||
在 `~/.bash_profile` 中配置好环境变量后，发现每次重启终端后，配置都会失效，需要重新执行 `source ~/.bash_profile` 命令。
|
||
|
||
原因是，zsh加载的是 `~/.zshrc`文件，而 `.zshrc` 文件中并没有定义任务环境变量。
|
||
|
||
解决办法：打开 `~/.zshrc` 文件，在文件的末尾，添加如下内容即可：
|
||
|
||
```bash
|
||
source ~/.bash_profile
|
||
```
|
||
|
||
## NVM 的常用命令
|
||
|
||
> 注意，这一段说的是 NVM 的常用命令，不是 Node 的常用命令。
|
||
|
||
查看当前使用的 nvm 版本：
|
||
|
||
```bash
|
||
nvm --version
|
||
```
|
||
|
||
查看本地安装的所有的 Node.js 版本：
|
||
|
||
```bash
|
||
# 方式1
|
||
nvm ls
|
||
|
||
# 方式2
|
||
nvm list
|
||
```
|
||
|
||
**安装指定版本的 Node.js：**
|
||
|
||
```bash
|
||
nvm install 版本号
|
||
|
||
# 举例
|
||
nvm install 8.10.0
|
||
```
|
||
|
||
卸载指定版本 Node.js：
|
||
|
||
```bash
|
||
nvm uninstall 版本号
|
||
```
|
||
|
||
**切换使用指定版本的 node**：
|
||
|
||
```bash
|
||
nvm use 版本号
|
||
```
|
||
|
||
**设置node的默认版本**：
|
||
|
||
```bash
|
||
nvm alias default 版本号
|
||
```
|
||
|
||
|
||
**查看全局npm包的安装路径**：
|
||
|
||
```
|
||
npm root -g
|
||
```
|
||
|
||
|
||
查看远程服务器端的所有 Node 版本：
|
||
|
||
```bash
|
||
nvm ls-remote
|
||
```
|
||
|
||
执行上面的命令后，在列出的版本清单中，凡是用 `Latest LTS`标注的版本，则表明是**长期维护**的版本。我们在安装时，建议安装这些版本。当然，我们也可以在网址 <https://nodejs.org/en/download/releases/> 查看 LTS 的历史版本。
|
||
|
||
## Node.js 的常用命令
|
||
|
||
查看 node 的版本：
|
||
|
||
```bash
|
||
$ node -v
|
||
```
|
||
|
||
执行脚本字符串：
|
||
|
||
```bash
|
||
$ node -e 'console.log("Hello World")'
|
||
```
|
||
|
||
运行脚本文件：
|
||
|
||
```bash
|
||
$ node index.js
|
||
|
||
$ node path/index.js
|
||
|
||
$ node path/index
|
||
```
|
||
|
||
查看帮助：
|
||
|
||
```bash
|
||
$ node --help
|
||
|
||
```
|
||
|
||
**进入 REPL 环境：**
|
||
|
||
```bash
|
||
$ node
|
||
```
|
||
|
||
REPL 的全称：Read、Eval、 Print、Loop。类似于浏览器的控制台。
|
||
|
||
|
||
|
||
如果要退出 REPL 环境，可以输入`.exit` 或 `process.exit()`。
|
||
|
||
在 VS Code 里，我们可以在菜单栏选择“帮助->切换开发人员工具”，打开 console 控制台。
|
||
|
||
## 包和 NPM
|
||
|
||
### 什么是包
|
||
|
||
由于 Node 是一套轻内核的平台，虽然提供了一系列的内置模块，但是不足以满足开发者的需求，于是乎出现了包（package）的概念：
|
||
与核心模块类似，就是将一些预先设计好的功能或者说 API 封装到一个文件夹，提供给开发者使用。
|
||
|
||
Node 本身并没有太多的功能性 API，所以市面上涌现出大量的第三方人员开发出来的 Package。
|
||
|
||
### 包的加载机制
|
||
|
||
如果 Node 中自带的包和第三方的包名冲突了，该怎么处理呢？原则是：
|
||
|
||
- 先在系统核心（优先级最高）的模块中找；
|
||
|
||
- 然后到当前项目中 node_modules 目录中找。
|
||
|
||
比如说：
|
||
|
||
```javascript
|
||
requiere(`fs`);
|
||
```
|
||
|
||
那加载的肯定是系统的包。所以，我们尽量不要创建一些和现有的包重名的包。
|
||
|
||
### NPM 的概念
|
||
|
||
**NPM**：Node Package Manager。官方链接： <https://www.npmjs.com/>
|
||
|
||
Node.js 发展到现在，已经形成了一个非常庞大的生态圈。包的生态圈一旦繁荣起来，就必须有工具去来管理这些包。NPM 应运而生。
|
||
|
||
举个例子，当我们在使用 Java 语言做开发时，需要用到 JDK 提供的内置库，以及第三方库。同样，在使用 JS 做开发时，我们可以使用 NPM 包管理器，方便地使用成熟的、优秀的第三方框架，融合到我们自己的项目中，极大地加速日常开发的构建过程。
|
||
|
||
随着时间的发展，NPM 出现了两层概念：
|
||
|
||
- 一层含义是 Node 的开放式模块登记和管理系统，亦可以说是一个生态圈，一个社区。
|
||
|
||
- 另一层含义是 Node 默认的模块管理器，是一个命令行下的软件，用来安装和管理 Node 模块。
|
||
|
||
### NPM 的安装（不需要单独安装）
|
||
|
||
NPM 不需要单独安装。默认在安装 Node 的时候，会连带一起安装 NPM：
|
||
|
||
|
||
|
||
NVM、Node、NPM 安装之后，目录分布如下：
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
输入 `npm -v`，查看 npm 的版本：
|
||
|
||
|
||
|
||
如果上方命令无效，可能是之前的 node 并没有完全安装成功。解决办法：<https://segmentfault.com/a/1190000011114680>
|
||
|
||
另外，Node 附带的 NPM 可能不是最新版本，可以用下面的命令，更新到最新版本：
|
||
|
||
```bash
|
||
$ npm install npm -g
|
||
```
|
||
|
||
### 配置 NPM 的全局目录（暂略）
|
||
|
||
NPM 默认安装到当前正在使用 Node 版本所在目录下。我们建议重新配置 NPM 的全局目录。
|
||
|
||
输入`npm config ls`，查看：
|
||
|
||
|
||
|
||
### NPM包的版本管理
|
||
|
||
NPM包的管理都是通过项目根目录的 `package.json`文件实现。
|
||
|
||
当你使用 npm 安装一个包或者更新一个包的时候，package.json 里会自动添加**包名和包的版本**。npm 默认安装**符合条件**的最新版本，然后在版本号之前添加`^`符号。
|
||
|
||
NPM包的版本号，是用三位数表示。版本号前面的符号，代表开发者想要更新的的最新版本条件：
|
||
|
||
- 符号`^`：固定第一位数。表示主版本固定的情况下，可更新至最新版。例如 `vue: "^2.6.0"` 表示 2.6.0及其以上的2.x.x 都是满足的。
|
||
- 符号`~`：固定前两位数。表示次版本固定的情况下，可更新至最新版。例如 `vuex: "~2.6.0"`，2.6.0及其以上的2.6.x都是满足的。
|
||
- 无符号：三位数都固定。无符号表示固定版本号。例如 `vue: "2.6.0"`，此时一定是安装`2.6.0`版本。
|
||
|
||
参考链接：
|
||
|
||
- [请将你的npm依赖版本锁定](https://juejin.cn/post/6960928446826741796)
|
||
|
||
|
||
## NPM 的常用命令
|
||
|
||
查看 npm 当前版本：
|
||
|
||
```bash
|
||
npm -v
|
||
```
|
||
|
||
更新 npm：
|
||
|
||
```bash
|
||
npm install npm@latest -g
|
||
|
||
```
|
||
|
||
项目初始化：（执行完成后，会生成`package.json`文件）
|
||
|
||
```bash
|
||
npm init
|
||
|
||
# 快速跳过问答式界面，选择默认配置
|
||
npm init --yes
|
||
```
|
||
|
||
只在当前工程下安装指定的包：
|
||
|
||
```bash
|
||
npm install [package]
|
||
```
|
||
|
||
在全局安装指定的包：
|
||
|
||
```
|
||
npm install -g [package]
|
||
```
|
||
|
||
安装的包只用于开发环境，不用于生产环境：（会出现在 package.json 文件中的 devDependencies 属性中）
|
||
|
||
```bash
|
||
npm install [package] --save-dev
|
||
|
||
# 或者
|
||
npm install [package] -D
|
||
```
|
||
|
||
安装的包需要发布到生产环境：（会出现在 package.json 文件中的 dependencies 属性中）
|
||
|
||
```bash
|
||
npm install [package] --save
|
||
|
||
# 或者
|
||
npm install [package] -S
|
||
```
|
||
|
||
查看当前目录下已安装的 node 包：
|
||
|
||
```bash
|
||
npm list
|
||
```
|
||
|
||
查看全局已经安装的 node 包：
|
||
|
||
```bash
|
||
npm list -g
|
||
```
|
||
|
||
查看 npm 帮助命令：
|
||
|
||
```bash
|
||
npm --help
|
||
```
|
||
|
||
查看指定命令的帮助：
|
||
|
||
```bash
|
||
npm [指定命令] --help
|
||
```
|
||
|
||
更新指定的包：
|
||
|
||
```bash
|
||
npm update [package]
|
||
```
|
||
|
||
卸载指定的包：
|
||
|
||
```bash
|
||
npm uninstall [package]
|
||
```
|
||
|
||
查看配置信息：
|
||
|
||
```bash
|
||
npm config list
|
||
```
|
||
|
||
查看本地安装的指定包的信息，没有则显示 empty：
|
||
|
||
```bash
|
||
npm ls [package]
|
||
```
|
||
|
||
查看全局安装的指定包的信息，没有则显示 empty：
|
||
|
||
```bash
|
||
npm ls [package] -g
|
||
```
|
||
|
||
查看远程 npm 上指定包的所有版本信息：
|
||
|
||
```bash
|
||
npm info [package]
|
||
```
|
||
|
||
查看当前包的安装路径：
|
||
|
||
```bash
|
||
npm root
|
||
```
|
||
|
||
查看全局包的安装路径：
|
||
|
||
```bash
|
||
npm root -g
|
||
```
|
||
|
||
## 配置 npm 镜像源
|
||
|
||
由于 npm 默认的下载地址在国外（npmjs.com），有时候会被墙，导致无法下载或者下载很慢。因此，我们可以尝试切换成，从其他的镜像源下载 npm 包。
|
||
|
||
切换镜像源，有下面这几种方式：
|
||
|
||
- 方式 1：临时切换镜像源。
|
||
|
||
- 方式 2：切换镜像源
|
||
|
||
- 方式 3：通过 NRM 切换镜像源（最为推荐的方式）。
|
||
|
||
- 方式 4：cnpm。
|
||
|
||
下面来分别讲一下。
|
||
|
||
### 方式 1：临时切换镜像源
|
||
|
||
安装指定包的时候，通过追加 `--registry`参数即可。格式如下：
|
||
|
||
```bash
|
||
# 格式
|
||
npm install [package] --registry [https://xxx]
|
||
|
||
# 举例：在下载安装 express 这个包的时候，临时指定镜像源为 https://registry.npm.taobao.org
|
||
npm install express --registry https://registry.npm.taobao.org
|
||
```
|
||
|
||
### 方式 2：切换镜像源
|
||
|
||
```bash
|
||
npm config set registry https://registry.npm.taobao.org
|
||
```
|
||
|
||
执行上述命令后，以后下载所有 npm 包的时候，都会改为使用淘宝的镜像源。
|
||
|
||
### 方式 3：通过 NRM 切换镜像源（推荐）
|
||
|
||
**NRM**：Node Registry Manager。作用是：**切换和管理 npm 包的镜像源**。
|
||
|
||
- 项目地址：<https://www.npmjs.com/package/nrm>
|
||
|
||
- GitHub 地址： <https://github.com/Pana/nrm>
|
||
|
||
**安装 NRM**：
|
||
|
||
```bash
|
||
npm install -g nrm
|
||
```
|
||
|
||
|
||
|
||
**NRM 的常用命令：**
|
||
|
||
```bash
|
||
# 显示全部的镜像
|
||
nrm ls
|
||
|
||
# 使用淘宝的镜像
|
||
nrm use taobao
|
||
```
|
||
|
||
效果如下：
|
||
|
||
|
||
|
||
推荐的国内加速镜像淘宝：<https://npm.taobao.org/>
|
||
|
||
## 方式 4：安装 cnpm
|
||
|
||
- 项目地址：<https://npm.taobao.org/>
|
||
|
||
安装`cnpm`替换 npm（npm 由于源服务器在国外，下载包的速度较慢，cnpm 会使用国内镜像）：
|
||
|
||
```bash
|
||
npm install -g cnpm --registry=https://registry.npm.taobao.org
|
||
```
|
||
|
||
|
||
|
||
以后我们就可以通过 cnpm 命令去安装一个包。举例如下：
|
||
|
||
```bash
|
||
# 安装 vue 这个包
|
||
cnpm install vue
|
||
```
|
||
|
||
这里的单词 `install` 可以简写成 `i`。
|
||
|
||
## Node.js 的简单使用
|
||
|
||
我们可以输入`node`命令，然后在里面写 js 的代码。
|
||
|
||
或者，也可以 通过 node 运行 指定的 js 文件。比如，编写好一个 js 文件`01.js`，然后在命令行输入：
|
||
|
||
```bash
|
||
node 01.js
|
||
```
|
||
|
||
就可以执行这个 js 程序，直接在命令行查看运行结果。
|
||
|
||
## 赞赏作者
|
||
|
||
创作不易，你的赞赏和认可，是我更新的最大动力：
|
||
|
||
|