脚本自动配置Java环境变量：Linux/macOS用Shell探测JDK路径并写入~/.bashrc或~/.zshrc，Windows用PowerShell设置当前用户JAVA_HOME和PATH，均避免硬编码、支持自动探测与重复防护。
编写一个脚本自动配置 Java 环境变量，核心是让系统识别 JAVA_HOME 并将其 bin 目录加入 PATH。不同操作系统写法不同，下面分 Linux/macOS 和 Windows 两类给出实用、可直接运行的方案。
Linux/macOS：用 Shell 脚本一键配置（推荐）
该脚本会检测 JDK 安装路径（支持 /usr/lib/jvm 或自定义路径），修改用户级 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），并立即生效。
- 先确认 JDK 已安装：运行
sudo apt install openjdk-17-jdk（Ubuntu/Debian）或brew install openjdk@17（macOS） - 新建脚本
setup-java.sh，内容如下：
#!/bin/bash # 自动配置 JAVA_HOME 和 PATH JDK_PATH=$(dirname $(dirname $(readlink -f $(which java) 2>/dev/null || echo "/usr/bin/java"))) 2>/dev/null <p>if [ -z "$JDK_PATH" ] || [ ! -d "$JDK_PATH" ]; then echo "⚠️ 未找到 JDK，请手动指定路径（例如 /usr/lib/jvm/java-17-openjdk-amd64）" read -p "请输入 JDK 根目录: " JDK_PATH fi</p><p>if [ ! -d "$JDK_PATH" ]; then echo "❌ 路径不存在：$JDK_PATH" exit 1 fi</p><p>JAVA_HOME=$JDK_PATH BIN_DIR="$JAVA_HOME/bin"</p><h1>检测当前 shell 类型，写入对应配置文件</h1><p>SHELL_CONFIG="$HOME/.bashrc" if [ -n "$ZSH_VERSION" ]; then SHELL_CONFIG="$HOME/.zshrc" elif [ -n "$BASH_VERSION" ]; then SHELL_CONFIG="$HOME/.bashrc" fi</p><h1>写入环境变量（避免重复）</h1><p>if ! grep -q "export JAVA_HOME=" "$SHELL_CONFIG" 2>/dev/null; then echo "" >> "$SHELL_CONFIG" echo "# Java environment" >> "$SHELL_CONFIG" echo "export JAVA_HOME=$JAVA_HOME" >> "$SHELL_CONFIG" echo 'export PATH=$JAVA_HOME/bin:$PATH' >> "$SHELL_CONFIG" echo "✅ 已写入 $SHELL_CONFIG" else echo "? JAVA_HOME 已存在，跳过写入" fi</p><h1>立即加载</h1><p>source "$SHELL_CONFIG" echo "✅ 配置完成！当前 JAVA_HOME: $JAVA_HOME" java -version 2>/dev/null || echo "⚠️ 请重启终端或执行 source $SHELL_CONFIG"
使用方式：chmod +x setup-java.sh && ./setup-java.sh
Windows：用 PowerShell 脚本静默设置（管理员非必需）
PowerShell 可安全修改当前用户环境变量，无需管理员权限；若需系统级设置，才需以管理员运行。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 新建
setup-java.ps1，内容如下：
# 检测 JDK（优先找 JAVA_HOME，再查注册表和常见路径）
$javaHome = $env:JAVA_HOME
if (-not $javaHome -or !(Test-Path "$javaHome\bin\java.exe")) {
# 尝试常见路径
$candidates = @(
"${env:ProgramFiles}\Java\jdk-17*",
"${env:ProgramFiles(x86)}\Java\jdk-17*",
"$env:USERPROFILE\.jdks\openjdk-17*"
)
foreach ($c in $candidates) {
$match = Get-ChildItem $c -Directory -ErrorAction SilentlyContinue | Select-Object -First 1
if ($match -and (Test-Path "$($match.FullName)\bin\java.exe")) {
$javaHome = $match.FullName
break
}
}
}
<p>if (-not $javaHome) {
Write-Warning "未找到 JDK 17，请先安装 OpenJDK 或 Oracle JDK"
exit 1
}</p><h1>设置当前用户环境变量（不需管理员）</h1><p><a href="https://www.php.cn/link/30d709636c9381de7ee32591032d27b9" title="$javaHome\bin;$path", "User"">Environment</a>::SetEnvironmentVariable("JAVA_HOME", $javaHome, "User")
$path = <a href="https://www.php.cn/link/30d709636c9381de7ee32591032d27b9" title="$javaHome\bin;$path", "User"">Environment</a>::GetEnvironmentVariable("PATH", "User")
if ($path -notlike "<em>$javaHome\bin</em>") {</p><p>Write-Host "✅ JAVA_HOME 和 PATH 已更新（当前用户）"
} else {
Write-Host "? 环境变量已存在，跳过设置"
}</p><h1>提示验证方式</h1><p>Write-Host "`n? 验证方法（新开 PowerShell 窗口执行）：" -ForegroundColor Green
Write-Host "java -version"
Write-Host "$env:JAVA_HOME"
使用方式：右键 → “使用 PowerShell 运行”，或在 PowerShell 中执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 后运行脚本。
通用建议与避坑点
-
不要硬编码路径：脚本应自动探测 JDK，而非写死
/opt/jdk-17.0.1，否则迁移性差 - 区分用户级 vs 系统级：普通用户脚本默认改用户变量更安全；系统级需提权且影响所有用户
-
验证是否生效：脚本末尾加
java -version和echo $JAVA_HOME（Linux/macOS）或$env:JAVA_HOME（Windows） - IDE 需重启：VS Code、IntelliJ 等不会自动读取新环境变量，需完全关闭后重开
进阶：支持多版本切换（可选）
若需在多个 JDK 版本间快速切换，可扩展脚本添加参数，例如：./setup-java.sh --jdk17 或 ./setup-java.sh --jdk21，内部维护多个预设路径并替换 JAVA_HOME 值。这类逻辑适合封装为函数或独立工具（如 jabba 或 sdkman），但纯脚本也能实现。
