冠军资讯
程序员老猫在使用 npm 进行项目构建、依赖管理时，我们经常会遇到“npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。”这样的错误提示。这表明 PowerShell 脚本的执行策略阻止了 npm 相关脚本的运行。这个问题在国内的 Windows 开发环境中非常常见，尤其是对于一些新安装 Node.js 的用户来说。下面我们将深入分析这个问题，并提供详细的解决方案。
问题场景重现
假设你已经安装了 Node.js 和 npm，但在尝试运行 npm 命令，例如 npm install 或者执行 package.json 中定义的脚本时，就会出现类似下面的错误：
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。
有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
+ CategoryInfo : SecurityError: (:) []，PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
这个错误表明 PowerShell 的执行策略限制了脚本的运行。默认情况下，Windows 系统可能会阻止执行未签名的 PowerShell 脚本，这包括了 npm 使用的一些内部脚本。
底层原理深度剖析
PowerShell 的执行策略是一种安全机制，用于控制 PowerShell 脚本的执行行为。它主要通过注册表进行配置，并影响 PowerShell 会话中的脚本执行。
执行策略主要有以下几种类型：
- Restricted: 禁止所有脚本运行。
- AllSigned: 只允许运行签名过的脚本。
- RemoteSigned: 允许运行本地编写的脚本，但从互联网下载的脚本必须签名。
- Unrestricted: 允许运行所有脚本。
npm.ps1 是 npm 使用的一个 PowerShell 脚本，用于处理一些内部操作。当执行策略设置为 Restricted 或 RemoteSigned，且该脚本没有签名时，就会导致执行失败。
同时，这个问题也可能与环境变量配置有关。如果 Node.js 的安装路径没有正确添加到系统的 Path 环境变量中，也可能导致 npm 命令无法正确执行。在国内复杂的网络环境下，如果 npm 源配置不当（例如，仍然使用默认的 npm 官方源），在执行 npm install 时，因为网络不稳定，更容易出现各种错误，包括脚本执行问题。
解决方案：修改 PowerShell 执行策略
解决这个问题的最常见方法是修改 PowerShell 的执行策略。注意：修改执行策略可能会降低系统的安全性，请谨慎操作。
以管理员身份运行 PowerShell。
查看当前的执行策略：
Get-ExecutionPolicy如果输出为
Restricted，则需要修改执行策略。修改执行策略为
RemoteSigned：Set-ExecutionPolicy RemoteSigned在执行这个命令时，系统会提示你确认是否要修改执行策略。输入
Y并按回车键确认。
再次查看执行策略，确认是否修改成功：
Get-ExecutionPolicy输出应为
RemoteSigned。如果
RemoteSigned不起作用，可以尝试Unrestricted，但请务必评估潜在的安全风险：Set-ExecutionPolicy Unrestricted同样，输入
Y确认修改。
可选方案：绕过执行策略执行特定脚本
如果不想修改全局的执行策略，可以尝试绕过执行策略来执行特定的 npm 命令。这可以通过在命令前添加 powershell -NoProfile -ExecutionPolicy Bypass -Command 来实现。
例如：
powershell -NoProfile -ExecutionPolicy Bypass -Command "npm install"
这种方式只对当前命令生效，不会影响全局的执行策略。
实战避坑经验总结
使用国内镜像源： 由于国内网络环境的特殊性，建议使用国内的 npm 镜像源，例如淘宝 npm 镜像（cnpm）。这可以提高 npm 包的下载速度，减少因网络问题导致的错误。
npm config set registry https://registry.npmmirror.com ```
检查 Node.js 和 npm 的版本： 确保你使用的 Node.js 和 npm 版本是最新的稳定版本。过时的版本可能存在一些已知的 bug，导致各种问题。
node -v
npm -v ```
如果版本过旧，可以使用 npm 更新 npm 本身：
```powershell
npm install -g npm
```
也可以使用 nvm (Node Version Manager) 来管理多个 Node.js 版本，方便切换和更新。
检查环境变量配置： 确保 Node.js 的安装目录已经添加到系统的
Path环境变量中。这样才能在任何目录下直接运行 npm 命令。以管理员身份运行命令提示符或 PowerShell： 有些 npm 命令需要管理员权限才能正确执行，例如全局安装某些包。
检查 npm 缓存： 有时候 npm 缓存可能损坏，导致安装失败。可以尝试清除 npm 缓存：
npm cache clean --force ```
- 升级Node.js: 有时问题可能出在Node.js本身。尝试升级到最新稳定版，或许能解决一些底层兼容性问题。
解决“npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。”这个问题，需要综合考虑 PowerShell 执行策略、npm 源配置、Node.js 和 npm 版本、环境变量配置等多个方面。通过本文提供的解决方案和实战经验，相信你能够轻松解决这个问题，提升开发效率。
