WSL2 全栈开发环境搭建：多版本语言管理实践

欢迎关注专栏：AI 开发技术

• 上一篇:WSL2 与 Ubuntu 22.04 基础环境部署指南解析 Windows 下 WSL2 及 Ubuntu 22.04 的工程化安装与网络环境配置。
• 下一篇: [WSL2 核心中间件部署实战] 详解在 WSL2 系统环境下快速搭建开发测试所需的核心中间件集群。

WSL2 全栈开发环境搭建：多版本语言管理实践

关键词：SDKMAN, NVM, JDK, Maven, Node.js
阅读耗时：约 15 分钟

本文为个人技术学习笔记分享，记录工程实践过程，仅供参考。

1. 业务背景 / 核心问题

在实际开发中，我们往往需要同时维护多个项目，而不同项目对 JDK 和 Node.js 的版本要求差异巨大。如果直接使用系统包管理器（如apt）安装全局环境，会导致版本切换困难且容易引发依赖冲突。

本文主张使用SDKMAN!（Java 生态）和NVM（Node.js 生态）这两个环境版本管理工具，在 WSL2 中搭建完全解耦、可灵活切换的全栈开发环境。

2. Java 生态环境搭建 (SDKMAN!)

SDKMAN! 是管理多个软件开发套件（特别是 JVM 生态工具）的实用工具。

2.1 安装 SDKMAN!

首先安装必要的依赖：

sudoaptupdatesudoaptinstall-ycurlzipunzip

验证：

curl--versionzip-v|head-n1unzip-v|head-n1

执行安装脚本：

curl-s"https://get.sdkman.io"|bash

加载环境变量以立即生效：

source"$HOME/.sdkman/bin/sdkman-init.sh"

验证：

sdk version

(为确保每次打开终端自动加载，可以将该 source 命令追加到~/.bashrc中)

设置开机自动加载（可选但建议）

echo'source "$HOME/.sdkman/bin/sdkman-init.sh"'>>~/.bashrc

更新配置

source~/.bashrc

2.2 提速：配置国内镜像源

SDKMAN 默认访问国外节点较慢，可通过修改配置提升下载速度：

nano~/.sdkman/etc/config

新增或修改以下项：

sdkman.api=http://mirrors.aliyun.com/sdkman

在 nano 中, 保存然后退出：

Ctrl + O# 保存Enter(回车)Ctrl + X# 退出

保存后刷新缓存：sdk flush。

2.3 安装并管理 JDK 与 Maven

查看线上可用 JDK 列表：

sdk listjava

安装 JDK 8（推荐 Eclipse Temurin 版本）并设置为默认：

# 安装 JDK 8（推荐 Temurin）sdkinstalljava8.0.392-tem# 设置默认版本sdk defaultjava8.0.392-tem# 验证java-version

安装 Maven：

# 安装sdkinstallmaven# 验证mvn-v

3. 前端生态环境搭建 (NVM)

NVM (Node Version Manager) 则是前端开发不可或缺的版本管理工具。

3.1 安装 NVM

执行官方安装脚本：

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

配置环境变量使其生效（通常脚本会自动追加到.bashrc，可手动执行一次或重启终端）：

exportNVM_DIR="$HOME/.nvm"[-s"$NVM_DIR/nvm.sh"]&&\."$NVM_DIR/nvm.sh"

验证：

nvm--version

设置开机自动加载 NVM（可选）：

echo'export NVM_DIR="$HOME/.nvm"'>>~/.bashrcecho'[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"'>>~/.bashrcsource~/.bashrc

3.2 提速：配置 Node 国内镜像

为解决 Node.js 源码包下载缓慢的问题，需配置镜像源：

echo'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/'>>~/.bashrcsource~/.bashrc

验证配置是否生效：

echo$NVM_NODEJS_ORG_MIRROR

3.3 安装 Node.js LTS

安装当前兼容性最好的 LTS（长期支持）版本，并将其设为默认：

nvminstall18nvm use18nvmaliasdefault18

验证环境：

node-vnpm-v

4. 总结

借助 SDKMAN! 和 NVM，我们将 WSL2 的开发环境彻底从操作系统的全局包管理中解耦出来。不仅避免了环境变量污染，还能在多个遗留与全新项目之间实现快速的开发环境切换，为全栈工程体系奠定基础。