Java 开发始于环境搭建。很多新手在'JDK 安装'和'环境配置'上卡壳,常遇到'javac 不是内部或外部命令'或版本不匹配的问题。本文将梳理从版本选择、下载到多系统环境配置的全流程,帮助一次性搞定基础设置。
明确概念是避免踩坑的前提。常说的 JDK(Java Development Kit)是核心工具包,包含编译器(javac)、运行环境(JRE)和调试工具。若需编写代码或开发项目,必须安装 JDK;单纯运行程序才只需 JRE。
一、前期准备:JDK 版本选择
新手纠结版本时,核心原则是优先选择 LTS 长期支持版。这类版本稳定性强、兼容性好,后续学习和开发不易出问题。
目前主流推荐版本包括:JDK 17(最常用,免费开源,支持所有主流开发工具)、JDK 21(最新 LTS,功能更全)、JDK 8(经典版本,老项目仍在使用)。建议新手直接选用 JDK 17,兼顾新特性和兼容性,避免选择非 LTS 版本(如 JDK 24、26),这类版本更新快、支持周期短,不适合长期学习。
另外注意区分 JDK 类型。新手优先选 OpenJDK(开源免费,无商业授权风险),推荐从 Eclipse Adoptium 官网下载,速度快且操作简单;Oracle JDK 个人学习可免费使用,但商业用途需购买授权,且下载注册流程较繁琐。
二、JDK 下载
以 OpenJDK 17(LTS)为例演示下载步骤,其他版本操作一致,全程免费无需注册。
1. 推荐下载渠道
首选 Eclipse Adoptium Temurin。该站点开源免费,支持多平台,通过 TCK 认证,性能稳定。
操作步骤如下:
- 打开官网后,在'Version'下拉框选择'17'(LTS);
- 'Operating System'选择当前系统(Windows/macOS/Linux);
- 'Architecture'选择对应架构(主流电脑均为 64 位,Windows 选 x64,Mac 根据芯片选 aarch64(M 系列)或 x64(Intel));
- 'Installer Type'选择安装包格式(Windows 选 MSI,Mac 选 PKG,Linux 选 DEB/RPM,图形化安装更简单);
- 点击'Download'等待完成。若官网下载慢,可使用华为云镜像或清华镜像站加速,搜索'OpenJDK 17 镜像'即可找到链接。
2. 备选下载渠道(Oracle JDK)
若需 Oracle JDK,请访问 Oracle 官方下载页面。需注意 Oracle JDK 的许可协议变化,个人学习通常允许免费使用,但企业商用需确认授权范围。下载前建议阅读相关 License 条款,避免合规风险。
三、环境配置
下载完成后,需配置环境变量以便系统识别 Java 命令。以下以 Windows 为例,macOS 和 Linux 逻辑类似。
- 设置 JAVA_HOME:右键'此电脑'->'属性'->'高级系统设置'->'环境变量'。在'系统变量'中新建变量名
JAVA_HOME,变量值为 JDK 安装路径(例如C:\Program Files\Java\jdk-17)。 - 配置 Path:在'系统变量'中找到
Path,编辑并新建条目%JAVA_HOME%\bin。这一步至关重要,否则命令行无法调用java或javac。 - 验证配置:打开终端(CMD 或 PowerShell),输入
java -version和javac -version。若显示版本号信息,说明配置成功。
对于 macOS 用户,可通过 Homebrew 快速安装 (brew install openjdk@17),随后在 ~/.zshrc 或 ~/.bash_profile 中添加 export PATH="$JAVA_HOME/bin:$PATH"。Linux 用户则需在 /etc/profile 或 ~/.bashrc 中做同样配置。
四、常见问题排查
- 报错'不是内部或外部命令':检查 是否包含 ,确保没有多余空格或拼写错误。


