JetBrains Toolbox App3.7.2

JetBrains Toolbox App 是 JetBrains 提供的免费桌面管理器，不是 IntelliJ IDEA、PyCharm 或 WebStorm 本身。它负责安装、更新、回退和并行管理 JetBrains IDE，也能整理本地与远程项目。JetBrains 官方发布数据截至 2026 年 9 月 5 日显示，当前稳定版为 3.7.2，Build 为 3.7.2.87231，发布日期为 2026-08-21。第一次使用时，建议先确认系统和架构，再安装一个稳定版 IDE，完成项目打开与构建验证后再启用更激进的更新策略。

先按系统要求和架构选入口

Toolbox App 与 IDE 是两套版本号：3.7.2 是管理器版本，IDE 还会按 IntelliJ IDEA、PyCharm、CLion 等产品分别更新。官方当前文档列出 Windows 10 1809 及以上、Windows 11，macOS 14 及以上（3.5 及更新版本）；macOS 10.14–13 只能更新到 3.4.3。Linux 主要列出 Ubuntu 22.04/24.04 LTS、Fedora 42/43 和 Amazon Linux 2023，并要求 GNOME 或 KDE Plasma 桌面环境以及 x86_64 或 arm64 架构。

官方发布数据中的 3.7.2 安装包大小因平台和架构而异，约为 139.5–181.9 MB。下载时应先进入官方页面，再按系统和 CPU 架构选择，不要把某个平台的单一大小当作所有安装包的大小。

按平台安装 Toolbox App

1. Windows：从官方页面下载 .exe，运行安装向导并按提示完成安装。自动化部署可使用官方文档列出的静默参数，但普通用户不需要额外设置。
2. macOS：下载对应 Intel 或 Apple Silicon 的 .dmg，打开磁盘映像后将 Toolbox App 拖入 Applications 文件夹。
3. Linux：下载对应架构的 .tar.gz，解压到希望使用的目录后运行 ./bin/jetbrains-toolbox；首次启动会初始化用户目录和桌面入口。

Toolbox App 只能把 IDE 安装到当前用户可写入的位置；如果团队要求系统级目录、代理证书或软件中心接管，应先和管理员确定分发方式。Toolbox App 本身不需要许可证，登录 JetBrains Account 后可以自动激活已拥有的 IDE 许可，但每个 IDE 的试用、订阅或免费资格仍需按该产品规则判断。

首次启动先安装一个稳定版 IDE

1. 在 Tools 标签中选择需要的 IDE，优先安装 Stable 通道，并确认安装目录、系统架构和剩余磁盘空间。
2. 安装完成后，用 Projects 标签固定常用项目；从项目入口打开仓库时，确认它交给了正确的 IDE，而不是只打开了项目文件夹。
3. 如果必须复现旧环境，打开对应 IDE 的菜单并选择 Available versions，安装指定版本后再检查插件、SDK、构建和调试。
4. 需要远程主机时切换到 SSH；需要云开发或服务提供商时进入 Manage Plugins，不要把这些入口和本地 IDE 安装混为一谈。

Toolbox 只负责 IDE 的生命周期和项目入口，不会替你安装 .NET、JDK、Python、C/C++ 编译器、SDK 或数据库。项目能否构建和运行，仍取决于 IDE 之外的工具链与环境变量。

给自动更新设定适用范围

官方产品页支持后台下载补丁、自动更新 IDE、随 IDE 更新插件，以及回退或降级。自动化能减少逐个检查的成本，但生产项目、课堂机房或企业镜像不适合无条件追新版本。Toolbox App 3.7 还改进了更新可靠性、会话过期恢复和 Windows Smart App Control 兼容性；Windows 上使用 3.4 或更早版本的用户应优先升级到 3.7 或更高版本，以免部分 JetBrains 服务无法保存或刷新登录凭据。

多版本并存时保留回退路径

Toolbox 支持同一 IDE 的多个版本并存，也能安装 EAP 或其他预览通道。新版本第一次完成索引、构建、调试和插件检查前，不要立即删除旧版本；特别是大项目、嵌入式 SDK 和自定义插件，更应该在副本或非关键机器上先验证。出现问题时可从 IDE 的版本菜单选择回退或降级，但这不等于项目配置、缓存和插件数据库自动回滚。

• 用项目名称、IDE 版本和用途区分稳定版、旧版与预览版。
• 记录 SDK、插件、运行配置和环境变量，避免只记 Toolbox 版本。
• 确认新版本能完成一次真实构建或测试后，再清理旧安装。

清理 Toolbox 数据不要删错项目

Toolbox App 3.6 起可以在 Settings 中查看可移除数据的分类，包括下载缓存、旧版本、临时残留和遗留工具目录，并显示预计可释放的空间。清理前逐项确认，不要把源码、SDK、构建目录或项目备份当作 Toolbox 缓存删除。修改 IDE 或 Toolbox 的安装目录前，也要先关闭仍在索引的 IDE，并确认新目录对当前用户可写。

磁盘空间不足时，优先清理已经确认不再使用的旧 IDE 和下载缓存，再重新执行安装或更新。Windows 安装失败若提示文件被占用、目录只读或权限不足，应先根据安装器诊断和日志定位占用进程，而不是反复点击更新。

迁移电脑时分开处理应用和配置

迁移到新电脑时，Toolbox App 可以重新安装 IDE，但许可证、JetBrains Account、插件设置、JDK 或 SDK、项目文件、代理和证书都要分别确认。先在旧设备记录 IDE 版本、安装目录、项目路径和关键插件，再在新设备安装 Toolbox，选择需要的稳定版，最后逐个打开项目检查索引、构建和运行配置。若企业设备限制外网或用户目录，还应先确认代理、证书和安装权限策略。

Toolbox 的语言、更新频率、登出和使用统计等选项位于设置中；这些设置只影响管理器本身，不会替代 IDE 的编辑器、编译器或项目配置。

远程 IDE 管理要先满足主机条件

Toolbox 可以通过 SSH 管理运行在 Linux、Windows 或 macOS 上的远程项目，也支持通过插件连接开发环境。远程主机不能只满足“能 SSH 登录”：官方文档建议至少 4 vCPU、8 GB RAM、约 10 GB 可用空间，客户端与服务器连接带宽至少 20 Mbps、延迟不超过 200 ms，并要求远端用户目录可写、SSH 端口转发可用。共享主机、资源受限的容器和网络文件系统可能不满足这些条件。

1. 先在终端验证 SSH 用户、主机、端口、密钥和端口转发。
2. 再在 Toolbox 的 SSH 环境中选择远端主机，确认 IDE 后端实际安装位置。
3. 最后打开项目并运行最小构建或测试，把网络、远端工具链和代码问题分开排查。

常见问题按现象排查

本文的版本、系统要求和下载字段按 2026 年 9 月 5 日核对；Toolbox App 与各 JetBrains IDE 更新较快，后续安装或升级应以官方当前页面和对应产品文档为准。