news 2026/5/14 2:39:53

npm 安装/运行报错及解决方案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
npm 安装/运行报错及解决方案

1. 问题现象

在 Windows PowerShell 中执行以下命令:

npm-v

出现如下报错:

npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1,因为在此系统上禁止运行脚本。 有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。 所在位置 行:1 字符: 1 + npm -v + ~~~ + CategoryInfo : SecurityError: (:) [],PSSecurityException + FullyQualifiedErrorId : UnauthorizedAccess

2. 问题原因

该问题不是 Node.js 或 npm 安装失败,也不是 npm 命令不存在。

真正原因是:PowerShell 的执行策略禁止运行脚本文件

Windows 中安装 Node.js 后,npm 会提供多个可执行入口,其中包括:

C:\Program Files\nodejs\npm.ps1

当在 PowerShell 中执行npm命令时,PowerShell 可能优先调用npm.ps1脚本文件。但当前系统策略禁止运行.ps1脚本,因此触发安全错误。

3. 解决方案一:修改当前用户的 PowerShell 执行策略(推荐)

在 PowerShell 中执行:

Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned

如果系统提示确认,输入:

Y

然后重新打开 PowerShell 或 VS Code 终端,再执行:

npm-v

如果能正常显示 npm 版本号,说明问题已解决。

说明

RemoteSigned表示:

  • 本地创建的 PowerShell 脚本可以运行;
  • 从网络下载的脚本需要有可信签名才能运行;
  • CurrentUser只影响当前 Windows 用户,不需要修改整个系统策略。

该方式适合日常开发环境使用。

4. 解决方案二:临时绕过 PowerShell 脚本限制

如果不想修改 PowerShell 执行策略,可以直接调用 npm 的.cmd文件:

npm.cmd-v

或者通过 cmd 执行:

cmd/c npm-v

如果需要安装依赖,也可以使用:

npm.cmd install

或者:

cmd/c npm install

该方式不会修改 PowerShell 执行策略,适合临时验证或受限电脑环境。

5. 解决方案三:查看当前执行策略

如果需要确认当前 PowerShell 策略,可以执行:

Get-ExecutionPolicy-List

重点查看CurrentUserLocalMachine对应的策略。

常见策略说明:

策略含义
Restricted禁止运行 PowerShell 脚本,容易导致 npm.ps1 无法执行
RemoteSigned允许运行本地脚本,网络下载脚本需要签名,推荐开发环境使用
Unrestricted允许运行大多数脚本,安全性较低,不推荐随意设置
Bypass不阻止任何脚本,通常只适合临时场景

6. 验证方法

执行以下命令:

node-v npm-v

如果分别输出类似下面的版本号,则说明 Node.js 和 npm 都可以正常使用:

v20.x.x 10.x.x

也可以进一步验证 npm 是否能正常安装依赖:

npm install

7. VS Code 中的处理方式

如果是在 VS Code 终端中出现该问题:

  1. 打开 PowerShell;
  2. 执行:
Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned
  1. 输入Y确认;
  2. 关闭 VS Code 当前终端;
  3. 新建一个终端;
  4. 重新执行:
npm-v

8. 常见误区

误区一:以为 npm 没有安装成功

该报错并不代表 npm 没装好。报错中已经出现了:

C:\Program Files\nodejs\npm.ps1

说明系统已经找到了 npm 相关文件,只是 PowerShell 不允许执行该脚本。

误区二:反复重装 Node.js

通常不需要重新安装 Node.js。只要修改 PowerShell 执行策略,或使用npm.cmd,即可解决问题。

误区三:必须使用管理员权限

使用以下命令时通常不需要管理员权限:

Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned

因为它只修改当前用户的执行策略。

9. 推荐处理流程

优先推荐使用以下步骤:

Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned

确认后重新打开终端,再执行:

npm-v

如果公司电脑或学校电脑不允许修改策略,则使用临时方案:

npm.cmd-v

或:

cmd/c npm-v

10. 总结

本次报错的核心原因是:PowerShell 禁止运行 npm.ps1 脚本

推荐解决方式是将当前用户的执行策略设置为:

RemoteSigned

对应命令为:

Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned

修改后重新打开终端,再运行npm -v即可验证是否修复。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/14 2:34:04

基于梯度权值追踪的无监督域自适应优化研究

SummaryArticleObjectiveMethodComments基于梯度权值追踪的域自适应分类研究解决无监督领域自适应方法中存在的过拟合问题文章采用了基于梯度权值追踪的剪枝与优化算法来解决过拟合问题。该算法首先对样本进行训练,识别出重要的连接,并用权值的绝对值来量…

作者头像 李华
网站建设 2026/5/14 2:31:12

降AI率软件价格透明度测评:嘎嘎降明码4.8vs分项收费翻倍!

降AI率软件价格透明度测评:嘎嘎降明码4.8vs分项收费翻倍! 「1.6 元/千字」进门,结账 188 元 本科毕业论文 3 万字(双学位,比一般本科长),预算紧张,想找单价最低的工具。进门看到「…

作者头像 李华
网站建设 2026/5/14 2:30:04

半导体行业转型:从工程驱动到客户价值驱动的五大能力重塑

1. 从“造芯”到“懂你”:半导体行业成功逻辑的深度重构干了十几年硬件,从画板子到调驱动,再到参与芯片定义,我亲眼看着这个行业的游戏规则在十年间发生了翻天覆地的变化。十年前,我们这帮工程师聚在一起,聊…

作者头像 李华
网站建设 2026/5/14 2:25:06

电磁旁路攻击:从原理到实战,如何守护射频密钥系统安全

1. 项目概述:当你的车钥匙在“广播”你的秘密几年前,我在一个安全会议上第一次听说“旁路攻击”这个词,当时觉得这离我们普通工程师的日常开发太遥远了,更像是电影里的情节。直到我亲眼看到一段演示:研究员用一台改装过…

作者头像 李华
网站建设 2026/5/14 2:20:07

基于MCP协议的金融数据服务器:为AI量化分析提供标准化数据接口

1. 项目概述:一个为金融量化分析而生的MCP服务器如果你和我一样,在金融数据分析和量化策略开发的路上摸爬滚打过几年,那你一定对“数据获取”这个老大难问题深有体会。无论是想回测一个简单的双均线策略,还是构建一个复杂的多因子…

作者头像 李华
网站建设 2026/5/14 2:20:06

通过Taotoken为OpenClaw配置自定义模型供应商的详细步骤

🚀 告别海外账号与网络限制!稳定直连全球优质大模型,限时半价接入中。 👉 点击领取海量免费额度 通过Taotoken为OpenClaw配置自定义模型供应商的详细步骤 OpenClaw是一个流行的AI智能体开发框架,它允许开发者灵活地配…

作者头像 李华