ChangeSUS今天下午有个前同事发来截图，Node.js刚从官网下载完、双击安装、一路Next，结果在PowerShell里敲npm -v，直接弹出一行红字：“npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本”。他问我要不要重装系统。我说，你先别慌，这不是你电脑坏了，是npm和node的安装与配置里最常见的两个坑之一，另一个就是“npm不是内部或外部命令”。
很多教程把安装Node.js写成“下载-双击-下一步-完成”，然后把锅甩给“环境变量没配好”就结束了。但真正让人头疼的从来不是安装过程，而是装完之后一连串环境变量、PowerShell执行策略、多版本冲突、镜像源和奇怪报错。这篇文章我就按实际踩坑顺序，把从零配置到日常使用的完整链路捋一遍。适合刚入门的前端、刚转向Node后端，以及在公司新电脑上第一次配环境的人。
1. 先搞清楚“Node装好了但npm用不了”这句话到底错在哪
1.1 你装的从来不是“一个node”，而是三个组件
很多人以为从官网下载的Node.js安装包装完只是个“编译器”之类的东西，其实装上的是一个运行时加一堆工具的组合体。Windows下典型的安装目录里包含这几类东西：
- node.exe：真正的JavaScript运行时，底层是V8引擎加libuv事件循环库。你在命令行里敲
node命令，跑的就是它。 - npm：一套用Node.js写的包管理CLI，它的真实代码存放在安装目录下的
node_modules\npm里，入口脚本在Windows下是npm.cmd（给CMD用）和npm.ps1（给PowerShell用）。 - npx：附带的一个工具，用来执行项目
node_modules/.bin目录里的命令。 - corepack：用来管理pnpm、yarn等包管理器版本的工具（新版本自带）。
所以“安装npm”并不是一个独立操作，而是Node.js安装包自带的一部分。官方.msi安装包默认都带这些，你根本不用单独再装一遍npm。
但这里有一个冷门但真实的现象：如果你从网上某个“绿色版”“精简版”压缩包解压的Node，解压完目录里只有一个node.exe，没有npm.cmd，也没有node_modules\npm。这种环境下node -v能正常输出版本号，但npm -v一定会报“不是内部或外部命令”。所以遇到“node能跑、npm不能跑”的时候，先别急着怀疑环境变量，先看一眼安装目录里到底有没有npm.cmd这个文件。
1.2 PATH环境变量的作用链：为什么命令行找不到npm
Windows系统在你输入命令时，并不是全局搜索整个硬盘，而是按照环境变量Path里的目录列表，一个一个目录去找同名可执行文件。你输入node，系统按顺序找node.exe；输入npm，系统找的是npm.cmd或npm.exe。
安装Node.js时向导里有一项“Add to PATH”，如果这个选项被勾选，安装程序会把node安装目录（比如C:\Program Files\nodejs\）写进当前用户的Path变量里。如果你没勾选、或者用的是zip包手动解压，那么系统根本不知道该去哪里找你刚装好的node和npm。
手动添加的方式也很简单：在“系统属性-环境变量”里找到用户变量中的Path，点击编辑，新增一行node所在目录。这里有一个大多数人都会踩的细节：改完环境变量后，必须把所有已经打开的终端窗口全部关掉，再重新打开一个。因为终端进程在启动的时候只会读取一次环境变量，启动之后不会自动刷新。你改了配置却还在旧终端里敲命令，当然还是提示找不到。
还有个很容易被忽略的点：PATH里有两个目录和npm相关。一个是node安装目录，负责node命令；另一个是npm全局包目录，默认在C:\Users\你的用户名\AppData\Roaming\npm，负责npm install -g xxx之后生成的全局命令（比如后面要讲的codex）。“npm不是内部或外部命令”通常和第一个目录有关，“全局命令找不到”通常和第二个目录有关。这两件事混在一起排查，最容易绕晕。
1.3 用三条命令验证安装状态，而不是瞎猜
环境出问题时，我一般不靠猜，直接三条命令定位：
bash复制node -v
npm -v
where node
where npm
where命令非常关键，它会把系统在PATH里能找到的所有同名文件列出来。正常情况下会显示类似这样的结果：
text复制C:\Program Files\nodejs\node.exe