JavaScriptNode.js大前端
Ubuntu 系统下 Node.js 环境配置与常见问题解决
在 Ubuntu 系统上安装和配置 Node.js 环境的完整流程，包括下载安装包、解压移动、建立软连接以及配置 npm 镜像源。此外，还通过 Vuepress 项目示例演示了依赖安装与权限问题解决，并总结了 Node.js 安装失败、命令无法识别、npm 包安装失败等常见问题的解决方案，帮助用户快速搭建开发环境。
在 Ubuntu 系统上安装和配置 Node.js 环境的完整流程，包括下载安装包、解压移动、建立软连接以及配置 npm 镜像源。此外，还通过 Vuepress 项目示例演示了依赖安装与权限问题解决，并总结了 Node.js 安装失败、命令无法识别、npm 包安装失败等常见问题的解决方案，帮助用户快速搭建开发环境。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
本文基于 Ubuntu 系统，全面详细展示如何一步步安装 Node.js，并在此基础上，实现将一个 Vuepress 项目拉取下来，并对其环境依赖进行配置，主要目的在于帮助大家快速配置 Node.js 和迅速利用 Node.js 进行一个新项目环境的配置。
首先需要查看自己的电脑架构，因为 Ubuntu 系统支持多种架构，比如我的是 X86_64 位的。
uname -a
接着下载 Node.js 的安装包。
官方英文网址：https://nodejs.org/en/download/ 官方中文网址：http://nodejs.cn/download/
在 Ubuntu 22.04 最新的系统中，从浏览器中打开安装包的位置时，系统会自动将 tar 安装包解压，十分方便。 对于其他不能自动解压的，输入下述命令即可！
tar -xvf node-v14.18.0-linux-x64.tar.xz
一般需要将这种环境包安装在特定的位置，直接将其移动即可（自己定义位置）。
mv node-v14.18.0-linux-x64 ~/envs/nodejs
确认一下 nodejs 下 bin 目录是否有 node 和 npm 文件，如果有执行下一步，如果没有重新下载执行上边步骤；
cd bin
ls
这里的路径需要修改成自己的路径。
sudo ln -s ~/envs/nodejs/bin/npm /usr/local/bin/
sudo ln -s ~/envs/nodejs/bin/node /usr/local/bin/
检查是否配置成功。
node -v
npm -v
由于网络限制，需要将其配置其他镜像源，不然下载速度很慢。
npm config set registry https://registry.npmmirror.com/
npm config get registry
到此为止，Node.js 已经配置成功！
这里以拉取一个 Vuepress 项目为例，将一个完整的 Vuepress 项目拉取下来，并利用 Node.js 对其配置，获取其依赖。
进入 Vuepress 项目中，执行下述命令，自动安装依赖，其他相关的项目按照所示进行执行也是一样的。
npm install
Vuepress 没有权限写入。
修改权限。
cd node_modules/.bin
chmod +x vuepress
之后再执行运行命令即可运行，原因在于此项目只有读写权限，没有执行权限，修改权限即可。
在安装 Node.js 的过程中，可能会遇到一些常见问题。以下是一些常见问题及其解决方法，帮助你顺利完成 Node.js 的安装与配置。
问题描述：在 Windows 或 macOS 系统上安装 Node.js 时，安装程序提示失败或者无法启动。
解决方案：
choco install nodejs（需先安装 Chocolatey）。brew install node（需先安装 Homebrew）。curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs
问题描述：安装完成后，在终端输入 node -v 或 npm -v 提示命令未找到。
解决方案：
C:\Program Files\nodejs\）已加入系统 PATH。node 所在路径在 PATH 中，例如：export PATH=$PATH:/usr/local/bin/node
which node
which npm
问题描述：使用 npm install 时出现权限错误或网络超时。
解决方案：
sudo npm install -g <package_name>
或配置 npm 全局安装目录：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm config set registry https://registry.npmmirror.com/
yarn 替代 npm：npm install -g yarn
yarn install
问题描述：安装完成后 Node.js 和 npm 版本不匹配，或者某些包要求特定版本。
解决方案：
nvm install 20
nvm use 20
npm install -g n
n stable
npm install -g npm@latest
问题描述：安装或运行 Node.js 时被防火墙或杀毒软件阻止。
解决方案：
node -v
npm -v
确认版本正确。