JetBrains 工具箱使用教程
本页从第一次打开工具箱开始，介绍设备绑定、JetBrains 软件下载安装与激活，以及开发环境管理。还没有完成安装时，请先阅读安装教程。
使用前准备
- 使用过程中需要联网，请保持网络可用。
- 操作 JetBrains 软件前，先启动一次目标软件，让它生成本机配置，然后完全退出。
- 激活和清理配置时，请关闭所有 JetBrains 软件。
- Windows 如果提示没有写入权限，请关闭工具箱，再右键选择“以管理员身份运行”。
1. 完成设备绑定
首次打开时，工具箱会自动读取并验证当前设备。
- 如果页面显示“验证成功”，可以直接使用左侧功能。
- 如果页面显示“设备未授权”，输入购买时的订单号，然后点击“提交验证”。
- 如果显示“设备信息加载失败”，点击“重新加载”；仍然失败时记录完整提示并到问题列表排查。
验证成功后，首页会显示设备信息、订单状态和访问权限。一个订单默认绑定一台设备；增加设备等订单规则以安装教程中的版权与订单说明为准。
2. 认识主界面
验证成功后，左侧有三个主要入口：
| 入口 | 用途 |
|---|---|
| 首页 | 查看当前设备、订单和访问权限状态 |
| JetBrains 管理 | 下载、激活或清理 JetBrains 软件配置 |
| 开发环境管理 | 检测并管理语言运行时、构建工具和 MySQL 版本 |
侧栏可以收起或展开。Windows 和 Linux 窗口右上角提供最小化、最大化/还原和关闭按钮。
3. 下载与安装 JetBrains 软件
已经从 JetBrains 官网安装好软件的用户可以跳过本节。
- 进入
JetBrains 管理 -> 下载与安装。 - 阅读弹出的下载说明，点击“我已知晓，继续使用”。
- 选择 IDEA、GoLand、PyCharm 等产品。
- 选择“最新版本”或“历史版本”，再确认操作系统。
- 点击“选择目录”。Windows 用该目录保存安装包；Linux 安装到该目录；macOS 会安装到
/Applications。 - 在“可用下载”中选择安装包并点击“下载”，在“下载安装列表”查看进度。
不同系统完成下载后的行为不同：
- Windows：工具箱下载完成后打开安装包，请按安装向导完成安装。
- macOS：工具箱自动安装到“应用程序”目录，系统可能要求“App 管理”权限。
- Linux：工具箱将软件安装到所选目录。
安装结束后先打开一次 JetBrains 软件，进入欢迎页后完全退出，再继续激活。如果内置下载失败，可直接从 JetBrains 官网下载安装，不影响后续操作。
4. 激活 JetBrains 软件
自动识别并激活
- 先打开一次所有需要处理的 JetBrains 软件，然后完全退出。
- 进入
JetBrains 管理 -> 软件激活。 - 选择“软件本体激活”。工具箱支持 2021 年及以后的版本。
- 点击“开始识别并激活软件”，等待处理完成。
- 检查“已识别软件”列表中是否包含目标软件和版本。
- 在结果窗口复制激活码，然后重新打开 JetBrains 软件。
- 在 JetBrains 激活窗口选择
Activation Code，粘贴激活码完成操作。
激活码只可在当前设备使用。若列表中没有目标软件，请确认软件已经启动过、已完全退出且配置目录可写；Windows 用户还可以使用手动识别。
Windows 手动识别
该功能仅用于 Windows 自动识别失败的情况。
- 在“已识别软件”区域点击“有未识别的软件？点击这里手动识别（仅限 Windows）”。
- 点击目录选择区域，选择 JetBrains 软件的安装根目录，例如
C:\Program Files\JetBrains\IntelliJ IDEA 2024.1。 - 确认目标软件已关闭，然后点击“开始激活”。
- 成功后在“已激活软件”中点击“查看并复制激活码”，再到 JetBrains 软件中输入。
手动识别适用于正常安装版。如果使用压缩包版本、移动过安装目录或修改过配置目录，可能仍然无法识别。
插件激活
- 先使用本工具完成软件本体激活。
- 在激活页选择“插件激活”。
- 输入完整插件名称，例如
MyBatis Plugin，点击“搜索插件”或按 Enter。 - 找到结果后复制激活码，并在插件要求的授权入口中使用。
插件是否兼容由插件自身版本决定，获取到激活码不代表所有版本都可以正常使用。
在 JetBrains 软件中输入激活码
激活入口通常有两个：
- 欢迎页或主界面的设置菜单，入口名称可能是“注册”或“管理订阅”。
- 顶部菜单
帮助 -> 注册/管理订阅。
进入激活窗口后选择 Activation Code，粘贴工具箱生成的激活码。
5. 清理激活配置
“清理激活”用于移除当前 JetBrains 激活配置，不是常规激活步骤。
- 完全关闭所有 JetBrains 软件。
- 进入
JetBrains 管理，点击“清理激活”。 - 阅读确认窗口，确定需要清理后点击“确认清理”。
清理后原有激活状态可能失效，需要重新执行激活流程。不要在没有明确需要时使用此功能。
6. 开发环境管理
“开发环境管理”用于检测和管理 Node.js、Python、Java、Go、Rust、包管理器、构建工具和 MySQL 等环境，与 JetBrains 软件激活相互独立。
首次进入
- 点击左侧“开发环境管理”。
- 工具箱会检测当前
PATH中的环境并显示已安装、未安装或异常状态。 - 如果提示“需要安装 mise”，阅读说明后点击“开始安装”。mise 用于多版本安装和全局切换，工具箱会从国内镜像下载并校验。
- Windows 如果缺少 Microsoft Visual C++ 运行库，会先出现安装提示，按页面指引完成即可。
安装和切换版本
- 使用搜索、状态或分类筛选找到目标环境。
- 点击“安装”或“管理”打开版本管理面板。
- 从底部列表选择版本，点击“安装版本”并确认。
- 安装不会自动删除已有版本，也不会自动切换当前版本。
- 在“已安装版本”中点击“切换”，将该版本设为全局默认版本。
- 如需恢复电脑原有环境，点击“切换到系统环境”。
当前正在使用的版本不能直接卸载。切换后，新开的终端通常会读取新版本；已经打开的终端或应用可能需要完全退出后重开。
管理 MySQL
MySQL 除版本安装外，还需要初始化独立实例：
- 安装需要的 MySQL 版本。
- 点击“初始化”，设置
1024-65535范围内未被占用的端口和 8-64 位 root 密码。 - 初始化完成后，可以执行“启动”“停止”“重启”或“切换并启动”。
每个版本使用独立的数据目录。root 密码不会保存到配置文件，请自行妥善保管。已经初始化的 MySQL 版本不能直接卸载，避免误删数据库数据。
7. 遇到问题
先查看问题列表。仍无法解决时，请提供：
- 操作系统版本和电脑架构；
- 工具箱版本与 JetBrains 软件版本；
- 执行到哪一步、点击了哪个按钮；
- 完整报错文字或截图；
- 已经尝试过的处理方式。