Java环境变量配置失败主因是未明确终端/Shell/IDE场景，JAVA_HOME须指向JDK根目录（非bin），PATH仅添加其bin子目录，并需按平台正确重载配置。
Java环境变量配不成功，大概率不是步骤错了，而是没搞清你当前用的是什么终端、什么Shell、什么IDE，更关键的是——JAVA_HOME 和 PATH 的顺序与写法在不同场景下根本不通用。
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
查CSDN教程前先确认你的实际使用场景
CSDN上搜“Java环境变量配置”的文章超万篇，但90%默认按 Windows + CMD 场景写，而你可能正用：
• macOS 或 Linux（zsh 或 bash）
• Windows 11 + PowerShell 或 Windows Terminal
• VS Code 终端（它可能不读系统环境变量）
• IntelliJ IDEA（它自带 JDK 管理，改系统变量根本没用）
不先锁死场景，直接照图文填路径，十有八九 java -version 仍报错或显示旧版本。
JAVA_HOME 必须指向 JDK 根目录，不是 bin 子目录
这是最常踩的坑：把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17.0.1\bin —— 错。bin 是可执行文件夹，JDK 根目录是它的上一级。正确写法：
• Windows：C:\Program Files\Java\jdk-17.0.1
• macOS：/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home
• Linux：/usr/lib/jvm/java-17-openjdk-amd64（路径因发行版和安装方式而异）
验证是否设对：在终端运行 echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows），输出必须是完整根路径，且该路径下存在 bin、lib、jre 等子目录。
PATH 中只加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）
别把整个 JDK 路径塞进 PATH，也别重复添加多个 JDK 的 bin。PATH 只负责让系统找到 java、javac 这些命令。常见错误：
• Windows 用户在 PATH 里写了 C:\Program Files\Java\jdk-17.0.1\bin，但 JAVA_HOME 指向错误，导致后续工具（如 Maven）无法识别 JDK
• macOS 用户在 ~/.zshrc 里写 export PATH="/opt/homebrew/bin:$PATH" 却忘了把 $JAVA_HOME/bin 加到最前面，结果系统优先用了 Homebrew 装的老版 OpenJDK
• 所有平台用户改完环境变量后没重开终端，或没执行 source ~/.zshrc（macOS/Linux）、没重启 CMD/PowerShell（Windows）
CSDN 教程搜索技巧：加限定词过滤无效内容
直接搜“java 环境变量”得到的多是过时图文（比如还在教怎么右键“我的电脑”→“属性”）。有效搜法：
• 在 CSDN 搜索框输入：java 环境变量 windows 11 powershell
• 或：java 环境变量 macos zsh jdk 17
• 或：intellij java home 不生效
这样能筛掉大量面向 Windows 7 + CMD 的陈旧帖。注意看发布时间（优先选近半年内）、评论区有没有人反馈“Win11 不行”或“M1 Mac 报错”，那是真实踩坑信号。
真正卡住的地方往往不在配置本身，而在哪个进程读了哪份变量、谁覆盖了谁、IDE 启动时用的是系统 shell 还是内置终端。别迷信一键脚本，先用 which java、java -XshowSettings:properties -version 看它到底加载了哪个 JDK。
