macos 上安装 intellij idea 并完成基础配置的关键三步是选对版本、配好 jdk、授权系统权限：社区版免费够用，m1/m2 芯片须用 apple silicon 原生版本，jdk 至少 17 且为 arm64 架构，并需在系统设置中授予全盘访问和辅助功能权限。
macos 上安装 intellij idea 并完成基础配置，关键在选对版本、配好 jdk、授权系统权限这三步。社区版免费够用，m1/m2 芯片必须用 apple silicon 原生版本，jdk 至少 17，且要 arm64 架构。
确认 Mac 硬件与系统环境
打开终端，依次执行：
- sw_vers —— 查看 macOS 版本，需 ≥ 11.0（Big Sur）
- uname -m —— 显示 arm64 表示 M1/M2/M3；x86_64 表示 Intel
- sysctl hw.memsize —— 检查内存，低于 4 GB 会明显卡顿，推荐 16 GB+
- df -h ~ —— 确保用户目录下有至少 10 GB 可用空间（含缓存、插件、索引）
下载并安装 IDEA（推荐 Community 版）
访问 jetbrains.com/idea/download，按芯片类型选择：
- Apple Silicon（M 系列）→ 下载 Universal 或 Apple Silicon 版本 DMG
- Intel → 下载 Intel 版本 DMG
双击打开 DMG 文件，将 IntelliJ IDEA.app 拖入 /Applications 文件夹。首次启动时，系统可能提示“无法验证开发者”，右键点击应用 → “打开”即可绕过 Gatekeeper。
配置 JDK 17+（必须 ARM64 架构）
IDEA 2023.3+ 内置 JetBrains Runtime（基于 OpenJDK 17），但项目编译和运行仍需外部 JDK。推荐用 Homebrew 安装：
- 终端运行：brew install openjdk@21（LTS 最新版，ARM64 原生）
- 验证：/opt/homebrew/opt/openjdk@21/bin/java -version
- 设置全局
JAVA_HOME：
在 ~/.zshrc 中添加：
export JAVA_HOME=$(/opt/homebrew/opt/openjdk@21/bin/java_home)
然后运行 source ~/.zshrc
启动 IDEA 后，在新建项目或 File → Project Structure → SDKs 中，点击 “+” → “JDK”，指向：
/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk
授予必要系统权限
macOS 会默认限制部分功能，需手动放行：
- 前往 系统设置 → 隐私与安全性 → 全盘访问，点击锁图标解锁，拖入 IntelliJ IDEA.app
- 同页面下拉至 辅助功能，同样添加 IDEA
- 如使用调试器、代码补全或自动导入，缺任一权限都可能导致功能静默失效
基础使用优化建议
- 首次启动进入向导时，勾选 “Create desktop entry” 和 “Update PATH”（方便终端直接运行
idea命令） - 主题推荐 Darcula（暗色护眼），字体设为 JetBrains Mono（IDEA 自带，等宽清晰）
- Maven/Gradle 可后续通过 Settings → Build Tools 关联，Homebrew 安装的 Maven 默认路径为 /opt/homebrew/bin/mvn
- 常用快捷键：双击 Shift 全局搜索、Cmd + ; 打开设置、Cmd + Shift + A 查找任意操作
