Windows11 安装 WSL Ubuntu 系统,Next.js 项目开发本地必备环境搭建
OpenNext 可以在 Windows 系统上使用,但不保证 Windows 完全支持,Next.js 工具本身存在 Windows 支持问题,此时适用于 Linux 的 Windows 子系统 (WSL) 允许在 Windows 计算机上运行 Linux 环境,就可以满足我们在本地的开发需求。
December 12, 2025
为什么要 WSL
随着微软推出的 Windows Subsystem for Linux(WSL),切换到Linux系统做编译部署变得触手可及。WSL不仅让开发者在 Windows 环境中无缝运行 Linux 应用,还为内核开发、驱动调试等提供了极大的便利。
OpenNext 支持所有 Next.js 功能,并能跨多个平台广泛部署在生产中。OpenNext 可以在 Windows 系统上使用,但不保证 Windows 完全支持,Next.js 工具本身存在 Windows 支持问题,此时适用于 Linux 的 Windows 子系统 (WSL) 允许在 Windows 计算机上运行 Linux 环境,就可以满足我们在本地的开发需求。同时,Visual Studio Code 有一个扩展这使得使用 WSL 进行开发变得非常容易,让我们一步一步来。
系统安装
通过 Windows11 终端运行以下代码。
// 安装 Ubuntu
wsl --install
// 卸载 Ubuntu
wsl --unregister Ubuntu
// 打印发行版名称
wsl -l -v
// 重启系统
wsl --shutdown
移动盘符
我们的开发项目展开后大多有几百MB大小,多个项目的话,占用硬盘达 GB级别,建议在 D 盘创建 WSL 目录存放系统。
// 导出备份文件
wsl --export Ubuntu D:\WSL\ubuntu-backup.tar
// 导入备份
wsl --import Ubuntu D:\WSL\Ubuntu\ D:\WSL\ubuntu-backup.tar --version 2
// 启动新系统
wsl -d Ubuntu
// 文件夹授权
sudo chmod -R 777 /home
// 更新系统软件
sudo apt update
sudo apt upgrade -y
// 安装 git(可选)
sudo apt install git -y
// 安装 zip 和 unzip(可选)
sudo apt install zip unzip
// zip 压缩文件夹
zip -r /home/cf.zip /home/cf/
// zip 解压文件夹
unzip /home/cf.zip -d /home/cf
nvm node安装
新的 Ubuntu 系统不带 node 程序的,必须自行安装,未安装前可能会共享 Windows 中的 node,请通过路径检查(命令在下面)进行识别甄别。
// 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
// 生效 nvm
source ~/.bashrc
// 验证 nvm
nvm -v
// 安装 Node 稳定版
nvm install --lts
// 切换 Node 稳定版
nvm use --lts
标准node安装(备用)
// 安装 Node.js 和 npm
sudo apt install nodejs
sudo apt install npm
// 验证安装
node -v
npm -v
// 路径检查
which node
which npm
// 删除版本
sudo apt remove nodejs npm -y
sudo apt purge nodejs npm -y
sudo apt autoremove -y
标准 Python 安装
// Python 和 pip
sudo apt install -y python3 python3-pip
// 检查版本
python3 --version
pip3 --version
VS code 应用
打开 VS code 左侧扩展按钮下放,有个远程资源管理器,选择打开文件夹,可以打开一个项目。如找不到这个按钮,在 Visual Studio Code 扩展中搜索 WSL,并安装即可。
以上就是Windows11 安装WSL Ubuntu系统的主要命令和方法,仅供参考。