多用户服务器上Java环境变量必须按用户隔离配置：推荐编辑~/.bashrc（Bash）或~/.zshrc（Zsh）设置JAVA_HOME和PATH，source后生效；严禁修改/etc/profile等全局文件；可用软链接统一管理共用JDK，私有JDK可解压至家目录；临时切换用export命令，systemd用户服务需配置~/.profile或service文件。
在多用户服务器上，Java 环境变量不能“全局统一配置后所有用户自动生效”，必须按用户隔离设置，否则会互相干扰或权限越界。核心原则是：谁用谁配，互不覆盖。
用户级配置（推荐，安全且灵活）
普通用户无需 root 权限，即可为自己独立设置 Java 环境，适用于开发、测试或项目依赖不同 JDK 版本的场景。
- 编辑当前用户的 shell 配置文件：
Bash 用户改 ~/.bashrc，Zsh 用户改 ~/.zshrc - 添加两行（以 JDK 17 安装在 /opt/java/jdk-17.0.2 为例）：
export JAVA_HOME=/opt/java/jdk-17.0.2export PATH=$JAVA_HOME/bin:$PATH - 运行
source ~/.bashrc（或对应文件）立即生效 - 验证：执行
java -version和echo $JAVA_HOME，输出应一致且指向目标 JDK
避免影响其他用户的红线操作
系统级配置文件一旦修改，所有用户都会继承——这不是隔离，而是强耦合，极易引发冲突。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 不要触碰 /etc/profile、/etc/environment 或 /etc/bash.bashrc，除非你明确要为所有用户统一分发同一 JDK
- 若多个用户共用一个 JDK 安装目录，建议用软链接统一管理：
sudo ln -sf /opt/java/jdk-17.0.2 /opt/java/current，再让各用户将JAVA_HOME指向 /opt/java/current - 权限受限用户可把 JDK 解压到自己家目录下（如 ~/jdk-11），完全私有，不依赖系统路径
临时切换与脚本化场景
调试、CI 脚本或一键部署时，不写入配置文件更安全，也便于版本快速轮换。
立即学习“Java免费学习笔记（深入）”；
- 当前终端临时设置：
export JAVA_HOME=/home/alice/jdk-11.0.20 && java -version - 单次运行应用时指定：
JAVA_HOME=/home/bob/jdk-21.0.1 java -jar app.jar - 注意：这类设置只对当前 Shell 及其子进程有效，关闭终端即失效
systemd 用户服务需额外处理
如果你用 systemctl --user start myapp 启动 Java 服务，它不会读 .bashrc，必须把环境变量写进 ~/.profile 或服务单元文件中。
- 在 ~/.profile 末尾添加同上的
export JAVA_HOME=...行 - 或在 service 文件中显式声明：
[Service]<br>Environment="JAVA_HOME=/home/user/jdk-17"<br>ExecStart=/home/user/jdk-17/bin/java -jar app.jar
