Windows PowerShell 中全局 npm 包执行受限问题及解决方案

在 Windows 系统上进行 Node.js 开发时，开发者经常会遇到一个常见问题：全局安装的 npm 包无法在 PowerShell 中正常执行。这个问题不仅影响 pnpm，还包括其他全局安装的 npm 包。本文将深入探讨这个问题的原因，并提供多种解决方案。

问题描述

当尝试在 PowerShell 中运行全局安装的 npm 包（如 pnpm、vue-cli、create-react-app 等）时，可能会遇到类似以下的错误：

<包名> : 无法加载文件 C:\Users\<用户名>\AppData\Roaming\npm\<包名>.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

原因分析

这个问题的根源在于 Windows PowerShell 的执行策略。默认情况下，PowerShell 的执行策略设置为 “Restricted”，这意味着它不允许运行任何脚本，包括全局安装的 npm 包生成的 .ps1 脚本文件。

解决方案

1. 修改 PowerShell 执行策略

这是最直接的解决方法，但需要谨慎操作，因为它会影响系统安全性。

1. 以管理员身份打开 PowerShell。
2. 运行以下命令查看当前策略：

Get-ExecutionPolicy

3. 如果显示 “Restricted”，可以将其更改为允许运行本地脚本：

Set-ExecutionPolicy RemoteSigned

4. 确认更改后，全局 npm 包应该可以正常运行了。

2. 使用 cmd 而不是 PowerShell

cmd 不受 PowerShell 执行策略的影响，因此在 cmd 中运行全局 npm 包通常不会遇到这个问题。

3. 使用 npx

对于一些工具，可以使用 npx 来运行，而不需要全局安装。例如：

npx create-react-app my-app

4. 在 package.json 中添加脚本

对于项目特定的工具，可以将它们作为开发依赖安装，并在 package.json 的 scripts 部分添加命令。

5. 使用完整路径运行脚本

可以尝试使用 node 直接运行 .js 文件，而不是 .ps1 文件：

node C:\Users\<用户名>\AppData\Roaming\npm\node_modules\<包名>\bin\<包名>.js

预防措施

1. 在全局安装 npm 包之前，考虑是否真的需要全局安装。
2. 使用 nvm (Node Version Manager) 来管理 Node.js 版本，它可以帮助避免一些权限问题。
3. 考虑使用 WSL (Windows Subsystem for Linux) 进行开发，可以避免 Windows 特有的一些问题。

结论

PowerShell 执行策略虽然可能会给 Node.js 开发带来一些不便，但它是 Windows 系统重要的安全特性。通过理解问题的本质和采取适当的解决方案，我们可以在保证系统安全的同时，充分利用 npm 生态系统中丰富的工具和包。

希望本文能帮助您解决在 Windows PowerShell 中运行全局 npm 包的问题，并为您的 Node.js 开发提供一些有价值的建议。记住，在修改系统设置时要谨慎，始终优先考虑安全性。