Node.js 安装及环境配置教程(Windows / macOS / Linux)
发布时间:2026/9/18 10:03:51 锦皓数字建站
`)
本文首发于 CSDN转载请注明出处。装 Node 最常见的两个翻车现场一个是追新装了非 LTS 版本工具链接连报错另一个是装完终端里敲node -v提示找不到命令其实是 PATH 没生效。这篇把版本怎么选、三个系统怎么装、装完配什么一次讲完。版本怎么选先看这张表版本线当前状态适合谁v25Current尝鲜线库作者、想体验新特性的人v24KryptonActive LTS大多数开发者无脑选这个v22JodMaintenance LTS已有项目锁定了 22 的团队v20IronMaintenance LTS老项目维护期使用一句话新装就用 v24 LTS。Node 官方的规则是偶数版本线进 LTSLTS 保证 30 个月的关键修复生产环境和日常开发都应该用 LTS。三个平台怎么安装平台推荐方式命令或途径Windows官方安装包从 nodejs.org 下载 LTS 的 .msi双击安装macOSHomebrewbrew install nodeUbuntu / DebianNodeSource 源见下方命令任意平台多版本需求nvm见下文Ubuntu / Debian 用 NodeSource 装最新的 LTScurl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejsCentOS / Fedora 把第一行换成https://rpm.nodesource.com/setup_lts.x再用dnf install。装完验证重开一个终端执行node-vnpm-v两个都能输出版本号才算装好。npm 是随 Node 一起装的不需要单独安装。要不要用 nvm 管理版本如果你的项目 A 要 Node 20、项目 B 要 Node 24直接装会造成版本打架用 nvm 一条命令切换。macOS / Linux 安装 nvm 后nvminstall--ltsnvm use--ltsnvmaliasdefaultlts/*注意 Windows 用户Windows 上要用的是 nvm-windows它和 nvm 是两个不同的项目命令略有差异去 nvm-windows 的发布页下载nvm-setup.exe安装路径不要带空格。装完必做的环境配置第一件换国内镜像源。默认源在国内拉包很慢换成 npmmirrornpmconfigsetregistry https://registry.npmmirror.com用npm config get registry确认生效。第二件处理 PowerShell 的执行策略。Windows 用户在 PowerShell 里跑 npm 脚本如果报npm.ps1 无法加载执行Set-ExecutionPolicyRemoteSigned-Scope CurrentUser第三件确认 PATH。命令找不到时先重开终端还不行就检查环境变量里有没有 Node 的安装目录和 npm 的全局目录两项缺哪个补哪个。这类教程发布之后的后置环节是确认收录和 AI 引用情况。我用墨衍做两件事批量 GEO 检测扫全部文章在 AI 搜索里的引用状态AI 图文同步把一篇稿子铺到多个平台会员还有发文额度提升密集更新期不用排队。墨衍会员权益 可以了解下。几个常见的坑装完命令找不到。九成是终端没重开。Windows 还要检查安装时「Add to PATH」有没有勾上。全局包安装报权限错误。Linux/macOS 别习惯性加 sudo长期看用 nvm 管理更干净nvm 装的 Node 全局包不需要 root。项目里 Node 版本对不上。在项目根目录放一个.nvmrc写上主版本号进目录nvm use自动切换。npm 装包特别慢或失败。回头检查镜像源是否换过公司内网还要确认代理设置。常见问题QLTS 版本号会一直变教程里的写法会过期吗安装命令都是指向「LTS」这个线而不是具体小版本比如 NodeSource 的setup_lts.x会自动跟到最新的 LTS不用改命令。Qv24 和 v22 都标着 LTS选哪个v24 是 Active LTS积极维护v22 已经进入维护期。新项目选 v24只有在维护老项目时才需要 v22。Qnpm 需要单独升级吗npm 随 Node 一起更新一般不用单独动。确有需要时npm install -g npmlatest。Q装了 nvm 还能装官方安装包吗不建议并存两套 Node 会让 PATH 指向混乱。二选一已经装了官方包再想用 nvm 的先把旧的卸干净。Q怎么卸载 NodeWindows 在控制面板卸载macOS 用 brew uninstall用 nvm 的直接nvm uninstall 版本号。关于墨衍如果你也在多个平台发技术文章值得看看墨衍。三个最常用的权益——发文额度提升密集更新不再受限、批量 GEO 检测一次扫完全部文章的 AI 引用状态、AI 图文同步一稿多平台分发。点这里了解墨衍会员
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。