企业官网建设流程全解析

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
2. 配置 Ubuntu
3. 安装 nvm 和 Node.js 25
4. 安装 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 终端中依次执行：

更新系统

sudoaptupdate&&sudoaptupgrade-y

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

安装必要工具

sudoaptinstallcurlwgetgit-y

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

sudoaptinstalllibatomic1-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

nvminstall25.9.0

使用并设为默认

nvm use25.9.0 nvmaliasdefault25.9.0

验证 Node.js

node-v

（应显示v25.9.0）

npm-v

（应显示 npm 版本号）

4. 安装 yarn

npminstall-gyarn

验证 yarn

yarn-v

（应显示版本号，如1.22.22）

5. 启动项目

进入项目目录

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. 常见问题解决

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

原因：Windows 版本太旧

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

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

解决：在 PowerShell 中执行

wsl--shutdown

然后重新打开 Ubuntu

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

解决：

sudoaptinstalllibatomic1-y

❌ 问题 4：nvm: command not found

解决：

source~/.bashrc

或关闭 Ubuntu 终端重新打开

❌ 问题 5：yarn install 很慢

解决：配置国内镜像

yarnconfigsetregistry https://registry.npmmirror.com

❌ 问题 6：权限错误

解决：

sudochmod-R755/mnt/d/01git/aiProject/aimarketing/marketing-app

📝 一键复制全部命令

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

# 更新系统并安装必要工具sudoaptupdate&&sudoaptupgrade-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

✅ 验证清单

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

💡 日常使用

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

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

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