【2025 年最新版】Java JDK 安装与环境配置教程(附图文超详细,Windows+macOS 通用)

【2025 年最新版】Java JDK 安装与环境配置教程(附图文超详细,Windows+macOS 通用)

        Java 作为后端开发的核心语言,JDK(Java Development Kit)是开发和运行 Java 程序的基础环境。2025 年最新推荐安装JDK 21—— 这是 Java SE 平台的长期支持(LTS)版本,可免费用于生产环境及重新分发,直到 2026 年 9 月仍能享受免费更新服务,后续更新将按 Oracle OTN 许可证管理。本文将针对 Windows(10/11)和 macOS(Intel/M 芯片)两大主流系统,提供从官方下载、分步安装到环境变量配置的完整教程,附带验证步骤和常见问题排查,零基础也能轻松上手!

一、JDK 21 核心优势(为什么选它?)

  1. 长期支持更稳定:作为 LTS 版本,JDK 21 提供更长的技术支持周期,兼容性更强,适合开发、测试及生产环境使用。
  2. 免费商用权益:根据 Oracle 无费用条款(NFTC),JDK 21 二进制文件可免费用于生产场景,无需额外付费授权。
  3. 性能与功能升级:优化了垃圾回收机制、增强了并发处理能力,同时兼容主流开发工具(IntelliJ IDEA、Eclipse 等)。
  4. 跨平台适配:支持 Windows、macOS、Linux 等多种操作系统,满足不同开发环境需求。

二、前期准备:确认系统版本

安装前需明确电脑操作系统及硬件架构,避免下载错误版本:

  • Windows 系统:右键 “此电脑”→“属性”,查看系统类型(64 位 / 32 位,目前主流为 64 位)。
  • macOS 系统:点击桌面左上角 “苹果图标”→“关于本机”,查看芯片类型(Intel 芯片 / M 系列芯片,如 M1、M2、M3)。

三、官方下载 JDK 21(安全无捆绑)

1. 访问 Oracle 官方下载地址

打开浏览器,输入官方下载链接:Java Downloads | Oracle(建议直接访问官网,避免第三方镜像站的捆绑软件)。

选择适合 JDK 版本,本文选择JDK 23在Windows x64环境下安装 x64 Installer。

选择建议:

普通用户:选择 x64 Installer,简便、快速。
开发者或需要灵活控制安装位置的用户:选择 x64 Compressed Archive,需要手动设置环境变量。
IT 管理员或批量部署:选择 x64 MSI Installer,适合批量安装和企业环境。

2. 选择对应系统版本下载(这里以jdk21)

  • 步骤 1:页面下拉找到 “Java 21” 相关下载区域,点击 “JDK Download” 进入下载页面。

  • 步骤 2:根据操作系统选择对应版本:
    • Windows 系统:切换到 “Windows” 选项卡,点击 “x64 Installer”(exe 格式,约 200MB),适合 64 位 Windows 10/11。
  • macOS 系统:切换到 “macOS” 选项卡,Intel 芯片选择 “x64 Installer”(dmg 格式),M 系列芯片选择 “arm64 Installer”(dmg 格式)。
  • 步骤 3:下载前需勾选 “Accept License Agreement”(接受许可协议),然后点击下载链接。
  • 步骤 4:若未登录 Oracle 账号,会提示登录或注册。无需复杂操作,可使用邮箱快速注册,或选择 “跳过登录”(部分地区支持直接下载)。

3. 下载完成验证

下载后找到安装包(默认在 “下载” 文件夹):

  • Windows:文件名为 “jdk-21_windows-x64_bin.exe”
  • macOS:文件名为 “jdk-21_macos-x64_bin.dmg”(Intel 芯片)或 “jdk-21_macos-aarch64_bin.dmg”(M 芯片)

四、Windows 10/11 系统:JDK 安装与配置

1. 分步安装 JDK 21

  1. 双击下载的 exe 安装包,弹出安装向导,点击 “下一步”。

2.选择安装目录(建议默认路径,如 “D:\App\JDK\jdk-21”,便于后续配置;若需自定义路径,需记住安装位置,避免中文路径)。

3. 勾选 “开发工具”(必须勾选,包含 javac 编译器、java 运行器等核心工具),其他组件默认即可,点击 “下一步”。

4.等待安装进度条完成(约 1-2 分钟),点击 “关闭”,安装完成。

2. 环境变量配置(关键步骤)

环境变量的作用是让 Windows 系统在任意目录下识别 Java 命令(如 javac、java),配置步骤如下:

(1)打开环境变量配置窗口
  • 方法 1:右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”。

  • 方法 2:按下 Win+R,输入 “sysdm.cpl”,回车→切换到 “高级” 选项卡→“环境变量”。
(2)配置系统变量(3 个核心变量)
① 新建 “JAVA_HOME” 变量
  • 在 “系统变量” 区域点击 “新建”。
  • 变量名:JAVA_HOME(大写,固定写法)。
  • 变量值:JDK 的安装目录(如默认路径 “C:\Program Files\Java\jdk-21”,需与实际安装路径一致)。
  • 点击 “确定” 保存。
② 配置 “Path” 变量
  • 在 “系统变量” 中找到 “Path”,双击打开编辑窗口。
  • 点击 “新建”,输入%JAVA_HOME%\bin(引用 JAVA_HOME 变量,避免后续修改路径重复配置)。
  • (可选)再点击 “新建”,输入%JAVA_HOME%\jre\bin(JRE 运行环境路径,部分版本需手动添加)。
  • 点击 “上移”,将两个新建的路径移到顶部,避免与其他环境变量冲突,点击 “确定”。
③ (可选)新建 “CLASSPATH” 变量(可选,部分老项目需要)
  • 在 “系统变量” 区域点击 “新建”。
  • 变量名:CLASSPATH
  • 变量值:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar(注意开头的英文句号,代表当前目录)。
  • 点击 “确定” 保存。
(3)保存所有配置

依次点击环境变量窗口和系统属性窗口的 “确定”,确保配置生效。

3. 安装与配置验证

  1. 按下 Win+R,输入 “cmd”,打开命令提示符(CMD)。
  2. 依次输入以下 3 条命令,若均显示正常信息,则说明安装配置成功:
    • 查看 JDK 版本:java -version(显示 “java version "21.0.x"” 等信息)。
    • 查看编译器版本:javac -version(显示 “javac 21.0.x” 等信息)。

出现这个说明安装成功

五、macOS 系统:JDK 安装与配置

1. 分步安装 JDK 21

  1. 双击下载的 dmg 安装包,弹出挂载窗口,双击里面的 “JDK 21.pkg” 安装程序。
  2. 弹出安装向导,点击 “继续”→“同意” 许可协议→选择安装位置(默认即可)→输入电脑开机密码,点击 “安装”。
  3. 等待安装完成(约 1 分钟),点击 “关闭”,安装包可拖拽到废纸篓删除。

2. 环境变量配置(分终端类型)

macOS 默认使用 zsh 终端(macOS 10.15 及以上),部分老版本使用 bash 终端,需根据终端类型配置:

(1)查看终端类型

打开 “终端”(启动台→其他→终端),输入echo $SHELL

  • 输出 “/bin/zsh”:zsh 终端(主流)。
  • 输出 “/bin/bash”:bash 终端。
(2)配置环境变量
① zsh 终端(推荐)
  1. 终端输入命令,编辑 zsh 配置文件:open ~/.zshrc(若文件不存在,先创建:touch ~/.zshrc)。
  2. 保存文件并关闭,终端输入命令使配置生效:source ~/.zshrc

在打开的文本文件中,添加以下 3 行内容(JDK 默认安装路径为 “/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home”,无需修改):plaintext

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar 
② bash 终端
  1. 终端输入命令,编辑 bash 配置文件:open ~/.bash_profile(若文件不存在,先创建:touch ~/.bash_profile)。
  2. 添加与 zsh 终端相同的 3 行配置内容。
  3. 保存文件并关闭,终端输入命令使配置生效:source ~/.bash_profile

3. 安装与配置验证

  1. 终端中依次输入以下命令,显示正常信息则配置成功:
    • 查看 JDK 版本:java -version(显示 “java version "21.0.x"”)。
    • 查看编译器版本:javac -version(显示 “javac 21.0.x”)。
    • 查看 JAVA_HOME 路径:echo $JAVA_HOME(显示默认安装路径)。

六、JDK 安装目录解析(了解核心文件夹)

安装完成后,可打开 JDK 安装目录,了解核心文件夹功能,便于后续问题排查:

  • bin:存放核心可执行文件,如 javac(编译器)、java(运行器)、jar(打包工具)等。
  • jre:Java 运行环境,包含运行 Java 程序所需的虚拟机和核心类库。
  • lib:存放 Java 类库文件(.jar 格式),如 tools.jar、dt.jar 等。
  • include:存放 C 语言头文件,用于 Java 与 C/C++ 混合开发。
  • db:内置的 Derby 数据库,适合小型项目或测试使用。
  • src.zip:Java 核心类库的源代码压缩包,便于学习源码。

七、常见问题排查(避坑指南)

1. 命令提示符输入 “javac” 提示 “不是内部或外部命令”

  • 原因:环境变量配置错误,或未保存生效。
  • 解决:重新检查 JAVA_HOME 路径是否正确,Path 变量是否添加 “% JAVA_HOME%\bin”,配置后关闭 CMD 重新打开。

2. 安装时提示 “权限不足”

  • 原因:Windows 系统未以管理员身份运行安装包,macOS 未输入正确开机密码。
  • 解决:Windows 右键安装包→“以管理员身份运行”;macOS 确认开机密码输入正确,且有系统安装权限。

3. 下载 JDK 时速度缓慢

  • 解决:更换网络(如手机热点),或等待非高峰时段下载;避免使用第三方下载工具,直接通过 Oracle 官网下载更稳定。

4. macOS 配置后终端仍无法识别 Java 命令

  • 原因:配置文件未生效,或终端类型判断错误。
  • 解决:重新执行 “source ~/.zshrc”(zsh 终端)或 “source ~/.bash_profile”(bash 终端),或重启终端。

八、总结

        JDK 21 作为 2025 年推荐的长期支持版本,兼顾稳定性和免费商用权益,是 Java 开发的首选环境。本文通过 “下载→安装→配置→验证” 四步流程,详细覆盖 Windows 和 macOS 两大系统的操作细节,每一步都附带关键提示,避免新手踩坑。

        配置完成后,即可开启 Java 开发之旅 —— 无论是编写第一个 “Hello World” 程序,还是使用 IntelliJ IDEA 等工具开发项目,都能正常运行。如果后续需要升级 JDK,只需卸载旧版本,重复本文流程安装新版本,并更新 JAVA_HOME 路径即可。

Read more

【代码管理】在本地使用github和gitee之后,可能存在冲突,导致再次提交代码时提示Couldn‘t connect to server

【代码管理】在本地使用github和gitee之后,可能存在冲突,导致再次提交代码时提示Couldn‘t connect to server

大家好,我是全栈小5,欢迎来到《小5讲堂》。 这是《源代码管理工具》系列文章,每篇文章将以博主理解的角度展开讲解。 温馨提示:博主能力有限,理解水平有限,若有不对之处望指正! 目录 * 前言 * 错误提示 * 解决方案 * 方案1:临时关闭 Git 的代理设置(推荐先尝试) * 方案2:检查并启动代理服务 * 方案3:直接使用命令行取消代理后克隆 * 方案4:检查环境变量 * 针对 Windows 系统的具体操作 * 方法1:使用 Git Bash 或命令提示符 * 方法2:检查全局 Git 配置 * 验证解决方案 * 如果您确实需要代理 * 为什么会冲突 * 1. 代理配置冲突 * 问题原因: * 典型症状: * 2. 认证信息冲突 * SSH 密钥冲突:

By Ne0inhk

【GitHub项目推荐--OpenAkita:自我进化的开源AI助手框架】⭐⭐⭐

简介 OpenAkita 是一个开源的自我进化AI助手框架,由OpenAkita团队开发并维护。该项目以其独特的“永不放弃”的设计理念而闻名——正如其名所寓意的秋田犬一样,忠诚、可靠且持续学习。与其他AI助手不同,OpenAkita在用户关闭聊天后不会忘记一切,而是能够自主学习新技能、修复自身错误,并记住用户的所有信息。框架支持3分钟快速设置,仅需一个API密钥即可启动,提供8种预设人格、6种即时通讯平台集成,甚至具备发送表情包的能力,为AI助手注入了独特的“灵魂”。 核心价值: * 自我进化:AI助手在用户睡眠时自主学习、记忆巩固和错误修复 * 人格化体验:8种预设人格(女友、管家、Jarvis等)提供沉浸式交互 * 极简部署:桌面应用程序实现3分钟从安装到对话的完整流程 * 开放生态:基于Agent Skills和MCP开放标准,支持一键技能安装 技术定位:OpenAkita填补了传统静态AI助手与动态学习系统之间的空白。它不仅仅是一个对话工具,更是一个能够随时间推移而不断进化的智能伙伴。通过将记忆管理、自我检查和技能生成等能力内置到框架核心,它为开发者提供了一个构

By Ne0inhk

3步实现GitHub全界面中文化 GitHub中文插件完全指南

3步实现GitHub全界面中文化 GitHub中文插件完全指南 【免费下载链接】github-chineseGitHub 汉化插件,GitHub 中文化界面。 (GitHub Translation To Chinese) 项目地址: https://gitcode.com/gh_mirrors/gi/github-chinese GitHub作为全球最大的代码托管平台,其英文界面常成为中文开发者的使用障碍。GitHub中文插件(GitHub Translation To Chinese)通过本地化技术,可将GitHub界面元素一键转换为中文,保留原有功能的同时降低使用门槛。本文将系统介绍这款开源工具的安装配置、核心功能及高级应用技巧,帮助开发者快速构建中文开发环境。 解析GitHub中文插件的核心价值 GitHub中文插件采用轻量级用户脚本架构,通过三大核心优势解决英文界面痛点: 无缝集成的本地化体验 插件在不改变GitHub原有功能布局的前提下,将界面文本替换为精准的中文表述。从导航菜单到按钮文本,从提示信息到帮助文档,实现全界面无死角中文化。这种非侵入式设计确保用户

By Ne0inhk
OpenCode 免费使用 Kimi K2.5 完整指南:国产最强开源模型零成本体验

OpenCode 免费使用 Kimi K2.5 完整指南:国产最强开源模型零成本体验

什么是 Kimi K2.5? Kimi K2.5 是月之暗面 (Moonshot AI) 于 2026 年 1 月发布的开源多模态大模型,总参数量达 1 万亿,激活参数 320 亿,在多项基准测试中超越 Claude Opus 4.5,尤其在编程和 Agent 任务上表现卓越。 OpenCode 作为最热门的开源 AI 编程助手,现已正式支持 Kimi K2.5。更令人兴奋的是,通过多种渠道,你可以限时免费体验这款国产最强开源模型。本文将详细介绍配置方法和使用技巧。 为什么选择 Kimi K2.5? 在深入配置之前,先了解 Kimi K2.5

By Ne0inhk