WSL 2 Ubuntu Node.js yarn 完整安装指南一键安装版前提为什么要安装Ubuntu我今天运行了一个项目启动的时候报错Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol ‘d:’然后试了很多版本都没有解决为了不影响项目进度就安装了Ubuntu系统。 目录安装 WSL 2 和 Ubuntu配置 Ubuntu安装 nvm 和 Node.js 25安装 yarn启动项目常见问题解决1. 安装 WSL 2 和 Ubuntu适用于 Windows 10/11 较新版本版本 2004 及以上步骤 1以管理员身份打开 PowerShell右键点击开始菜单选择Windows PowerShell (管理员)或终端 (管理员)步骤 2执行一键安装命令wsl--install这个命令会自动完成✅ 启用 WSL 功能✅ 启用虚拟机平台✅ 安装 WSL 2 内核✅ 设置 WSL 2 为默认版本✅ 下载并安装 Ubuntu步骤 3重启电脑安装完成后重启电脑使配置生效。步骤 4首次启动 Ubuntu从开始菜单打开Ubuntu应用等待初始化2-5分钟输入用户名全小写如zzz输入密码输入时不显示正常输入后按回车再次输入密码确认成功标志看到用户名电脑名:~$提示符2. 配置 Ubuntu在 Ubuntu 终端中依次执行更新系统sudoaptupdatesudoaptupgrade-y输入密码时屏幕不显示安装必要工具sudoaptinstallcurlwgetgit-y安装 libatomic解决 Node.js 依赖问题sudoaptinstalllibatomic1-y3. 安装 nvm 和 Node.js 25安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash让 nvm 生效source~/.bashrc验证 nvmnvm--version应显示0.39.7或类似版本号安装 Node.js 25.9.0nvminstall25.9.0使用并设为默认nvm use25.9.0 nvmaliasdefault25.9.0验证 Node.jsnode-v应显示v25.9.0npm-v应显示 npm 版本号4. 安装 yarnnpminstall-gyarn验证 yarnyarn-v应显示版本号如1.22.225. 启动项目进入项目目录cd/mnt/d/01git/aiProject/aimarketing/marketing-app配置国内镜像源可选加速下载yarnconfigsetregistry https://registry.npmmirror.com安装项目依赖yarninstall生成数据库连接npmrun db:gen启动开发服务器yarndev访问项目打开 Windows 浏览器访问http://127.0.0.1:5001/6. 常见问题解决❌ 问题 1wsl --install命令找不到原因Windows 版本太旧解决按Win R输入winver查看版本。如果低于 2004请使用分步安装方式❌ 问题 2安装后 Ubuntu 打不开或闪退解决在 PowerShell 中执行wsl--shutdown然后重新打开 Ubuntu❌ 问题 3libatomic.so.1错误解决sudoaptinstalllibatomic1-y❌ 问题 4nvm: command not found解决source~/.bashrc或关闭 Ubuntu 终端重新打开❌ 问题 5yarn install 很慢解决配置国内镜像yarnconfigsetregistry https://registry.npmmirror.com❌ 问题 6权限错误解决sudochmod-R755/mnt/d/01git/aiProject/aimarketing/marketing-app 一键复制全部命令安装完 Ubuntu 并设置好用户名密码后复制以下整段代码在 Ubuntu 终端中右键粘贴按回车# 更新系统并安装必要工具sudoaptupdatesudoaptupgrade-ysudoaptinstallcurlwgetgitlibatomic1-y# 安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bashsource~/.bashrc# 安装 Node.js 25.9.0nvminstall25.9.0 nvm use25.9.0 nvmaliasdefault25.9.0# 安装 yarnnpminstall-gyarn# 验证安装echo 版本验证 nvm--versionnode-vnpm-vyarn-v# 进入项目并启动cd/mnt/d/01git/aiProject/aimarketing/marketing-appyarnconfigsetregistry https://registry.npmmirror.comyarninstallnpmrun db:genyarndev✅ 验证清单完成所有步骤后检查以下各项检查项预期结果Ubuntu 能正常打开✅node -vv25.9.0npm -v显示版本号yarn -v显示版本号yarn dev成功显示http://localhost:5001浏览器访问 5001端口看到项目页面 日常使用每次重启电脑后启动项目的步骤打开 Ubuntu进入项目目录启动项目cd/mnt/d/01git/aiProject/aimarketing/marketing-appyarndev
