You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WSL 2创建React项目报错:UNC路径不支持,求解决方案

解决WSL2创建React项目时UNC路径不支持的问题

问题根源

你遇到的错误是因为在Windows终端环境中直接访问WSL的UNC路径,CMD不支持将这种网络共享路径作为当前工作目录,所以自动切换到了Windows系统目录,导致无法正常调用WSL环境里的node和npm。

修复步骤

1. 用WSL原生终端操作

直接打开Ubuntu(WSL2)终端,或者在Windows Terminal中选择Ubuntu配置文件,切换到你的目标Linux目录:

cd ~/t/learn

然后在这个终端里直接执行React项目创建命令,比如:

npx create-react-app my-react-project

全程在WSL的原生Linux环境下执行,不会触发CMD的UNC路径限制。

2. 避免错误的终端启动方式

不要通过Windows文件资源管理器的地址栏输入cmd/powershell进入WSL路径,这种方式会强制用Windows终端环境加载WSL路径,必然触发UNC错误。

3. 确认node/npm安装在WSL环境

在WSL终端执行以下命令,验证node和npm是否安装在Ubuntu系统中:

node -v
npm -v

能正常输出版本号,说明WSL内的node环境没问题。

4. 关闭WSL自动挂载Windows路径(可选)

如果以上方法无效,关闭WSL对Windows路径的自动挂载,避免路径混淆:

  1. 在WSL终端创建/编辑.wslconfig文件:
echo "[automount]" >> ~/.wslconfig
echo "enabled = false" >> ~/.wslconfig
  1. 重启WSL生效:
wsl --shutdown

重新启动Ubuntu终端后再尝试创建项目。

内容的提问来源于stack exchange,提问作者nisnym

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 04:10:15