在windows上使用wsl安装Ubuntu~linux系统

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系统。

📋 目录

1. [安装 WSL 2 和 Ubuntu](#安装 WSL 2 和 Ubuntu)
2. [配置 Ubuntu](#配置 Ubuntu)
3. [安装 nvm 和 Node.js 25](#安装 nvm 和 Node.js 25)
4. [安装 yarn](#安装 yarn)
5. 启动项目
6. 常见问题解决

1. 安装 WSL 2 和 Ubuntu

适用于 Windows 10/11 较新版本（版本 2004 及以上）

步骤 1：以管理员身份打开 PowerShell

• 右键点击开始菜单
• 选择 Windows PowerShell (管理员) 或 终端 (管理员)

步骤 2：执行一键安装命令

wsl --install

这个命令会自动完成：

• ✅ 启用 WSL 功能
• ✅ 启用虚拟机平台
• ✅ 安装 WSL 2 内核
• ✅ 设置 WSL 2 为默认版本
• ✅ 下载并安装 Ubuntu

步骤 3：重启电脑

安装完成后，重启电脑使配置生效。

步骤 4：首次启动 Ubuntu

1. 从开始菜单打开 Ubuntu 应用
2. 等待初始化（2-5分钟）
3. 输入用户名（全小写，如 zzz）
4. 输入密码（输入时不显示，正常输入后按回车）
5. 再次输入密码确认
   成功标志： 看到 用户名@电脑名:~$ 提示符

2. 配置 Ubuntu

在 Ubuntu 终端中依次执行：

更新系统

sudo apt update && sudo apt upgrade -y

（输入密码时屏幕不显示）

安装必要工具

sudo apt install curl wget git -y

安装 libatomic（解决 Node.js 依赖问题）

sudo apt install libatomic1 -y

3. 安装 nvm 和 Node.js 25

安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

让 nvm 生效

source ~/.bashrc

验证 nvm

nvm --version

（应显示 0.39.7 或类似版本号）

安装 Node.js 25.9.0

nvm install 25.9.0

使用并设为默认

nvm use 25.9.0
nvm alias default 25.9.0

验证 Node.js

node -v

（应显示 v25.9.0）

npm -v

（应显示 npm 版本号）

4. 安装 yarn

npm install -g yarn

验证 yarn

yarn -v

（应显示版本号，如 1.22.22）

5. 启动项目

进入项目目录

cd /mnt/d/01git/aiProject/aimarketing/marketing-app

配置国内镜像源（可选，加速下载）

yarn config set registry https://registry.npmmirror.com

安装项目依赖

yarn install

生成数据库连接

npm run db:gen

启动开发服务器

yarn dev

访问项目

打开 Windows 浏览器，访问 http://127.0.0.1:5001/

6. 常见问题解决

❌ 问题 1：wsl --install 命令找不到

原因： Windows 版本太旧

解决： 按 Win + R，输入 winver 查看版本。如果低于 2004，请使用分步安装方式

❌ 问题 2：安装后 Ubuntu 打不开或闪退

解决： 在 PowerShell 中执行

wsl --shutdown

然后重新打开 Ubuntu

❌ 问题 3：libatomic.so.1 错误

解决：

sudo apt install libatomic1 -y

❌ 问题 4：nvm: command not found

解决：

source ~/.bashrc

或关闭 Ubuntu 终端重新打开

❌ 问题 5：yarn install 很慢

解决： 配置国内镜像

yarn config set registry https://registry.npmmirror.com

❌ 问题 6：权限错误

解决：

sudo chmod -R 755 /mnt/d/01git/aiProject/aimarketing/marketing-app

📝 一键复制全部命令

安装完 Ubuntu 并设置好用户名密码后，复制以下整段代码 ，在 Ubuntu 终端中右键粘贴，按回车：

# 更新系统并安装必要工具
sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git libatomic1 -y

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 25.9.0
nvm install 25.9.0
nvm use 25.9.0
nvm alias default 25.9.0

# 安装 yarn
npm install -g yarn

# 验证安装
echo "=== 版本验证 ==="
nvm --version
node -v
npm -v
yarn -v

# 进入项目并启动
cd /mnt/d/01git/aiProject/aimarketing/marketing-app
yarn config set registry https://registry.npmmirror.com
yarn install
npm run db:gen
yarn dev

✅ 验证清单

完成所有步骤后，检查以下各项：

检查项	预期结果
Ubuntu 能正常打开	✅
node -v	v25.9.0
npm -v	显示版本号
yarn -v	显示版本号
yarn dev 成功	显示 http://localhost:5001
浏览器访问 5001端口	看到项目页面

💡 日常使用

每次重启电脑后，启动项目的步骤：

1. 打开 Ubuntu
2. 进入项目目录
3. 启动项目

cd /mnt/d/01git/aiProject/aimarketing/marketing-app
yarn dev