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路径的自动挂载,避免路径混淆:
- 在WSL终端创建/编辑
.wslconfig文件:
echo "[automount]" >> ~/.wslconfig echo "enabled = false" >> ~/.wslconfig
- 重启WSL生效:
wsl --shutdown
重新启动Ubuntu终端后再尝试创建项目。
内容的提问来源于stack exchange,提问作者nisnym
相关产品推荐
相关产品推荐

