Dev Environment Playbook / 开发环境搭建手册

从零配好开发环境——工具链、配置、踩坑记录，一次搞定。

工具链

工具	推荐版本	用途
JDK	8 / 17+	Java 后端（老项目用 8，新项目用 17+）
Maven	3.9+	Java 构建（3.9 需要 JDK17 运行）
Node.js	18 LTS / 最新	前端开发
MySQL	8.0+	关系型数据库
Redis	5.0+	缓存
Python	3.10+	脚本

多版本 JDK 共存

老项目必须 JDK8，新项目用 JDK21。不设全局 JAVA_HOME，用绝对路径：

/path/to/maven/bin/mvn -q compile
/path/to/maven/bin/mvn -q dependency:build-classpath -Dmdep.outputFile=cp.txt
/path/to/jdk8/bin/java -cp "target/classes;$(cat cp.txt)" com.example.Start

Maven 3.9+ 需要 JDK17 运行，但 pom.xml 设 source/target=1.8 确保字节码兼容 JDK8。

多版本 Node 共存

$env:PATH = "C:\path\to\node18;$env:PATH"
$env:NODE_OPTIONS = "--openssl-legacy-provider"
npm install && npm run dev

国内镜像

Maven settings.xml：

<mirror>
  <id>aliyun</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

npm：npm config set registry https://registry.npmmirror.com

pip：pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

踩坑清单

坑	解法
JDK 版本太高 → ClassNotFoundException: java.lang.Compiler	用 JDK8 启动
Node 版本太高 → npm install 各种报错	切 Node 18 + --openssl-legacy-provider
Windows 下 NODE_OPTIONS=xxx 不识别	用 $env:NODE_OPTIONS
端口被占用	netstat -ano | findstr ":PORT"
npm 证书过期 CERT_HAS_EXPIRED	切到 registry.npmmirror.com
断网后局域网 IP 失效	本地开发用 127.0.0.1

License

MIT