Win11 WSL2+Ubuntu开发环境配置全攻略

第一步：开启 Win11 WSL2 + 安装 Ubuntu

1. 管理员 PowerShell 开启功能

按下 Win + X → 选择 Windows 终端 (管理员)，依次执行：

powershell

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完重启电脑。

2. 设置 WSL 默认版本为 2

重启后再开管理员终端：

powershell

wsl --set-default-version 2

3. 安装 Ubuntu

powershell

wsl --install -d Ubuntu-22.04

等待下载安装，弹出窗口时设置：

• 用户名：自定义（比如 dev）
• 密码：自定义记住（后续 sudo 要用）

4. 验证

powershell

wsl --list --verbose

看到 Ubuntu-22.04 状态 Running、版本 2 ✅

---

第二步：优化 WSL2（内存限制 + 固定 IP 开发必备）

1. 限制 WSL2 最大内存（你 16G 内存，设 8G 合理）

Win11 打开文件资源管理器，地址栏输入：

plaintext

%UserProfile%

新建文件 .wslconfig（无后缀），内容：

ini

[wsl2]
memory=8GB
processors=4
swap=2GB
localhostForwarding=true

2. 生效配置

管理员终端执行：

powershell

wsl --shutdown

重新打开 Ubuntu 即可。

---

第三步：WSL2 Ubuntu 基础环境更新 & 安装中间件

1. 先更新源

bash

运行

sudo apt update && sudo apt upgrade -y

2. 安装 JDK17（WSL 内可选，后面 IDEA 可连 Win 本地 JDK）

bash

运行

sudo apt install openjdk-17-jdk -y
java -version

3. WSL2 安装核心中间件（Java 分布式必备）

① MySQL8.0

bash

运行

sudo apt install mysql-server -y
sudo systemctl enable mysql
sudo systemctl start mysql

初始化 root 允许远程、设置密码 123456：

bash

运行

sudo mysql -e "ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';FLUSH PRIVILEGES;"

② Redis

bash

运行

sudo apt install redis-server -y
sudo systemctl enable redis-server
sudo systemctl start redis-server

③ Nacos 2.3.0（微服务注册配置中心）

先装依赖：

bash

运行

sudo apt install wget tar -y

下载 + 解压：

bash

运行

wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.tar.gz
tar -zxvf nacos-server-2.3.0.tar.gz
sudo mv nacos /usr/local/

启动 Nacos（单机模式）：

bash

运行

/usr/local/nacos/bin/startup.sh -m standalone

访问：http://localhost:8848/nacos 账号密码 nacos/nacos

---

第四步：Windows11 本地安装开发端工具

1. 安装 Windows 版 JDK17

推荐 Microsoft OpenJDK 17，自动配环境：https://aka.ms/download-jdk/microsoft-jdk-17-windows-x64.msi安装后 CMD 验证：

cmd

java -version

2. 安装 Maven 3.9.14

解压到 D:\maven-3.9.14，配置系统变量 MAVEN_HOME，Path 添加 %MAVEN_HOME%\bin验证：

cmd

mvn -v

3. 安装 Git

https://git-scm.com/download/win默认安装即可，验证 git --version

4. 安装 IDEA Community 免费版

https://www.jetbrains.com/idea/download/安装后装插件：通义灵码（AI 生成 Java 分布式代码）

5. 安装 DBeaver / ApiPost

• DBeaver：连 WSL 里的 MySQL 可视化
• ApiPost：测试微服务接口

---

第五步：关键打通 Windows ↔ WSL2

1. Windows 里 localhost:3306 连 WSL MySQL、6379 连 Redis、8848 连 Nacos 自带互通
2. IDEA 配置：
   • JDK：选 Windows 本地 JDK17
   • Maven：本地 Windows Maven
   • 数据库连接：Host=localhost，端口默认，连上 WSL2 的 MySQL

---

第六步：后续使用标准启动顺序

1. 打开 WSL2 Ubuntu
2. 启动 MySQL / Redis / Nacos
3. 打开 Windows IDEA → 用通义灵码生成 SpringCloudAlibaba 分布式项目
4. 配置 application.yml 连接 localhost 的 MySQL/Redis/Nacos
5. 直接运行微服务