安装并配置nodejs

发表于 更新于 分类于 ， ， 阅读次数： 本文字数： 3.5k 阅读时长 ≈ 3 分钟

1. 安装 nodejs

Node.js 是一个基于 Chrome V8 引擎 的 JavaScript 运行时环境。

1.1. 下载安装文件

1.2. 安装

1.2.1. 安装步骤

1.2.1.1. windows 操作系统

双击安装文件, 点击下一步下一步, 按照安装指引进行.

1.2.1.2. linux 操作系统
1
2
# 解压
sudo tar -xvf /tmp/node-v20.12.2-linux-x64.tar.xz -C /usr/local
1.2.1.3. macos 操作系统

双击 node-v20.12.2.pkg 文件, 按照安装指引安装.

1.2.1.4. 设置环境变量(适用于 macOS 和 linux)

更新软链接

1
2
3

sudo ln -fs /usr/local/node-v20.12.2-linux-x64 /usr/bin/nodejs

将/usr/bin/nodejs/bin 添加到 path 环境变量,

这样做的好处是当升级或者切换版本时只需要更改软连接即可.

不需要修改环境变量.

新建/etc/profile.d/nodejs.sh 文件，内容如下

1
2
3

export PATH=$PATH:/usr/bin/nodejs/bin

1.3. 配置

由于不知名的原因, 国内访问 npm 仓库会很慢, 所以需要设置镜像, 淘宝为我们提供了很好的镜像源.

1
2
3
4
5
6
7
8
9
10
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 或者使用华为镜像
# npm config set registry https://mirrors.huaweicloud.com/repository/npm/
# 或者使用腾讯镜像
# npm config set registry http://mirrors.cloud.tencent.com/npm/
// 配置后可通过下面方式来验证是否成功
npm config get registry
// 或
npm info express

注：如果想还原 npm 仓库地址，只需再把地址配置成 npm 镜像就可以了

1
npm config set registry https://registry.npmjs.org/

1.4. 检测

1.4.1. 检测版本

1
node -v

1.4.2. 运行 hello-world

2. 安装 cnpm

有些时候通过 npm 安装包由于网络的原因可能会失败, 所以只要是在国内做开发建议使用 cnpm 替代 npm, 该程序会首先从国内镜像站点(淘宝镜像)拉取依赖包.
https://npm.taobao.org/

安装 cnpm 命令如下

1
sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

2.1. 检测是否安装成功

1
cnpm -v

3. 如何卸载 nodejs

有时安装过程中遇到无法解决的问题, 或安装了不合适的版本需要重新安装, 此时需要卸载重装. 卸载可以参考以下步骤.

3.1. windows 上卸载 nodejs

  1. 开始-搜索: node – 点击 uninstall node.js, 或者 从卸载程序卸载程序和功能。

  2. 重新启动（或者您可能会从任务管理器中杀死所有与节点相关的进程）。

  3. 寻找这些文件夹并删除它们（及其内容）（如果还有）。根据您安装的版本，UAC 设置和 CPU 架构，这些可能或可能不存在：

    1
    2
    3
    4
    5
    C:\Program Files (x86)\Nodejs
    C:\Program Files\Nodejs
    # 将
    C:\Users\{User}\AppData\Roaming\npm（或%appdata%\npm）
    C:\Users\{User}\AppData\Roaming\npm-cache（或%appdata%\npm-cache）

  4. 检查您的%PATH%环境变量以确保没有引用 Nodejs 或 npm 存在。
    可以使用命令行, 打开环境变量配置界面, 进行检查

    1
    rundll32 sysdm.cpl,EditEnvironmentVariables

  5. 如果仍然没有卸载，请 where node 在命令提示符下键入，您将看到它所在的位置 – 删除（也可能是父目录）。

  6. 重新启动，很好的措施。

3.2. 在 MacOS 上卸载 nodejs

这是卸载 Node 最具挑战性的方法，因为您必须追踪许多不同的文件，并逐个手动删除它们。

单击 Dock 中的 Finder 图标，选择 Go(前往)菜单，然后转到文件夹。

在文本框中粘贴以下目录路径：/usr/local/bin

查找名为“node”的文件，并将它们移到垃圾桶中。

对以下目录重复这三个步骤，将每个路径粘贴到“转到文件夹”中的文本框中，并将带有“node”的文件拖动到垃圾箱中。

1
2
3
4
5
6
7
8
9
10
11
12
13

/usr/local/bin

/usr/local/include

/usr/local/share/man/man1/

/usr/local/lib/dtrace/

/usr/local/share/doc/

/usr/local/share/systemtap/tapset/

在 Centos 上卸载 nodejs

如果是按照本教程安装的 nodejs, 卸载过程包含以下几个步骤.

  1. 停止正在运行的程序

    1
    2
    systemctl stop nginx
    systemctl stop pm2-root

  2. 删除软链接

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11

    # 删除以下三个软连接, 并检查任何node相关的软连接, 例如pm2, ng等等
    # 检查相关软链接
    cd /usr/bin
    ls -lt | grep -i node

    # 删除nodejs相关软链接
    sudo rm /usr/bin/node
    sudo rm /usr/bin/npm
    sudo rm /usr/bin/npx

  3. 删除软件

    1
    sudo rm -rf /usr/local/node-v20.12.2-linux-x64

  4. 删除配置文件

    1
    sudo rm ~/.npmrc

  5. 删除缓存文件

    1
    sudo rm -rf ~/.npm

在 ubuntu 上卸载 nodejs

  1. 删除/usr/bin 下的软连接
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

cd /usr/bin
ls -lt| grep node
# 将列出的nodejs相关的软连接都删除掉
# 删除angular cli
rm -f ng
# 删除npm
rm -f npm
# 删除node
rm -f node
# 删除npx
rm -f npx
# 删除typescript编译器
rm -f tsc
# 删除node-gyp-build
rm -f node-gyp-build
# 删除 node-gyp-build-optional
rm -f node-gyp-build-optional
# 删除 build-test
rm -f build-test

  1. 清除缓存

    1
    rm -rf ~/.npm

  2. 删除安装目录

    按照本教程安装的 nodejs 位于 /usr/local/node-vx.xx.x-linux-x64, 将其删除。

    例如：

    1
    rm -rf /usr/local/node-v18.16.1-linux-x64

4. 如何升级 Nodejs

参考我的博客 - Nodejs 升级以及快速版本切换

5. Nodejs 系列文章

最新更新以及更多 Nodejs 相关文章请访问 鹏叔的技术博客 - Nodejs

6. 参考文档

npm 的卸载与安装流程

完全卸载 node npm

npm 更换成淘宝镜像源以及 cnpm

Node 快速切换版本、版本回退(降级)、版本更新(升级)