核心原因是安装程序需向系统目录或注册表写入但用户无管理员权限；Windows须右键以管理员身份运行且提权在双击瞬间生效，或改用免安装版解压至用户目录并配用户级环境变量。

安装 JDK 提示“权限不足”，核心原因是安装程序需要向系统级路径（如 C:\Program Files\Java）或注册表（HKEY_LOCAL_MACHINE）写入文件，而当前用户账户没有管理员权限。这不是安装包坏了，而是 Windows/Linux 的安全机制在起作用。解决方法分平台、分场景，关键在“提权时机”和“路径选择”。

Windows：必须以管理员身份运行，且要在双击瞬间生效

很多用户右键选了“以管理员身份运行”，但安装向导已启动、临时文件已解压，此时再提权无效。正确做法是：

• 关闭所有杀毒软件（特别是 Windows Defender 实时防护，它常拦截注册表写入）
• 右键 JDK 安装包（如 jdk-24.0.1_windows-x64_bin.exe），直接选择“以管理员身份运行”
• 全程不要切换窗口、不要最小化安装向导——确保提权状态贯穿整个安装流程
• 若公司电脑受组策略限制（如禁用 Windows Installer），即使提权也会失败，需联系 IT 部门解除策略

非管理员账户：改用免安装版 + 用户级环境变量

开发用 JDK 不必装进系统目录。下载 .zip 免安装版（如 jdk-21_windows-x64_bin.zip），解压到你有完全控制权的路径：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 解压到 %USERPROFILE%\jdk-21（即 C:\Users\你的用户名\jdk-21）
• 在“系统属性 → 高级 → 环境变量”中，只修改用户变量：
    – JAVA_HOME 设为 %USERPROFILE%\jdk-21
    – PATH 新增 %JAVA_HOME%\bin
• 验证：打开新命令行，运行 java -version 和 javac -version，两者版本号必须一致

Linux/macOS：检查目标目录权限与可执行位

下载或解压时报“Permission denied”，通常不是账户无 sudo 权限，而是：

• 下载时目标目录不可写：改用 wget -P ~/ 下载到家目录，或先 sudo mkdir -p /opt/java 再赋权
• 解压后 java 文件无执行权限：进入 jdk-xx/bin/ 目录，运行 chmod +x java javac
• WSL2 用户注意：/tmp 空间可能不足（默认仅几百 MB），运行 sudo mount -o remount,size=2G /tmp 临时扩容
• CentOS/RHEL 安装后报错“Permission denied”：常见于 /usr/local/jdk 目录属主不是当前用户，用 sudo chown -R $USER:$USER /usr/local/jdk 修复

绕过权限问题的终极方案：用包管理器安装

Ubuntu/Debian 用 APT、CentOS/RHEL 用 DNF、macOS 用 Homebrew，它们自动处理权限、路径和依赖：

• Ubuntu 安装 OpenJDK 17：sudo apt update && sudo apt install openjdk-17-jdk
• CentOS 8+ 安装 OpenJDK 11：sudo dnf install java-11-openjdk-devel
• macOS：brew install openjdk@17，然后按提示配置 PATH
• 优点：无需手动设环境变量、不写注册表、不碰系统目录，天然规避权限冲突