环境配置之痛：多版本SDK管理、依赖冲突、环境隔离方案

说实话，环境配置这件事，我见过太多团队在这上面栽跟头了。

你想想看，一个项目跑得好好的，换台机器就崩了。或者新来的同事配了一天环境，最后发现是JDK版本不对。这种场景，我猜你肯定不陌生。

我个人习惯把环境问题分成三类：多版本SDK共存、依赖冲突、环境隔离。咱们一个一个说。

多版本SDK管理——别让版本成为绊脚石

我记得刚带团队那会儿，有个项目需要JDK 8，另一个项目必须用JDK 11。来回切换环境变量，烦得要死。更坑的是，有时候切完忘了改回去，编译半天报错，才发现版本不对。

为什么会这样？说白了，操作系统全局只认一个JAVA_HOME。你装了两个JDK，系统只知道其中一个。

解决方案其实不复杂。我推荐几个工具：

• SDKMAN：Java生态的瑞士军刀。支持JDK、Maven、Gradle、Spring Boot等。
• nvm：Node.js版本管理，前端同学应该很熟。
• pyenv：Python版本管理，数据科学团队必备。

安装SDKMAN很简单：

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

然后安装你需要的JDK版本：

sdk install java 11.0.12-open
sdk install java 8.0.302-open

在项目根目录创建.sdkmanrc文件：

java=11.0.12-open

每次进入项目目录，执行sdk env，版本自动切换。嗯，这里要注意，团队成员必须都装SDKMAN，否则这个文件没意义。

依赖冲突——Maven/Gradle的暗坑

依赖冲突这个问题，我曾在一次线上事故中吃过亏。两个库依赖了不同版本的Log4j，结果运行时ClassNotFoundException，服务直接挂了。

为什么会冲突？Maven和Gradle的依赖传递机制，会把间接依赖也拉进来。如果A依赖B v1.0，C依赖B v2.0，那到底用哪个？

Maven默认用最短路径优先，Gradle默认用最新版本优先。但不管哪种策略，都可能出问题。

解决方案：

• Maven：用mvn dependency:tree查看依赖树，用<exclusions>排除冲突的依赖。
• Gradle：用gradle dependencies查看，用implementation替代compile，减少传递依赖。

举个例子，Maven排除依赖：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>library-a</artifactId>
    <version>1.0</version>
    <exclusions>
        <exclusion>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle里更简洁：

implementation('com.example:library-a:1.0') {
    exclude group: 'log4j', module: 'log4j'
}

环境隔离——Docker和虚拟环境

环境隔离，说白了就是让每个项目有自己的小天地。互不干扰，干净利落。

我常用的方案有两种：Docker容器和虚拟环境。

Docker容器——终极隔离方案

Docker的好处是，连操作系统层都隔离了。你在容器里装什么，都不会影响宿主机。

一个典型的Java项目Dockerfile：

FROM openjdk:11-jre-slim
WORKDIR /app
COPY target/myapp.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

配合docker-compose.yml，可以一键启动整个服务栈：

version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=dev
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass

虚拟环境——轻量级隔离

如果你不想用Docker，或者项目比较简单，虚拟环境就够了。

Python的venv：

python -m venv myenv
source myenv/bin/activate  # Linux/Mac
myenv\Scripts\activate     # Windows

Node.js的npm本地安装：

npm init
npm install express --save-dev

Java的Maven Wrapper：

mvn -N io.takari:maven:wrapper
./mvnw clean install

总结一下

环境配置这件事，说白了就是标准化和自动化。

• 多版本SDK：用SDKMAN、nvm、pyenv这类工具，每个项目自动切换。
• 依赖冲突：用依赖树排查，用exclusion排除，用CI检查。
• 环境隔离：小项目用虚拟环境，大项目用Docker。

我记得有一次，一个新项目需要JDK 17、Python 3.10、Node 18。我花10分钟配好Docker环境，然后发了个README给团队。大家pull下来直接跑，零配置问题。那种感觉，真的很爽。

你想想看，如果每个项目都能做到一键运行，那开发效率能提升多少？

嗯，今天就聊到这儿。下一章咱们聊聊代码规范那些事。