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 安装路径，避免安装在用户目录
- 修复无法点击、找不到应用菜单等问题
