macOS安装IntelliJ IDEA需按五步操作:一、官网下载匹配芯片的.dmg并拖入Applications,首次右键打开;二、卸载旧版并清除~/Library中JetBrains相关配置;三、启动后新建Java项目时下载或指定JDK 17;四、通过Plugins安装中文语言包、GitToolBox和Lombok;五、在Preferences中设置JetBrains Mono字体、UTF-8编码及含作者日期的Class模板。

如果您在 macOS 系统上准备安装 IntelliJ IDEA,但不确定从何处开始或遇到拖拽失败、启动报错、JDK 未识别等问题,则可能是由于安装路径不规范、残留配置干扰或 Java 环境未就绪。以下是解决此问题的步骤:
一、官网下载与基础安装
该方法适用于所有 macOS 版本(Intel 或 Apple Silicon),通过官方分发的 .dmg 安装包完成标准部署,确保签名验证通过且路径符合系统规范。
1、访问 https://www.jetbrains.com/idea/download/#section=mac,根据芯片类型选择对应版本:Apple Silicon(M1/M2/M3)选 macOS (Apple Silicon),Intel 芯片选 macOS (Intel)。
2、下载完成后,双击打开 .dmg 文件,将 IntelliJ IDEA 图标拖入 Applications 文件夹中。
3、前往 应用程序 文件夹,右键点击 IntelliJ IDEA,选择“打开”以绕过 macOS 的“已损坏”安全提示(首次运行必需)。
4、弹出许可协议时点击“Continue”,随后选择“Skip All and Configure Later”跳过初始向导,进入主界面。
二、彻底卸载旧版本并清除残留
若曾安装过旧版 IDEA 或出现启动闪退、配置异常、插件失效等情况,必须清除全部用户级配置目录,否则新版本可能继承错误状态导致功能异常。
1、关闭所有 IDEA 实例,在 Finder 中按 Shift + Command + G,依次输入以下路径并删除对应文件夹(如存在):
~/Library/Application Support/JetBrains/IntelliJIdea*
~/Library/Caches/JetBrains/IntelliJIdea*
~/Library/Logs/JetBrains/IntelliJIdea*
~/Library/Preferences/JetBrains/IntelliJIdea*
2、前往 应用程序 文件夹,将旧版 IDEA.app 拖入废纸篓。
3、清空废纸篓,并重启 Mac 确保进程与缓存完全释放。
三、配置 JDK 运行环境
IntelliJ IDEA 启动依赖有效 JDK,即使其自带 JBR(JetBrains Runtime),项目编译仍需显式指定 SDK;若未配置,新建项目时将提示 “No JDK specified” 或无法识别 java 命令。
1、启动 IDEA 后,点击 New Project,在左侧面板选择 Java。
2、在右侧 “Project SDK” 下拉框中,若显示 No SDK,点击右侧 New... → Download JDK。
3、选择版本(推荐 Temurin 17 或 Corretto 17),点击 “Download”,等待自动完成并勾选为默认 SDK。
4、也可手动指定本地 JDK:点击 Add JDK...,导航至 /Library/Java/JavaVirtualMachines/,选择含 jdk-xx.jdk 的文件夹。
四、安装中文语言包与基础插件
IDEA 默认英文界面,对中文用户存在理解门槛;同时部分开发功能(如 Git 提示、代码补全增强)需依赖插件支持,应在初始化阶段即完成安装以避免后续项目异常。
1、启动后点击顶部菜单栏 Configure → Plugins。
2、在 Marketplace 搜索框中输入 Chinese Language Pack,点击安装并重启 IDE。
3、再次进入 Plugins,搜索 GitToolBox 和 Lombok(如需),勾选启用。
4、重启后,界面即切换为中文,Git 相关操作将显示中文提示,且 Lombok 注解可被正确解析。
五、设置全局编辑器与项目模板
统一字体、编码和模板可避免跨项目协作时出现乱码、缩进不一致或新建类结构缺失等问题,属于开发环境标准化的关键环节。
1、点击 IntelliJ IDEA → Preferences(或使用快捷键 Command + ,)。
2、展开 Editor → Font,字体设为 JetBrains Mono,字号设为 14,启用 Ligatures。
3、进入 Editor → File Encodings,将 Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8。
4、进入 Editor → File and Code Templates → Files,编辑 Class 模板,在开头添加:
/**
* @author ${USER}
* @date ${DATE}
*/










