我看现在很多本地 AI 教程工具安装的教程满天飞每个细节也非常到位但是都忽略了真正的小白的痛点那就是Node环境。基本上所有的AI相关的工具都是基于Node.js环境去做安装和扩展的如果不把地基打牢后面很多skills、MCP、CLI 工具连跑起来的资格都没有。这也是我为什么把这篇叫“第 0 步”的原因。你如果连node -v都还没正常出来后面再去折腾各种工具基本就是一边装一边猜最后连自己到底是卡在工具还是卡在本地环境都傻傻的分不清。知识提要我查的是 2026 年 4 月 10 日的官方资料nodejs.org现在最新的LTS版本是v24.14.1。这篇我不准备讲 Node 原理也不讲 AI 工具或者其他的MCP或者Skills我只讲Node环境的安装和高级玩法nvm的安装教程。先别装先看你电脑现在是什么状态我不建议你上来就复制安装命令。其实最怕的不是小白“不会装”而是你没有了解过你的电脑环境比如有的人电脑明明以前装过但是不知道电脑系统里还残着旧版Node、旧 PATH、旧全局包如果你当全新的电脑环境去安装就会出大问题了。先来一轮电脑摸底。macOS / Linux 先跑node -v npm -v command -v node command -v npmWindows 先跑node -v npm -v where node where npm如果运行命令的时候这里已经报command not found或者where node指向一堆你根本不认识的目录那其实是好事。至少问题说明两个问题电脑是纯净没安装过的或者告诉你电脑已经安装告诉你安装的位置。注意npm通常会跟着Node.js一起装不用单独先装一遍。后面还是推荐使用nvm来做node的版本管理工具 。我为什么更建议先走 nvm 这条路官方的npm文档其实也写的很清楚更推荐你用版本管理器来装Node.js和npm而不是直接装系统级安装包。原因也很现实版本管理器更容易做到全局权限、版本切换、全局包冲突等基本上可以把一些常见问题给避免掉如果你是前端工程师你就知道我所说非虚。如果把这件事放到本地 AI 上就更加明显了。你今天装一个 CLI 可能没事明天换另一个工具要求的 Node 版本不一样或者你要同时保留LTS和更新版本这时候没有nvm很快你就会发现自己的电脑一堆node的版本根本不知道使用的是哪个node版本跟别说相关的依赖和包管理了。我自己的建议是这样macOS和Linux优先装nvmWindows优先装nvm-windows只有你特别确定自己就要一套固定版本而且不准备折腾版本切换才考虑直接用官网安装包延伸阅读你如果后面是准备装具体 AI CLI可以接着看这篇别再切屏问 AI 了把 Claude、Gemini、Codex 塞进命令行的保姆级教程与避坑指南。macOS 和 Linux先把 nvm 装上再装 Node这里我建议直接按nvm-sh/nvm官方仓库来。很多第三方的教程虽然把命令都没有问题但是后面的验证和坑点却没有讲清楚。先跑安装脚本curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash如果你机器上没有curl也可以用wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash这个脚本做的事其实也不复杂就是把nvm装到你用户目录下然后尝试把加载配置写进~/.zshrc、~/.bashrc、~/.bash_profile或~/.profile。装完以后先别急着使用。这里很多人最容易手快装完就直接敲下一条结果后面一看nvm: command not found又以为刚才安装脚本没跑成。zsh 用户source ~/.zshrcbash 用户source ~/.bashrc然后验证nvm有没有真的生效command -v nvm这里正常的话终端会输出nvm。如果你习惯用which nvm这里很容易把自己绕进去因为官方 README 也专门提醒了nvm是 shell function不是普通可执行文件所以which nvm不一定靠谱。接着装LTS版本的 Nodenvm install --lts nvm use --lts再检查版本node -v npm -v你如果后面想把当前LTS设成默认版本可以再补一条nvm alias default lts/*这一步做完新的 shell 默认就会先吃你设置好的LTS版本。注意你如果是Linux服务器、远程 VPS、WSL 这类环境走nvm往往比直接装系统包更省事。尤其是你后面还要切版本、回滚版本的时候差别就会更加非常明显了。Windows别混着装优先走 nvm-windowsWindows 这边别照搬macOS/Linux的nvm因为不是同一套东西。官方nvm仓库自己也写了它主要是给 POSIX shell 用的Windows 一般要安装的版本是coreybutler/nvm-windows。这一步千万别混混了以后排错会很烦。Windows 这里我会先看旧版 Node 有没有清干净尤其是%ProgramFiles%\\nodejs这种目录还在不在。nvm-windows官方 README 反复提的一类坑就是旧 Node 还挂在 PATH 里结果你跑了nvm use表面没报错版本却根本没切过去。安装步骤去nvm-windows官方 release 下载nvm-setup.exe安装完成后重开PowerShell或CMD先跑nvm version看工具在不在再安装LTS关键命令nvm version nvm install lts nvm use lts node -v npm -v检查 PATH 有没有冲突可以跑nvm debug这个命令对 Windows 新手很有用。Windows 最大的问题不是命令不会敲而是旧 Node 还在你的店里面活着新的nvm又没完全安装成功最后看着都装好了终端里面生效的还是旧路径。风险提示nvm-windows官方文档提到执行nvm install和nvm use时Windows 往往需要管理员权限来处理 symlink。你如果发现命令没报错但版本就是没切过去先别怀疑工具坏了先看是不是管理员 shell。如果你就是不想折腾 nvm还有一条更省脑的路那就是直接走 Node 官网安装包。这一条适合两类人你就一台本机短期内只想跑起来你不准备切多个版本macOS和Windows可以直接去 Node 官网下载LTS安装包npm会一起装进去。Linux 这边npm文档更推荐用 NodeSource 这类路线不建议自己东拼西凑。比如 Debian / Ubuntu 系常见做法就是curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - sudo apt-get install -y nodejs但这里我还是多说一句你如果是为了本地 AI 环境打底我还是更偏向nvm。后面真遇到版本兼容问题这条路回头更轻。装完别急着关终端先做这几步验证很多人教程抄到这里就停了我不建议。因为“装完”和“能用”中间还差一层验证。我一般至少做这 4 步。看 Node 版本node -v看 npm 版本npm -v看当前命令到底指向哪里macOS / Linuxcommand -v node command -v npmWindowswhere node where npm跑一个最小安装动作npm install -g npmlatest这条命令不一定是必须升级而是顺手验证一下全局安装、网络、权限、PATH 这一串是不是通的。你如果这里直接报权限问题后面很多 CLI 也大概率会在全局安装时一起报。你也可以再补一个最小执行验证node -e console.log(process.version)能正常打印版本说明 Node 本体已经能跑。这几个坑最常见而且都很像“装好了”1. 终端里还是command not found这个最常见。尤其是刚装完nvm但你没重开终端也没刷新配置文件配置source ~/.zshrc/source ~/.bashrc。我自己总结的经验就是看到这种报错第一反应都不是重装而是先看 shell 配置到底有没有刷新进配置系统有没有生效。先查当前 shell 是不是新开的shell 配置文件里有没有正确加载nvm你是不是把配置写进了错误的 profile2. Windows 明明切版本了node -v还是旧版本这类问题优先怀疑旧版 Node 没卸干净或者%ProgramFiles%\\nodejs还占着原来的路径。先查where nodenvm debug原来的 Node 安装目录是不是还在3.nvm看起来装了但which nvm没结果这不一定是坏了。nvm官方自己就写了验证应该用command -v nvm不要把which nvm当唯一判断标准。4.npm install -g报权限错误这类问题在直接装系统级 Node 时更常见。npm官方不太推荐直接走 installer一部分原因就是它更容易把全局权限问题一起带出来。你如果已经踩到了macOS/Linux优先改走nvm不要第一反应就全局sudo npm install -g ...后者短期能过后面经常会把权限和缓存搞得更乱。5. IDE 里一个版本终端里另一个版本这也很烦。尤其是你装完以后VS Code 终端、系统终端、远程终端各自不一样。很多人会在这里误判成“这个 AI 工具有问题”其实环境先没对齐。先别急着怪 AI 工具不稳定先在你真正要使用它的那个终端里跑node -v npm -v你最终要相信的是“当前执行环境里跑出来的版本”不是你印象里装过什么。我现在的建议很简单你如果只是想把本地 AI 跑起来不需要一上来就研究十个工具的安装细节。先把Node.js这个地基打牢固后面你在玩AI相关的基础设施很多事情都会顺利很多。主路线macOS/Linux先装nvm再装LTSWindows先装nvm-windows再装LTS装完以后先跑版本检查再做一次最小安装和执行验证备选路线就是直接走官网安装包。但是你如果深度是使用和折腾AI相关的内容skills、MCP、AI CLI那我还是建议你直接一步到位直接安装nvm。可能你现在省的是 10 分钟后面就是依赖版本火葬场了到时候花费的时间就不止10分钟了。官方资料Node.js 下载页https://nodejs.org/en/downloadnpm 安装说明https://docs.npmjs.com/downloading-and-installing-node-js-and-npmnvm 官方仓库https://github.com/nvm-sh/nvmnvm-windows 官方仓库https://github.com/coreybutler/nvm-windowsnvm-windows 安装 Wiki玩转本地 AI 的“第 0 步”Node.js 环境保姆级安装教程