在 Vibe Coding 的时代，效率就是一切。因此，我们不推荐去官网下载安装包这种“古老”的方式。我们将使用 fnm (Fast Node Manager)。它是基于 Rust 编写的，速度极快，跨平台兼容性极好，能够让你在不同项目间无缝切换 Node 版本。
本教程将统一使用 fnm 来安装 Node.js 24，并启用最高效的包管理器 PNPM。无论你使用的是 Windows、Mac 还是 Linux 服务器，这套方案都能保证你的开发环境整洁、可控且高效。
第一步：安装 fnm (Node 版本管理工具)
请根据你的操作系统选择对应的安装命令。
🍎 macOS
如果你安装了 Homebrew (推荐)，直接运行：
brew install fnm
如果没有，使用官方安装脚本：
curl -fsSL https://fnm.vercel.app/install | bash
🪟 Windows
现在的 Windows 开发体验已经非常好了。推荐使用 PowerShell (以管理员身份运行) 或 Winget。
方式一：Winget (推荐)
winget install Schniz.fnm
方式二：Scoop (如果你用的话)
scoop install fnm
🐧 Linux (Debian / Ubuntu)
首先确保有 unzip 和 curl：
sudo apt update && sudo apt install curl unzip -y
然后运行安装脚本：
curl -fsSL https://fnm.vercel.app/install | bash
🐧 Linux (CentOS / RHEL / Fedora)
CentOS 用户请注意，首先安装基础依赖：
sudo yum install curl unzip -y
然后运行安装脚本：
curl -fsSL https://fnm.vercel.app/install | bash
第二步：配置 Shell 环境
安装完 fnm 后，你需要告诉你的终端（Shell）在每次打开时加载它。
对于 macOS / Linux (zsh 或 bash):
脚本安装通常会自动添加配置。如果没有，请将以下内容添加到你的 ~/.zshrc 或 ~/.bashrc 文件底部：
eval "$(fnm env --use-on-cd)"
对于 Windows (PowerShell):
如果你使用 PowerShell，请打开配置文件（可以通过 notepad $PROFILE 打开），添加：
fnm env --use-on-cd | Out-String | Invoke-Expression
操作提示： 配置完成后，请关闭并重新打开你的终端窗口，或者运行
source ~/.zshrc(Mac/Linux) 让配置生效。
第三步：安装 Node.js 24
现在的操作在所有平台上都是一样的了。
- 查看可用的 Node 版本（可选）：Bashfnm list-remote
- 安装 Node.js 24：Bashfnm install 24
- 设置为默认版本：Bashfnm default 24
验证安装：
node -v
# 输出应类似：v24.x.x
第四步：安装 PNPM
NPM 是默认自带的，但在这个时代，PNPM 才是王道。它通过硬链接机制节省磁盘空间，安装速度比 NPM 快 3 倍以上。
我们通过刚刚安装好的 Node.js 来全局启用 PNPM。
通用命令 (Windows / Mac / Linux):
# 开启 Corepack (Node.js 内置的包管理器管理工具)
corepack enable
# 激活最新版 PNPM
corepack prepare pnpm@latest --activate
如果上述命令因权限问题报错（常见于 Linux），你可以退回到传统方式：
npm install -g pnpm
验证安装：
pnpm -v
# 输出应类似：9.x.x
第五步：配置国内镜像 (中国开发者必读)
为了确保在中国大陆地区的下载速度，建议配置淘宝镜像（npmmirror）。
配置 NPM 镜像:
npm config set registry https://registry.npmmirror.com
配置 PNPM 镜像:
pnpm config set registry https://registry.npmmirror.com
验证配置:
pnpm config get registry
# 应输出: https://registry.npmmirror.com/
常见问题 (FAQ)
Q: 为什么不用 nvm？
A: nvm 是老牌工具，但在 Shell 启动速度上较慢（尤其是在 zsh 中）。fnm 是用 Rust 写的，速度极快，而且原生支持 Windows，不需要像 nvm 那样在 Windows 上使用单独的 nvm-windows 版本。
Q: Node.js 24 是 LTS (长期支持版) 吗？
A: 请注意，Node.js 的偶数版本通常会成为 LTS。但在刚发布初期，它可能处于 “Current” 状态。对于追求最新特性（如原生 .env 支持、WebSocket 客户端优化等）的开发者，v24 是很好的选择。生产环境如果求稳，可以使用 fnm install –lts。
结语
至此，你的全栈开发“三件套”：数据库 (Supabase)、存储 (R2) 和 运行环境 (Node 24 + PNPM) 均已就绪。
欢迎大家使用 https://github.com/hicyoucom/hicyou 创建属于自己的AI网址导航网站。
Demo: https://hicyou.com
0