CLion升级是版本替换而非覆盖安装，需手动处理设置导入、工具链路径及插件迁移；推荐使用JetBrains Toolbox管理多版本并启用Settings Sync。
CLion 升级不是覆盖安装，而是“版本替换”——新版本独立安装，旧版本可保留或手动卸载。直接运行新版安装包不会自动迁移设置、插件或项目配置。
升级前必须检查 xcode-select 和编译器路径
macOS 用户升级 CLion 后常遇到 invalid active developer path 错误，根本原因不是 IDE 本身，而是系统命令行工具未同步更新。即使刚装过 Xcode 命令行工具，升级 macOS 或 CLion 后仍可能失效。
- 先运行
xcode-select --install，确认命令行工具已就绪 - 再执行
clang --version和make --version，确保 CLion 设置 → 构建、执行、部署 → 工具链 中能自动检测到 Clang 和 GNU Make - 如果检测失败，在工具链中手动指定路径：
/usr/bin/clang、/usr/bin/make（非 Homebrew 安装时）
用 Toolbox 管理多版本比手动安装更可靠
JetBrains Toolbox 是官方推荐的升级方式，它能避免路径冲突、权限问题和设置丢失。手动下载 dmg/exe 安装新版后，旧版仍留在 Applications 或 Program Files 中，且 IDE 内部的「检查更新」功能在 Toolbox 管理下是禁用的。
- 启动 Toolbox 后，CLion 条目右侧会出现「Install」或「Update」按钮，点击即自动下载+解压+注册
- 不同版本共存时，Toolbox 会为每个版本单独维护
~/Library/Caches/JetBrains/CLion2024.3这类缓存目录，互不干扰 - 切换版本只需在 Toolbox 中点击对应版本的「Launch」，无需重装插件或重新配置 CMake
Do not import settings 是升级后首次启动的关键选项
无论从哪个旧版本升级，只要 CLion 检测到已有配置目录（如 ~/Library/Caches/JetBrains/CLion2023.2），就会弹出导入提示。选错会导致插件失效、主题错乱、甚至 CMake 配置被覆盖。
- 勾选
Do not import settings，启动干净环境后再手动迁移关键配置（如 keymap、file templates） - 若需复用旧插件，不要直接复制整个
plugins文件夹——优先通过 Settings → Plugins → ⚙️ →Install plugin from disk...加载本地 ZIP - 已登录 JetBrains 账户的用户，启用 Settings Sync 后，keymap、snippets、color scheme 等可自动同步，但工具链、CMake profiles 等本地路径相关项仍需手动重配
真正麻烦的从来不是点几下「Update」，而是编译器路径漂移、CMake 缓存残留、以及你以为导入了设置其实只导入了一半。升级后第一件事不是跑 hello world，而是打开 Terminal，敲 which clang 和 cmake --version，再进 IDE 看一眼工具链页面里所有路径是否亮绿灯。
