MacBook 2025 M4 笔记本 JetBrains IDEA 全家桶最正规安装教程#

1）明确你装的是“Toolbox + 多个 IDE”，不是只装 IntelliJ IDEA#

JetBrains 官方产品页列出了 IntelliJ IDEA、WebStorm、PyCharm、GoLand、PhpStorm、DataGrip、CLion、Rider 等多种 IDE；如果你说的是“IDEA 全家桶”，最规范的理解不是一次性胡乱装满，而是先装 Toolbox，再按你的技术栈安装对应 IDE。(jetbrains.com)

2）准备 JetBrains 账号#

IntelliJ IDEA 等产品可以通过 JetBrains Account 登录并拉取你已购买的许可证；JetBrains 也提供 All Products Pack 这类全家桶订阅。如果你用的是预览版 EAP，官方说明它随附 30 天许可并需要登录 JetBrains Account 启用。(jetbrains.com)

如果你只是个人非商业用途，JetBrains 目前对部分 IDE 提供 non-commercial 许可，但覆盖范围不是全部产品，所以不要想当然地把所有 IDE 都当成“默认免费”。购买或激活前，最好按你实际会用到的 IDE 核对官网许可说明。(JetBrains 销售)

3）确定你要用稳定版还是预览版#

正式开发环境优先装稳定版；只有在你明确要抢先体验新特性、接受潜在兼容性波动时才装 EAP。Toolbox 支持查看 Available versions，也支持保留旧版本用于回滚，这正是它比手动逐个安装更正规的地方。(jetbrains.com)

第一步：下载 Apple Silicon 版 JetBrains Toolbox#

进入 JetBrains 官方 Toolbox 页面，下载 macOS 对应的 .dmg。官方安装文档明确说明，Intel 和 Apple Silicon 是分开的磁盘映像；你的机器是 M4，所以应当下载 Apple Silicon 版，而不是 Intel 版。(jetbrains.com)

第二步：把 Toolbox 拖入 Applications#

挂载下载好的 .dmg 后，把 JetBrains Toolbox 拖到 Applications 文件夹。这一步就是 JetBrains 官方文档在 macOS 下给出的标准安装动作。(jetbrains.com)

第三步：首次打开 Toolbox#

打开 Applications → JetBrains Toolbox。如果 macOS 因安全策略拦截启动，先尝试正常打开一次；如果仍被阻止，按 Apple 官方方法进入 System Settings → Privacy & Security，在 Security 区域点击 Open Anyway，再输入登录密码确认。Apple 说明这个按钮在你首次尝试打开应用后的大约 1 小时内可用。(苹果支持)

第四步：登录 JetBrains Account#

Toolbox 本身不需要许可证，但你安装的具体 IDE 是否需要激活，取决于产品和许可类型。登录 JetBrains Account 的好处是：购买过的许可证能自动拉取；EAP、订阅型产品、同步设置等也都更顺手。IntelliJ IDEA 官方文档说明，登录后 IDE 会显示许可证列表，点击 Activate 即可启用。(jetbrains.com)

第五步：在 Toolbox 里安装你需要的 IDE#

打开 Toolbox 后，直接搜索并安装你需要的产品，例如：

• IntelliJ IDEA
• WebStorm
• PyCharm
• GoLand
• DataGrip
• PhpStorm
• CLion
• Rider

这些产品都在 JetBrains 官方产品体系中，且 Toolbox 是官方推荐的统一安装入口。(jetbrains.com)

第六步：需要指定版本时，不要手工找旧包#

如果你的项目绑定某个旧版 IDE，不要去第三方站点找安装包。JetBrains 官方文档给出的做法是在 Toolbox 的实例菜单里点 Available versions，然后安装你需要的版本。这样最干净，也最方便后续升级和回滚。(jetbrains.com)

1）先启用设置同步，不要再用过时的 Settings Repository#

JetBrains 现行文档已经把 Settings Repository 标记为 deprecated，并明确推荐使用 Backup and Sync / 设置备份与同步。它可以在不同 JetBrains IDE、不同机器之间同步你的配置、快捷键、主题和部分 IDE 设置。(jetbrains.com)

标准做法是：先在你的主力 IDE（通常是 IntelliJ IDEA）里完成一轮基础配置，再开启同步，这样后续 WebStorm、DataGrip、GoLand、PyCharm 的体验会更统一。关于是否“什么都同步”，建议只同步真正稳定且通用的配置，比如 keymap、theme、editor code style、plugins policy；项目级配置仍按项目独立管理。前半句关于跨 IDE 同步能力来自官方文档。(jetbrains.com)

2）配置命令行启动器#

如果你希望在终端里直接打开项目，Toolbox 支持设置 Shell scripts location。JetBrains 文档说明，Toolbox 默认会把 shell script 放到系统 PATH 中的目录，这样你就能从任意工作目录直接用脚本名启动 IDE。(jetbrains.com)

对 Mac 开发者来说，这一步很有用。配置好后，你就可以把“终端 → 打开项目 → 进入 IDE”这个动作做得非常顺手。常见做法是给主力 IDE 保留简单脚本名，并在有多个同产品版本时给脚本改名，JetBrains 也支持为单个实例修改脚本名。(jetbrains.com)

3）插件要克制，别一上来全装#

JetBrains 官方插件文档支持手动更新、自动更新、禁用和卸载插件，并明确说明不需要的插件可以禁用。对于新机器，最稳的做法不是一口气装一堆插件，而是先用官方内置能力，按项目需要逐步补。(jetbrains.com)

建议第一批只保留最核心的插件。所有“看起来很酷但暂时不需要”的插件都往后放。这个建议是经验结论；官方事实部分是插件可禁用、可卸载、可自动更新。(jetbrains.com)

4）Java 开发先把 Project SDK 配对好#

这一步对 IntelliJ IDEA 最重要。JetBrains 官方文档说明，添加 JDK 的标准入口是 File | Project Structure | Platform Settings | SDKs；项目级 SDK 在 Project Structure | Project 里设置；模块级 SDK 在 Project Structure | Modules 里设置。IDE 发现不了 JDK 时，可以手动 Add JDK from disk。(jetbrains.com)

如果你本机还没有合适的 JDK，也不用先去外面单独装。JetBrains 提供的官方指引说明，IDE 内可以直接 Download JDK，选择厂商、版本和安装路径完成下载；如果已经安装，只要把本地 JDK 目录加进去即可，典型路径示例是 /Library/Java/JavaVirtualMachines/...。(jetbrains.com)

对于 Java 开发者，要特别分清两件事：项目 JDK 和 IDE 自己运行用的 Boot Runtime 不是一回事。项目 JDK 影响你的编译、运行、测试；Boot Runtime 是 IDE 自己的运行时。大多数情况下，你只需要配项目 JDK，不要随意改 IDE 的 Boot Runtime。(jetbrains.com)

5）不要随便改 IDE 的 Boot Runtime#

JetBrains 文档允许你切换 IDE 自己的 Java runtime，也支持 Add Custom Runtime，但官方同时提醒：非默认 runtime 不会随 IDE 一起更新，升级后还可能出现兼容性问题；如果升级 IDE，最好回到默认 JetBrains Runtime。(jetbrains.com)

所以在 M4 MacBook 上，除非你遇到非常明确的兼容性问题，否则最正规的做法就是：项目 JDK 自己配，IDE Runtime 维持默认。这能把升级风险降到最低。前半句来自官方，后半句是基于官方行为约束给出的操作建议。(jetbrains.com)

1）IntelliJ IDEA#

IntelliJ IDEA 的核心是先把项目 JDK 配对好；需要时通过 IDE 直接下载 JDK。(jetbrains.com)

2）WebStorm#

WebStorm 并不是“装完就能跑所有前端项目”，它需要 Node.js runtime。官方文档说明：如果标准方式安装了 Node.js，WebStorm 通常会自动检测；如果没有检测到，可以到 Settings → Languages & Frameworks → JavaScript Runtime 手动配置本地 Node.js runtime，也可以直接把系统 node 设为项目默认 runtime。(jetbrains.com)

3）PyCharm#

PyCharm 的核心不是“装 IDE”，而是“给项目指定 Python interpreter”。官方文档说明，在创建新项目时就需要指定解释器；也可以进入 Python | Interpreter 修改、添加本地解释器，或者直接创建 virtualenv。(jetbrains.com)

4）GoLand#

GoLand 需要配置 Go SDK。官方文档说明，GOROOT 决定项目使用哪个 Go SDK；你可以直接在 IDE 里下载 Go SDK，也可以指向本地安装；GOPATH 则可以按全局、项目或模块粒度分别设置。(jetbrains.com)

5）PhpStorm#

PhpStorm 需要本机已有 PHP engine。官方文档说明，在配置本地 PHP interpreter 之前，要先确保本机已经安装 PHP；随后在 PhpStorm 里配置本地或远程 interpreter。(jetbrains.com)

6）DataGrip#

DataGrip 是数据库客户端，不是数据库服务器。官方文档说明，它连接数据库时需要 host、port、password、SSH 等连接信息，并把这些信息保存在 data source 中；无论连本地数据库还是远程数据库，前提都是数据库服务本身已经可用。(jetbrains.com)

7）Rider#

Rider 会自动检测 .NET CLI 路径，但在非标准环境下也允许你手动指定；JetBrains Rider 文档中的 Toolset and Build 页面还列出了 macOS 上的 Mono executable path 配置项。也就是说，Rider 安装完后，你还应检查一下 .NET CLI executable path 是否被正确识别。(jetbrains.com)

8）CLion#

CLion 的关键不是“装 IDE 完成”，而是“toolchain 配好没有”。JetBrains 文档说明，CLion 的 toolchain 包含 CMake、build tool、C/C++ compiler、debugger 和工作环境；在 macOS 上通常选 System 本地 toolchain，必要时切换自定义 CMake、编译器、LLDB/GDB。(jetbrains.com)

1）升级：优先走 Toolbox#

Toolbox 的价值不只是安装，还包括统一升级、自动更新、降级和回滚。官方产品页和 FAQ 都明确提到它支持 update、rollback/downgrade，并且可以保留已安装的旧版本用于快速回滚。(jetbrains.com)

2）卸载：不要直接乱删#

如果某个 IDE 是通过 Toolbox 安装的，JetBrains 官方给出的正规卸载方式是在 Toolbox 里点对应实例的工具菜单，然后选 Uninstall。直接手工删应用本体不是官方推荐的清理路径。(jetbrains.com)

3）多版本共存：允许，但要有规则#

JetBrains 的安装文档和 CLion 文档都说明可以同时保留多个版本实例，包括 release 和 EAP。更稳的做法是：稳定版做生产，EAP 单独做测试；同类 IDE 多实例时，把 shell script 名称改清楚，避免命令行调用混乱。(jetbrains.com)

坑 1：M4 机器装了 Intel 版#

Apple Silicon 机器本来就应该优先选 Apple Silicon 安装包；JetBrains 官方文档已经明确区分 Intel 与 Apple Silicon 的磁盘映像。最稳的做法就是一开始下对包。(jetbrains.com)

坑 2：把“项目 JDK”当成“IDE Runtime”#

项目 JDK 在 Project Structure 配；IDE runtime 是 Boot Runtime。二者功能不同，升级策略也不同。很多新机器“能开 IDE 但项目跑不起来”，本质是项目 SDK 没配对，而不是 IDEA 没装好。(jetbrains.com)

坑 3：一股脑装十几二十个插件#

JetBrains 官方允许禁用、卸载、自动更新插件，也建议通过插件设置管理它们。对新机器来说，插件越多，变量越多；先保持最小可用集合，通常最稳。(jetbrains.com)

坑 4：还在用 Settings Repository#

官方已经把它标为 deprecated，并推荐 Backup and Sync。新机器、新环境、新版本，直接从现行方案开始，不要再走旧同步链路。(jetbrains.com)

坑 5：把 DataGrip 当数据库本体#

DataGrip 只负责连接和管理数据库；数据库服务本身仍要你本地或远程部署好，再把连接信息配置进 data source。(jetbrains.com)