打开 nodejs.org 这个域名,官网首页最显眼的下载位置永远摆着两个巨大的绿色下载按钮。左边那个写着 LTS,官网右边写着 Current。下载很多人第一次来会愣一下——到底点哪个?官网我见过不少同事随手点了 Current,结果项目跑起来各种报错,下载回头骂 Node.js 不稳定。官网其实问题出在选择上,下载不是官网 Node 本身。
LTS 是下载 Long Term Support 的缩写,直译就是官网长期支持版。这个版本已经过了大半年的下载实战检验,bug 修得差不多了,官网API 也冻结了,下载不会突然给你加个破坏性改动。官网Current 则是带着最新特性跑在前面的版本,V8 引擎升到最新,实验性功能随便用,代价是可能踩到别人还没踩过的坑。生产环境用 LTS,这是基本常识。想尝鲜新语法、试试新 API,那就下 Current,但别拿它跑线上业务。
选好版本点进去,才是真正让人眼花缭乱的地方。Windows 用户会看到 .msi 和 .zip 两种包,macOS 用户面对 .pkg 和 .tar.gz,Linux 那边更热闹,x64、arm64、ppc64le 各种架构排了一长串。头一回下载的人很容易在这里卡住。
.msi 是安装包,双击一路下一步,装完自动配好环境变量,命令行敲 node -v 就能看到版本号。.zip 是免安装压缩包,解压完得自己把 bin 目录加到 PATH 里,否则终端里根本找不到 node 命令。我刚开始学的时候图省事下了 zip,解压后对着黑窗口敲了半天命令都没反应,后来才知道环境变量这回事。所以除非你有特殊需求,比如公司电脑没管理员权限装不了 msi,否则老老实实下安装包。
macOS 的 .pkg 同理,双击安装,省心。用 Homebrew 的话更简单,brew install node 一行搞定,版本管理还方便。Linux 用户分两派,一派直接下二进制包解压,另一派用 nvm 或者发行版自带的包管理器。我个人推荐 nvm,切换版本太方便了,不同项目依赖不同 Node 版本的时候不用来回卸载重装。
说到 nvm,这玩意儿在 Windows 上有个坑。官方 nvm 只支持 macOS 和 Linux,Windows 得用 nvm-windows,是另一个项目,命令虽然差不多但细节有差异。我当初在 Windows 上照着 Linux 教程操作,怎么都不对,后来才发现下错了工具。
下载页面往下拉,还能看到源码包。除非你要自己编译,或者研究 Node 内部实现,否则别碰。编译 Node 源码得装 Python、C++ 编译工具链,Windows 上还要 Visual Studio Build Tools,折腾半天可能还失败。有那时间不如直接下二进制。
另外官网还有个细节很多人没注意——页面底部有个 "All download options" 的链接。点进去能看到所有历史版本,包括已经停止维护的老版本。有些老项目锁死了 Node 8 甚至 Node 6,新版本跑不起来,就得来这里翻旧账。不过这些老版本早就不更新了,安全漏洞一堆,能升级还是尽量升。
下载完安装,命令行敲 node -v 和 npm -v,两个版本号都出来,基本就稳了。要是只出来一个,或者报 "command not found",八成是环境变量没配好。Windows 用户重开一个终端试试,macOS 和 Linux 用户检查一下 PATH 里有没有 node 的 bin 目录。这种小问题看着简单,卡住的时候真挺烦人。
官网下载这件事本身没什么技术含量,但选对版本、选对包型,能省掉后面一堆麻烦。我见过太多人在这第一步上栽跟头,然后花几个小时排查一个本可以避免的问题。花两分钟看清楚再点下载,比事后折腾划算得多。