Ubuntu 24.04 安装与配置 JetBrains Toolbox 指南

📌 1. JetBrains Toolbox 介绍

JetBrains Toolbox 是 JetBrains 开发的工具管理器，可用于安装、更新和管理 IntelliJ IDEA、PyCharm、WebStorm、CLion 等。本指南记录了 JetBrains Toolbox 在 Ubuntu 24.04 上的 安装、路径调整、权限管理 及 遇到的问题与解决方案。

🛠 2. 下载 JetBrains Toolbox

JetBrains Toolbox 官方提供 .tar.gz 版本，可以在 JetBrains 官网下载。

在这里插入图片描述

✅ 2.1 下载安装包

cd ~/下载
wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.5.4.38621.tar.gz

✅ 2.2 解压安装包

tar -xzf jetbrains-toolbox-2.5.4.38621.tar.gz

✅ 2.3 运行 Toolbox

cd jetbrains-toolbox-2.5.4.38621
./jetbrains-toolbox

⚠️ 可能的问题：

如果无法运行，请先安装依赖以下软件包：

sudo apt install -y libfuse2 libxi6 libxrender1 libxtst6 mesa-utils libfontconfig libgtk-3-bin tar dbus-user-session

如果 Toolbox 没有 UI 反应，尝试使用 X11 模式启动：
```
env XDG_SESSION_TYPE=x11 ./jetbrains-toolbox
```

🚀 3. 设置全局路径（所有用户可用）

默认情况下，Toolbox 只适用于当前用户。我们可以将它移动到 /opt/jetbrains-toolbox，让所有用户都可以访问。

✅ 3.1 移动 Toolbox 到全局路径

sudo mkdir -p /opt/jetbrains-toolbox
sudo mv ~/下载/jetbrains-toolbox-2.5.4.38621 /opt/jetbrains-toolbox
sudo chmod -R 755 /opt/jetbrains-toolbox

✅ 3.2 创建终端命令快捷方式

sudo ln -s /opt/jetbrains-toolbox/jetbrains-toolbox /usr/local/bin/jetbrains-toolbox

现在，任何用户都可以运行：

jetbrains-toolbox

📂 4. 配置 Toolbox 的工具安装目录

默认情况下，Toolbox 会将 IDE 安装到 ~/.local/share/JetBrains/Toolbox/apps，但如果我们想要全局安装，可以改为 /opt/jetbrains-toolbox/apps。

在这里插入图片描述

✅ 4.1 创建全局应用安装目录

sudo mkdir -p /opt/jetbrains-toolbox/apps
sudo chmod -R 777 /opt/jetbrains-toolbox/apps

✅ 4.2 修改 Toolbox 配置

打开 Toolbox
进入“工具”设置
修改安装路径： /opt/jetbrains-toolbox/apps
修改 shell 脚本路径： /opt/jetbrains-toolbox/scripts

✅ 4.3 确保 `$PATH` 包含 Toolbox 脚本目录

sudo nano /etc/profile

在文件末尾添加：

export PATH="/opt/jetbrains-toolbox/scripts:$PATH"

使更改生效：

source /etc/profile

⚠️ 5. 遇到的问题及解决方案

🛑 5.1 Toolbox 运行后无法点击（无响应）

问题描述：

Toolbox 启动后，窗口显示正常，但鼠标点击没有反应。

解决方案：

rm -rf ~/.local/share/JetBrains/Toolbox
rm -rf ~/.config/JetBrains/Toolbox
rm -rf ~/.cache/JetBrains/Toolbox

然后重新运行 Toolbox。

🛑 5.2 Toolbox 没有出现在应用菜单

解决方案：

手动创建桌面快捷方式：

nano ~/.local/share/applications/jetbrains-toolbox.desktop

添加以下内容：

[Desktop Entry]
Name=JetBrains Toolbox
Exec=/opt/jetbrains-toolbox/jetbrains-toolbox
Icon=/opt/jetbrains-toolbox/toolbox.svg
Type=Application
Categories=Development;
StartupWMClass=jetbrains-toolbox

保存并退出后：

chmod +x ~/.local/share/applications/jetbrains-toolbox.desktop
update-desktop-database ~/.local/share/applications/

🔄 6. 更新 JetBrains Toolbox

当 Toolbox 有新版本时，可以手动更新：

cd /opt/jetbrains-toolbox
wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-latest.tar.gz
sudo tar -xzf jetbrains-toolbox-latest.tar.gz --strip-components=1
sudo chmod -R 755 /opt/jetbrains-toolbox

🎯 7. 总结

📌 本次安装主要完成以下任务

下载并安装 JetBrains Toolbox
配置 Toolbox 为全局可用，让所有用户都能运行
修改 IDE 安装路径，避免安装在用户目录
修复无法点击、找不到应用菜单等问题