游客发表
Node.js 的官网安装包在官网直接下就行,但有几个坑我踩过,下载值得说一下。安装打开 nodejs.org,官网你会看到两个大按钮:LTS 和 Current。下载别犹豫,安装选 LTS。官网Current 是下载给那些急着试新特性的人用的,版本号跳得快,安装偶尔还会碰到某个包不兼容。官网LTS 是下载长期支持版,稳定得多,安装公司里跑的官网项目基本都锁这个。
下载页面会自动识别你的下载系统。Windows 给的安装是 .msi 安装包,macOS 给的是 .pkg,Linux 用户一般直接看命令行那一段。我用的 Windows,下载完双击,一路 Next 就行。但有一个步骤别跳过——安装向导里有个勾选项叫 “Automatically install the necessary tools”。这个选项会额外装 Python 和 Visual Studio Build Tools,大概占 2-3 GB 空间。如果你只是写写脚本、跑跑前端构建,不装也行。但要是以后打算用 node-gyp 编译原生模块,比如 bcrypt 或者 sqlite3,那还是勾上,省得后面报错再回来折腾。
装完之后,打开终端或者 cmd,敲 node -v。正常的话会返回版本号,比如 v20.11.0。再敲 npm -v,npm 是跟着 Node.js 一起装的,不用单独下。两个命令都有输出,说明环境变量配好了。如果提示 “不是内部或外部命令”,八成是安装时没勾 “Add to PATH”,重新跑一遍安装包,把那个选项选上就行。
macOS 用户如果用 Homebrew,其实一行命令就完事:brew install node。但我不太推荐新手这么干。Homebrew 装的 Node 版本更新太勤,有时候你昨天还能跑的代码,今天 brew upgrade 一下就挂了。官网下载的 pkg 安装包反而更可控,想换版本直接下新的覆盖安装,旧版本自动清掉。
Linux 这边稍微麻烦点。Ubuntu 的 apt 源里自带 Node.js,但版本通常很老,可能是 v12 甚至 v10。别用那个。去官网下载页,下面有个 “Installing Node.js via package manager” 的链接,点进去找到 Nodesource 的脚本。照着复制两行命令,先加源再 install,装出来的就是当前 LTS。CentOS 和 Fedora 也是类似流程。我见过有人直接 apt install nodejs,然后 npm 装包各种报 engine 错误,折腾一下午,其实就是版本太旧。
还有一个细节:Windows 上装完 Node.js,有时候 PowerShell 里跑 npm 会报 “无法加载文件,因为在此系统上禁止运行脚本”。这不是 Node 的问题,是 PowerShell 的执行策略太严。用管理员身份打开 PowerShell,跑 Set-ExecutionPolicy RemoteSigned,选 Y 确认,就解决了。cmd 没这个问题。
装好之后建议做一件事:配一下 npm 的国内镜像。默认源在国外,装个 express 可能要等半分钟。命令行执行 npm config set registry https://registry.npmmirror.com,之后下载速度会快很多。这个镜像由阿里维护,同步频率很高,基本不会缺包。哪天想切回官方源,把地址换成 https://registry.npmjs.org 就行。
版本管理这块,如果你需要在多个 Node 版本之间切换,Windows 上用 nvm-windows,macOS/Linux 上用 nvm。别同时装官网的安装包和 nvm,会打架。nvm 自己就能下载和管理所有版本,包括 LTS。我现在的习惯是:新机器先装 nvm,然后用 nvm install --lts 一把梭。这样以后想试 Node 21 的新功能,nvm use 21 就切过去了,不用重新下安装包。
最后说一个真实案例。上个月帮朋友调一个 Vue 项目,npm install 一直卡在 node-sass 编译上。他装的是 Node 18,但 node-sass 只支持到 Node 16。解决办法要么降 Node 版本,要么把 node-sass 换成 sass(纯 JS 实现,不需要编译)。他选了后者,改一行 package.json 就通了。所以版本匹配这事,装 Node 的时候就得心里有数——不是越新越好,得看你项目里那些依赖包支持到哪。
友情链接