安装工具并让终端找到 Node.js
🎯 引言
同一台服务器上可能装过不同版本的 Node.js。只输入 node 时,终端会用哪一份?本篇先在 Ubuntu 上安装课程用的 Node.js 24 LTS,再用一条命令查出 node 对应的文件路径。下面的命令都在 Ubuntu 上执行。如果通过 Mac 的终端连接,先登录 Ubuntu。
🧱 先用 APT 安装下载工具
Ubuntu 可以用 APT 安装软件。软件包里面有程序及其安装信息,软件源是 Ubuntu 获取这些软件包的仓库。安装前,先让 APT 获取最新的软件清单。 Ubuntu 软件包管理
sudo apt update
update 更新的是清单。要把程序装进系统,需要执行 install。这次装三个包,curl 负责下载,ca-certificates 帮助验证 HTTPS 连接,xz-utils 用来解压后面的 .tar.xz 安装包。
sudo apt install curl ca-certificates xz-utils
先确认 curl 能运行。--version 会显示工具的版本。
curl --version
第一行以 curl 和版本号开头,例如 curl 8.5.0,就可以继续下载 Node.js。
🧱 选对 Ubuntu 要用的安装包
官方提供已经编译好的 Node.js 程序,解压就能运行。课程选用长期支持的 24.x 系列。先确认这台 Ubuntu 的 CPU 类型,官方把不同类型的安装包分开发布。 Node.js 版本说明
uname -m
| Ubuntu 上的输出 | 安装包名称中要找的部分 |
|---|---|
x86_64 | linux-x64 |
aarch64 | linux-arm64 |
按上表选架构,在官方下载页找到对应的 Node.js 24.x 安装包。这里选文件名以 .tar.xz 结尾的压缩包。 Node.js 24 下载目录
🛠 下载、核对并解压
把文件名准备好
直接从官方下载页复制安装包的链接,记下文件名。下面以 node-v24.22.2-linux-x64.tar.xz 为例,其中 v24.22.2 是版本,linux-x64 是架构。如果你选的是 ARM64 或其他 24.x 版本,下载和解压时都使用你选中的文件名。
先把文件下载到个人目录
创建一个专门放下载文件的目录。
mkdir -p "$HOME/linux-lab/downloads"
用 cd 进入它,后面的下载文件就会保存在这里。
cd "$HOME/linux-lab/downloads"
下面用 curl 下载。-f 遇到 HTTP 错误时报告失败,-L 跟随下载地址的跳转,-O 按下载地址末尾的文件名保存。
curl -fLO https://nodejs.org/dist/v24.22.2/node-v24.22.2-linux-x64.tar.xz
下载完成后,可用 ls 看看目录里有没有选好的 .tar.xz 文件。
确认下载的文件完整
官方还提供 SHASUMS256.txt,里面记着每个文件对应的校验值。校验值由文件内容算出,可以用来检查下载的文件是否与清单一致。下载同一版本的清单。 Node.js 校验说明
curl -fLO https://nodejs.org/dist/v24.22.2/SHASUMS256.txt
如果选了其他版本,把上面地址里的 v24.22.2 换成对应版本。然后用 sha256sum 检查下载结果。-c 表示按清单核对,--ignore-missing 跳过清单里列出的其他安装包。
sha256sum --ignore-missing -c SHASUMS256.txt
看到你下载的文件名后面出现 OK,就可以解压。下面是 x64 示例的结果。遇到 FAILED 或没有对应文件的结果时,先检查下载的压缩包和清单是否来自同一版本。
node-v24.22.2-linux-x64.tar.xz: OK
解压到课程约定的位置
我们把 Node.js 装到 /opt/linux-course/runtime。后面的系统服务也会从这里启动 Node.js。确认校验显示 OK 后,在首次安装时用管理员权限创建这个目录。
sudo mkdir -p /opt/linux-course/runtime
用 tar 解包。-x 表示解包,-f 后面写你下载的压缩包名,-C 指定解包的位置。安装包外面套了一层以版本命名的目录,--strip-components=1 去掉这一层,解开后就能在 runtime/bin 里找到 node。--no-same-owner 让解包时采用执行账号的所有权。
sudo tar -xf node-v24.22.2-linux-x64.tar.xz --strip-components=1 --no-same-owner -C /opt/linux-course/runtime
直接执行这份 node 的完整路径,核对版本。
/opt/linux-course/runtime/bin/node --version
如果选的是示例版本,输出就是 v24.22.2。这一步成功后,Node.js 已经可以运行。接下来让终端也能通过简短的命令名找到它。
🧰 让输入 node 时找到刚安装的程序
环境变量是 Shell 可以交给程序的设置。PATH 是其中一个变量,里面保存着要搜索的目录,目录之间用 : 分隔。只输入 node 时,Shell 会按顺序找,先找到哪一份就执行哪一份。
下面把课程的 bin 目录加到最前面,$PATH 保留原有的目录。export 使这项设置也能传给从当前终端启动的程序。
export PATH="/opt/linux-course/runtime/bin:$PATH"
用 command -v 查看 Shell 会怎样找到这个命令。也可以用 which node 检查搜索路径上能找到的文件。
command -v node
预期显示这一行。
/opt/linux-course/runtime/bin/node
这条 export 只会设置当前终端及它启动的程序。想让以后打开的 Bash 也有这个设置,可以用 Vim 打开 ~/.bashrc。这个文件存放 Bash 在交互使用时会读取的设置。
vim "$HOME/.bashrc"
在末尾添加刚才的 export PATH="/opt/linux-course/runtime/bin:$PATH",保存后新开一个 Ubuntu 终端,再用 command -v node 验证。
❓ 知识问答
Q1:用完整路径能运行,为什么只输入 node 却提示找不到?
完整路径直接指定了程序。只写 node 时,Shell 要从 PATH 中查找。先用 command -v node 检查,再核对当前终端是否已设置路径。
Q2:以后安装系统软件更新,会顺带升级这份 Node.js 吗?
sudo apt upgrade 升级的是 APT 管理的软件包。课程这份 Node.js 是从官方压缩包解到 /opt/linux-course/runtime 的,要单独维护它的版本。
🧪 小练习
新开一个 Ubuntu 终端,先运行 command -v node,再运行 node --version。前者应显示 /opt/linux-course/runtime/bin/node,后者应显示你安装的 v24.x 版本。路径不一致时,回到 ~/.bashrc 检查 export 那行,再开一个终端复测。
🎉 现在你能确认终端运行的是自己安装的那份 Node.js!
