macOS 下 VSCode Java 开发环境配置指南在 macOS 系统上配置 VSCode 的 Java 开发环境

概述

在 macOS 系统上配置 VSCode 的 Java 开发环境，包括插件安装、Homebrew 安装、JDK 配置和项目创建。

前置要求

macOS 系统
稳定的网络连接
已安装 VSCode

配置步骤

1. 安装 VSCode Java 插件

访问 VSCode 插件市场并安装 Java Extension Pack：

https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack

这个插件包包含了 Java 开发所需的全部工具。

2. 安装 Homebrew

Homebrew 是 macOS 的包管理器，使用它来安装 JDK。

# 下载并安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 验证安装
brew --version

3. 安装 OpenJDK

使用 Homebrew 安装 OpenJDK：

# 安装 OpenJDK（最新版本）
brew install openjdk

# 安装特定版本（可选）
brew install openjdk@24

4. 配置环境变量

4.1 检查当前 Shell

echo $SHELL

4.2 配置 PATH 和 JAVA_HOME

将以下配置添加到 ~/.zshrc 文件：

# 添加 OpenJDK 到 PATH
echo 'export PATH="/usr/local/opt/openjdk/bin:$PATH"' >> ~/.zshrc

# 设置 JAVA_HOME
echo 'export JAVA_HOME=/usr/local/opt/openjdk' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

4.3 验证安装

# 检查 Java 版本
java --version

# 预期输出：
# openjdk 24.0.1 2025-04-15
# OpenJDK Runtime Environment Homebrew (build 24.0.1)
# OpenJDK 64-Bit Server VM Homebrew (build 24.0.1, mixed mode, sharing)

# 检查 javac 版本
javac -version

# 检查 JAVA_HOME 路径
brew --prefix openjdk

5. 测试 Java 编译和运行

创建一个简单的测试文件：

# 编译 Java 文件
javac demo.java

# 运行 Java 程序
java demo

6. 在 VSCode 中创建 Java 项目

打开 VSCode
使用快捷键 Shift + Command + P 打开命令面板
输入并选择：Java: Create Java Project
选择 No build tools（或根据需要选择 Maven/Gradle）
选择项目目录并命名

环境变量配置总结

确保在 ~/.zshrc 文件中包含以下配置：

export JAVA_HOME=/usr/local/opt/openjdk
export PATH="/usr/local/opt/openjdk/bin:$PATH"

故障排除

常见问题

Java 命令未找到
- 确保已执行 source ~/.zshrc
- 重启终端
权限问题
- 确保 Homebrew 安装时有足够权限
- 可能需要使用 sudo 命令
版本冲突
- 如果系统中有多个 Java 版本，确保 JAVA_HOME 指向正确的版本

验证配置

运行以下命令验证配置是否正确：

echo $JAVA_HOME
echo $PATH | grep java
java --version
javac -version

总结

完成以上步骤后，macOS 系统就已经配置好了完整的 VSCode Java 开发环境。可以开始创建和运行 Java 项目。

macOS 下 VSCode Java 开发环境配置指南

概述