Windows下npm/npx运行强制要求WSL的问题咨询

阿华AIGC实验室

2026-6-14

问题描述

在Windows 10系统中执行npm run dev或npx命令时，系统持续要求安装WSL（Windows Subsystem for Linux），但本人无需使用WSL。该问题在Windows更新后出现，具体报错如下：

执行npm run dev时的报错：

C:\{Path}\GitHub\project> npm run dev

> project@0.1.0 dev   
> next dev --turbopack

This application requires the Windows Subsystem for Linux Optional Component.
Install it by running: wsl.exe --install --no-distribution
The system may need to be restarted so the changes can take effect.
Error code: Bash/WSL_E_WSL_OPTIONAL_COMPONENT_REQUIRED

执行npx命令时的报错：

PS C:\Path\to\test> npx create-react-app my_app

This application requires the Windows Subsystem for Linux Optional Component.
Install it by running: wsl.exe --install --no-distribution
The system may need to be restarted so the changes can take effect.
Error code: Bash/WSL_E_WSL_OPTIONAL_COMPONENT_REQUIRED

已尝试的操作：

尝试过Stack Overflow上的相关修复方案
卸载了Docker（怀疑其强制依赖WSL）
确认Node.js运行在Windows环境（npm已验证为Windows版本）
在PowerShell和CMD中均尝试运行，结果一致
完全卸载并重新安装了Node.js与npm

系统信息：

操作系统：Windows 10
Node.js版本：22.14.0
npm版本：10.9.2

疑问解答

1. 为何Windows环境下的npm会要求安装WSL？

可能的触发原因包括：

Windows更新后，npm的默认Shell被错误配置为WSL的bash路径，导致命令执行时触发WSL依赖检查
系统环境变量被修改，WSL相关路径优先级高于Windows原生Node.js路径，命令调用了WSL环境的执行逻辑
部分工具（如Turbopack）的版本存在环境判断bug，误将Windows环境识别为需要WSL支持
Windows系统可选组件配置异常，导致Node.js执行时错误触发WSL组件检查

2. 是否可以强制npm在Windows原生环境运行，无需WSL？

可以，通过调整配置、修复系统环境即可实现，具体方案见下文。

解决方案

1. 检查并修改npm默认Shell

执行命令查看当前npm使用的Shell：
```
npm config get shell
```
如果返回结果为WSL相关路径（如/bin/bash或包含wsl的路径），将其修改为Windows原生Shell：
- 改为CMD：
```
npm config set shell "C:\\Windows\\System32\\cmd.exe"
```
- 改为PowerShell：
```
npm config set shell "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"
```