Windows开发环境配置

在Windows系统中配置开发环境相对直观，本指南将详细介绍如何在Windows 10/11上配置Java、Maven、Node.js等常用开发环境。

Java开发环境配置

JDK安装与配置

下载JDK

  1. 访问Oracle官方下载页面或OpenJDK下载页面
  2. 选择适合Windows的JDK版本（推荐使用LTS长期支持版本，如JDK 8、11、17）
  3. 下载Windows的.msi或.exe安装包

安装JDK

  1. 双击下载的安装文件，启动安装向导
  2. 按照安装向导的提示进行安装
  3. 记住JDK的安装路径，例如C:\Program Files\Java\jdk-17

配置环境变量

  1. 右键点击"此电脑"（或"我的电脑"），选择"属性"
  2. 点击"高级系统设置"
  3. 在"高级"选项卡中，点击"环境变量"按钮
  4. 在"系统变量"区域，添加或修改以下变量：
    • 新建JAVA_HOME变量：
      • 变量名：JAVA_HOME
      • 变量值：JDK安装路径，例如C:\Program Files\Java\jdk-17
    • 编辑Path变量，添加以下内容：
      • %JAVA_HOME%\bin

验证Java安装

  1. 打开命令提示符(CMD)或PowerShell
  2. 输入以下命令验证Java是否正确安装：
    java -version
javac -version
  3. 如果安装成功，将显示已安装的JDK版本信息

Maven安装与配置

Maven是Java项目的构建工具和依赖管理工具。

下载Maven

  1. 访问Apache Maven官方网站
  2. 下载最新的二进制zip压缩包（例如apache-maven-3.9.5-bin.zip）

安装Maven

  1. 解压下载的zip文件到指定目录，例如C:\Program Files\Apache\maven
  2. 配置环境变量：
    • 新建系统变量MAVEN_HOME：
      • 变量名：MAVEN_HOME
      • 变量值：Maven解压路径，例如C:\Program Files\Apache\maven
    • 编辑Path变量，添加：
      • %MAVEN_HOME%\bin

配置Maven设置

  1. 在用户目录下创建.m2文件夹（如果不存在）：C:\Users\<用户名>\.m2
  2. 可以从Maven安装目录复制一个settings.xml文件到.m2目录进行自定义设置
  3. 可选：配置国内镜像加速下载依赖：
    <mirrors>
  <mirror>
    <id>aliyun</id>
    <name>Aliyun Maven Repository</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

验证Maven安装

打开命令提示符或PowerShell，运行：

mvn -version

Node.js开发环境配置

安装Node.js和npm

方法一：使用安装包

  1. 访问Node.js官方网站
  2. 下载推荐的LTS（长期支持）版本的Windows安装程序
  3. 双击安装程序并按照向导操作
  4. 安装过程会自动设置Path环境变量

方法二：使用NVM for Windows（推荐）

NVM（Node Version Manager）允许在同一系统上安装和切换不同版本的Node.js。

  1. 访问NVM for Windows
  2. 下载最新的nvm-setup.exe
  3. 按照安装向导完成安装
  4. 安装完成后，打开新的命令提示符安装Node.js：
    nvm install 18.12.0  # 安装LTS版本
nvm use 18.12.0      # 使用此版本

验证Node.js安装

在命令提示符或PowerShell中运行：

node -v
npm -v

配置npm镜像（可选）

为提高包下载速度，可以配置npm使用国内镜像：

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

IDE安装与配置

Visual Studio Code

  1. 从官方网站下载VSCode
  2. 安装推荐扩展：
    • Java扩展包：vscjava.vscode-java-pack
    • Maven for Java：vscjava.vscode-maven
    • Spring Boot Extension Pack：pivotal.vscode-boot-dev-pack
    • JavaScript和Node.js扩展：nodejs-extension-pack

IntelliJ IDEA

  1. 从JetBrains官网下载IDEA（社区版免费）
  2. 按照安装向导完成安装
  3. 首次启动时配置JDK和Maven

Git安装与配置

  1. 从Git官网下载Windows版Git

  2. 安装时推荐设置：

    • 选择"Git Bash和Git GUI"
    • 选择"Use Git from the Windows Command Prompt"
    • 选择"Checkout as-is, commit as-is"
    • 选择"Use Windows' default console window"

  3. 安装后基本配置：

    git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

环境变量管理技巧

使用PowerShell脚本自动设置环境

可以创建一个PowerShell脚本来自动设置开发环境变量：

# 设置Java环境
$env:JAVA_HOME = "C:\Program Files\Java\jdk-17"

# 设置Maven环境
$env:MAVEN_HOME = "C:\Program Files\Apache\maven"

# 添加到PATH
$env:Path = "$env:JAVA_HOME\bin;$env:MAVEN_HOME\bin;$env:Path"

# 显示已设置的环境
Write-Host "Java版本:" 
java -version

Write-Host "Maven版本:" 
mvn -version

Write-Host "Node版本:" 
node -version

将此脚本保存为dev-env.ps1，需要时运行即可临时设置环境变量。

常见问题与解决方案

Java环境问题

  1. 找不到javac命令

    • 确保JAVA_HOME指向JDK（不是JRE）
    • 确保PATH中包含%JAVA_HOME%\bin

  2. 版本不兼容问题

    • 不同项目可能需要不同版本的JDK
    • 可以使用SDKMAN for Windows或Jabba管理多版本

Maven问题

  1. 依赖下载失败

    • 检查网络连接
    • 配置镜像源
    • 检查settings.xml配置

  2. 构建失败

    • 确保pom.xml格式正确
    • 检查JDK版本与项目兼容性

Node.js问题

  1. npm全局安装权限问题
    • 以管理员身份运行命令提示符
    • 或配置npm全局包到用户目录：
      npm config set prefix "C:\Users\<用户名>\AppData\Roaming\npm"

使用Docker统一开发环境

为了避免"我电脑上能运行"的问题，可以使用Docker容器化开发环境：

  1. 安装Docker Desktop for Windows
  2. 为项目创建Dockerfile或使用docker-compose.yml
  3. 使用VS Code的Remote Containers扩展在容器中开发

参考资源

如果您在配置过程中遇到任何问题，欢迎联系我寻求帮助。