2026 最新版：WSL + Ubuntu 全栈开发环境，一篇搞定！

前言

本文介绍基于 WSL（Windows Subsystem for Linux）安装和配置全栈开发环境的方法。若你尚未安装 WSL，请参考这篇文章《极简 WSL2 教程：开发、部署大模型必备》，完成安装后再执行下文操作。

1. 在 Ubuntu 系统中安装软件

在 Ubuntu 系统中是通过apt这个命令来安装系统软件的。apt相当于安卓系统上面的应用商店。

不过 Ubuntun 自带的apt只能安装系统常用的关键软件。像我们常用的开发工具软件，还是需要我们自己通过脚本命令进行安装。

1.1 apt 的软件源地址

使用 Ubuntu 系统自带的apt命令安装软件时，apt只会去系统中默认的软件源地址里面找相应的软件。如果你在使用apt安装软件的过程中总是出现网络超时错误，可以考虑将apt系统默认的软件源地址更换为国内的源地址，比如：清华提供的apt源地址。

apt系统默认的软件源地址在这个文件中/etc/apt/sources.list

bash 复制代码

# 查看Ubuntu系统默认的apt软件源地址
cat /etc/apt/sources.list

2. 安装 unzip 压缩软件

后续安装其他软件时，大多需要依赖 unzip 工具解压安装包，因此建议提前安装 unzip，避免后续操作出现解压相关报错。

2.1 先刷新 apt 的应用商店

安装前需先刷新 apt 软件源（获取最新的软件包列表），该操作需通过 sudo 以管理员权限执行：

bash 复制代码

# 刷新软件列表（相当于刷新应用商店）
sudo apt update

2.2 查看本机是否安装 unzip

bash 复制代码

# 查看本机是否安装了unzip
apt policy unzip

2.3 安装 unzip

bash 复制代码

# 安装unzip压缩软件
sudo apt install unzip -y

2.4 再次查看本机是否安装 unzip

bash 复制代码

# 查看本机是否安装了unzip
apt policy unzip

3. 安装 JDK

3.1 下载 JDK

去Oracle 官网[1]下载 JDK 安装压缩包。下载 JDK 需注册 Oracle 账号，该账号注册流程较慢，且可能出现各类报错，建议多次尝试直至注册成功。注册成功后，按照如下步骤下载即可。

说明一下：RPM Package(安装包)是给 RedHat 或 CentOS 操作系统使用的。ARM64 是给苹果的 M 系列芯片使用的。x86 是 32 位系统。x64 是 64 位系统。Compressed Archive是压缩包的意思。

我们在 Ubuntu 系统里面只能安装:x64 Compressed Archive。

3.2 复制 JDK 安装压缩包到 WSL 文件系统里面

通过浏览器下载的 JDK 安装包默认保存在 Windows 文件系统中，需将其复制到 WSL 的文件系统后再进行安装。

我们先在Ubuntu里面给jdk创建一个安装目录。使用cd命令进入/usr/local目录，执行如下命令:

bash 复制代码

# 创建一个jdk文件夹，然后在jdk文件里面再创建一个jdk-8u481的文件夹
sudo mkdir -p jdk/jdk-8u481

bash 复制代码

# 使用cd命令进入Windows的下载目录
cd /mnt/c/Users/yale2/Downloads/
# 使用sudo cp命令，将jdk安装包复制到/usr/local/jdk/jdk-8u481目录中
sudo cp jdk-8u481-linux-x64.tar.gz /usr/local/jdk/jdk-8u481/

3.3 解压 JDK 压缩包

bash 复制代码

# 将jdk-8u481-linux-x64.tar.gz解压到当前目录
sudo tar -zxvf jdk-8u481-linux-x64.tar.gz

3.4 配置环境变量

使用 vim 编辑器打开 /etc/profile 系统环境变量配置文件：

bash 复制代码

# 使用vim编辑/etc/profile环境变量配置文件
sudo vim /etc/profile
# 重新加载/etc/profile配置文件，使JDK的环境变量立即生效
source /etc/profile
# 查看JDK的版本
java -version

4 安装 Maven

4.1 下载 Maven 的二进制安装包

访问Maven 官网[2]，下载 Maven 的Binary distribution二进制安装包。

4.2 将 Maven 安装包复制到 WSL 里面

bash 复制代码

# 进入/usr/local目录
cd /usr/local
# 创建maven文件夹
sudo mkdir maven
# 进入maven安装包的下载目录
cd /mnt/c/Users/yale2/Downloads/
# 将maven安装包复制到/usr/local/maven目录下面
sudo cp apache-maven-3.9.14-bin.tar.gz /usr/local/maven/

4.3 解压 maven 安装包

python 复制代码

# 解压maven安装包
sudo tar -zxf apache-maven-3.9.14-bin.tar.gz

4.5 配置环境变量

bash 复制代码

# 使用vim编辑/etc/profile环境变量配置文件
sudo vim /etc/profile
# 重新加载/etc/profile配置文件，使maven的环境变量立即生效
source /etc/profile
# 查看maven的版本
mvn -v

4.6 修改 maven 的仓库地址

bash 复制代码

# 先使用cd命令，进入maven的conf目录下面
cd /usr/local/maven/apache-maven-3.9.14/conf/
# 使用cp命令备份(复制)原始的settings.xml
sudo cp settings.xml settings.xml.origin.bak
# 使用sudo vim 编辑settings.xml
sudo vim settings.xml

在settings.xml文件中的<mirrors>里面添加如下配置：

xml 复制代码

<!-- 阿里云中央仓库 -->
<mirror>
 <id>aliyunmaven</id>
 <mirrorOf>central</mirrorOf><url>https://maven.aliyun.com/repository/public</url>
</mirror>
<!-- 阿里云谷歌仓库 -->
<mirror>
 <id>aliyun-google</id>
 <mirrorOf>google</mirrorOf><url>https://maven.aliyun.com/repository/google</url>
</mirror>
<!-- 阿里云插件仓库 -->
<mirror>
 <id>aliyun-plugin</id>
 <mirrorOf>plugin-group</mirrorOf><url>https://maven.aliyun.com/repository/plugin</url>
</mirror>

4.7 验证配置是否生效

bash 复制代码

# 验证我们刚刚修改的maven镜像仓库是否生效
mvn help:system

5 安装 NodeJS

我们这里通过fnm安装NodeJS，这也是 NodeJS 官方推荐的安装方式。fnm = Fast Node Manager,超快的 NodeJS 版本管理器。

它和 nvm 功能一模一样：

安装任意 Node 版本
切换任意 Node 版本
管理全局 npm 包 fnm 比 nvm 快 10 倍以上！而且更简单、更现代！fnm 这个工具的唯一功能就是管理 Node.js！fnm = 专门下载、安装、切换 Node.js 的工具。

5.1 fnm

通过 NodeJS 官网提供的安装脚本，安装 fnm。

bash 复制代码

# 下载并安装fnm。自动给你装最新的、正式发布的、稳定版fnm。绝对不会碰测试版、开发版、beta 版！测试版fnm必须手动指定才能装
curl -o- https://fnm.vercel.app/install | bash

5.2 通过 fnm 安装 NodeJS

bash 复制代码

# fnm install 24,这个命令会自动安装NodeJS 24.x 最新的版本！只会安装 24 系列里最新的稳定版（LTS / Stable）
fnm install 24
# 也可以使用fnm安装指定版本的NodeJS:fnm install 24.14.1
fnm install 24.14.1
# 只装最新版本的官方长期支持版（最稳、最安全）
fnm install --lts

正在安装 NodeJS,安装进度：

安装 NodeJS 成功,可以使用node -v和npm -v查看node和npm的版本号了。

5.3 配置 NPM 的国内源地址

bash 复制代码

# 查看npm的源地址，npm官方的源地址:https://registry.npmjs.org/
npm config get registry
# 淘宝镜像（最推荐，最快最稳）
npm config set registry https://registry.npmmirror.com

6 安装 Git

WSL2安装的Ubuntu系统本身就自带Git软件。

6.1 查看 Ubuntu 是否安装了 Git

bash 复制代码

# 查看Ubuntu系统是否安装了Git
apt policy git

6.2 更新 Git

bash 复制代码

# 更新Git,必须使用sudo命令进行升级
sudo apt install git -y

6.3 查看 git 的版本

bash 复制代码

# 查看git的版本
git --version

6.4 配置 Git

给Git配置你的用户名和你的邮箱。

bash 复制代码

# 配置你的用户名
git config --global user.name "Your Name"
# 配置你的邮箱
git config --global user.email "email@example.com"
# 查看我们全局配置的用户名
git config --global user.name
# 查看我们全局配置的邮箱
git config --global user.email

配置 SSH 公钥

为了能让我们将本地Git仓库中的代码顺利的提交到远程Github仓库上面，我们还需要在本地生成一个公钥，然后将公钥配置到GitHub上面。执行下面的命令生成本地公钥：

bash 复制代码

# 生成公钥
ssh-keygen -t rsa -C "youremail@example.com"
# 进入公钥所在目录
cd /home/wangyi/.ssh/
# 输入公钥内容
cat id_rsa.pub

在 GitHub 上面配置公钥

访问GitHub,并登录你的GitHub账号。

完成 GitHub 公钥配置后，本地 Git 仓库的代码即可顺利推送到 GitHub 远程仓库。

结尾

关注我，下篇文章教你把 Windows 变成纯终端，用 IDEA 远程连接 WSL 进行日常开发。

代码编写、部署、测试全程跑在 WSL（Linux）上，让本地开发环境与生产环境完全一致，再也没有环境不一致的坑！(❁´◡`❁)。

参考资料 [1]

Oracle官网: www.oracle.com/cn/

2

Maven官网: maven.apache.org/install.htm...