Ubuntu 系统下 Node.js 环境配置与常见问题排查
Ubuntu 系统下 Node.js 环境配置步骤包含下载对应架构安装包、解压移动至指定目录、建立软连接实现全局访问以及配置 npm 镜像源。常见问题涵盖权限不足、命令无法识别、npm 安装失败及版本不一致等,可通过修改权限、检查环境变量、切换镜像源或使用版本管理工具解决。

Ubuntu 系统下 Node.js 环境配置步骤包含下载对应架构安装包、解压移动至指定目录、建立软连接实现全局访问以及配置 npm 镜像源。常见问题涵盖权限不足、命令无法识别、npm 安装失败及版本不一致等,可通过修改权限、检查环境变量、切换镜像源或使用版本管理工具解决。

本文基于 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
确认一下 Node.js 下 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
确认版本正确。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 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