Win11 安装 Node.js 后 npm install 报错提示禁止运行脚本的解决方法 | 极客日志

JavaScriptNode.js大前端

Win11 安装 Node.js 后 npm install 报错提示禁止运行脚本的解决方法

综述由AI生成解决了在 Windows 11 系统安装最新版 Node.js 后执行 npm install 时报错“在此系统上禁止运行脚本”的问题。主要原因是 PowerShell 执行策略限制。提供了四种解决方案，推荐使用管理员身份运行 PowerShell 并设置 RemoteSigned 策略。此外，文章还简要介绍了 Node.js 的核心特点、架构组成、安装验证及基本用法，帮助开发者快速排查环境配置问题并回顾基础知识。

时间旅人发布于 2026/4/5更新于 2026/5/2425 浏览

Win11 安装 Node.js 后 npm install 报错提示禁止运行脚本的解决方法

在这里插入图片描述

前言

在安装完成 Node.js 后未重启电脑的情况下直接运行 npm install 安装依赖时，可能会遇到报错提示。

解决方案

这个错误是因为 PowerShell 的执行策略限制导致的。以下是几种解决方法：

方法 1：以管理员身份运行 PowerShell 并更改执行策略

以管理员身份打开 PowerShell
- 在开始菜单搜索 'PowerShell'
- 右键点击 'Windows PowerShell'，选择 '以管理员身份运行'
执行以下命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

或者更宽松的策略：

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser

运行后就不会报错了，显示依赖包正在下载中，npm install，会根据配置文件下载对应的依赖，自动创建文件夹 node_modules 保存对应的依赖包。

在这里插入图片描述

方法 2：只为当前会话临时允许

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

方法 3：使用命令提示符 (CMD)

暂时使用 CMD 代替 PowerShell：

相关免费在线工具

Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online
Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online
JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online
JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online
Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

npm install 你的包名

powershell -ExecutionPolicy Bypass -File "C:\Program Files\nodejs\npm.ps1"

// 非阻塞代码示例
const fs = require('fs');
// 非阻塞方式读取文件
fs.readFile('file.txt', 'utf8', (err, data) => {
  if (err) throw err;
  console.log(data);
});
console.log('程序继续执行，不会等待文件读取完成');

const http = require('http'); // HTTP 服务器
const fs = require('fs'); // 文件系统
const path = require('path'); // 路径处理
const events = require('events'); // 事件处理

# 下载安装包从官网
# 或使用包管理器
# Windows Chocolatey choco install nodejs
# macOS Homebrew brew install node

node --version # 查看 Node.js 版本
npm --version # 查看包管理器版本

const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/html'});
  res.end('<h1>Hello Node.js!</h1>');
});
server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

const fs = require('fs').promises;
async function readFile() {
  try {
    const data = await fs.readFile('example.txt', 'utf8');
    console.log(data);
  } catch (error) {
    console.error('读取文件出错:', error);
  }
}

// math.js
exports.add = (a, b) => a + b;
exports.multiply = (a, b) => a * b;

// app.js
const math = require('./math');
console.log(math.add(2, 3)); // 5

npm init # 初始化项目
npm install express # 安装包
npm install -g nodemon # 全局安装
npm update # 更新包
npm run start # 运行脚本

{
  "name": "my-app",
  "version": "1.0.0",
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js"
  },
  "dependencies": {
    "express": "^4.18.0"
  }
}

Win11 安装 Node.js 后 npm install 报错提示禁止运行脚本的解决方法

前言

解决方案

方法 1：以管理员身份运行 PowerShell 并更改执行策略

方法 2：只为当前会话临时允许

方法 3：使用命令提示符 (CMD)

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

方法 4：绕过策略执行单个脚本

推荐解决方案

Node.js 详细介绍

什么是 Node.js？

核心特点

1. 非阻塞 I/O 和事件驱动

2. 单线程但高并发

架构组成

1. V8 JavaScript 引擎

2. LibUV 库

3. 核心模块

安装与使用

安装

验证安装

基本用法示例

1. 创建 HTTP 服务器

2. 文件操作

3. 模块系统

包管理 - npm

常用命令

package.json 示例

应用场景

适合的场景

不适合的场景

生态系统

流行框架和库

开发工具

优势与劣势

优势 ✅

劣势 ❌

学习路径建议

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具