跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Javajava

JDK 安装与环境配置实战指南

JDK 安装与环境配置是 Java 开发的基础环节。内容涵盖版本选择策略、OpenJDK 与 Oracle JDK 下载渠道对比,以及 Windows、macOS、Linux 三大系统的详细配置步骤。重点解析 JAVA_HOME 与 Path 变量设置,提供常见报错排查方案,帮助开发者快速搭建稳定的本地开发环境,避免重复踩坑。

霸天发布于 2026/3/28更新于 2026/9/852 浏览
JDK 安装与环境配置实战指南

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 逻辑类似。

  1. 设置 JAVA_HOME:右键'此电脑'->'属性'->'高级系统设置'->'环境变量'。在'系统变量'中新建变量名 JAVA_HOME,变量值为 JDK 安装路径(例如 C:\Program Files\Java\jdk-17)。
  2. 配置 Path:在'系统变量'中找到 Path,编辑并新建条目 %JAVA_HOME%\bin。这一步至关重要,否则命令行无法调用 java 或 javac。
  3. 验证配置:打开终端(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 中做同样配置。

四、常见问题排查

  • 报错'不是内部或外部命令':检查 Path 是否包含 %JAVA_HOME%\bin,确保没有多余空格或拼写错误。
  • 版本不匹配:确认系统中存在多个 JDK 版本时,调整 Path 中 JDK bin 目录的顺序,将目标版本置于首位。
  • 权限问题:修改环境变量可能需要管理员权限,请确保以管理员身份运行终端或编辑器。

环境配置完成后,即可开始编写第一个 Hello World 程序。保持耐心,细节决定成败。

目录

  1. 一、前期准备:JDK 版本选择
  2. 二、JDK 下载
  3. 1. 推荐下载渠道
  4. 2. 备选下载渠道(Oracle JDK)
  5. 三、环境配置
  6. 四、常见问题排查

更多推荐文章

查看全部
  • Spring Cloud Nacos 服务注册与配置中心实战
  • 使用 Python 和 PyQt6 开发简易记事本
  • Llama-Factory 训练进度条卡死排查与优化指南
  • 网络安全行业人才缺口与薪资水平深度解析
  • 5 个适用于生活与工作的 Python 自动化项目
  • Python + Bright Data MCP 实时抓取 Google 搜索结果实战
  • C++ 技术面试常见问题解析(三)
  • 机器人架构搭建核心准则:先论文论证,后工程落地
  • Fooocus 部署实践:本地手动配置与云平台一键启用对比
  • GLM-4.5-Air-Base 开源:1060 亿参数智能推理模型免费商用
  • Meta:BackTranslation 与 IBM Self Alignment 技术解析
  • Llama Factory 微调:如何选择最佳超参数
  • 硕士论文盲审前如何降低 AI 检测率及评委关注点分析
  • OpenClaw 配置飞书机器人教程
  • ComfyUI-Manager 插件管理工具使用指南
  • LLM 训练微调实战:基于 LLaMA-Factory 框架详解
  • AI 辅助 9·1 软件安装:环境检测与问题修复方案
  • 前端微前端架构实践:避免巨石应用陷阱
  • AIGC 背景下图文内容社区数据指标体系构建指南
  • Vue3 ElementUI TypeScript 设置 style 属性类型检查失败解决方案

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online