当前位置：首页 > news >正文

在 WSL 中安装 JetBrains Toolbox：完整指南

news 2025/5/30 16:54:30

JetBrains Toolbox 是一个非常实用的工具，它可以帮助开发者轻松管理 JetBrains 的各种开发工具，如 IntelliJ IDEA、PyCharm、WebStorm 等。通过它，你可以快速安装、更新和管理这些工具，极大地提高了开发效率。而在 WSL 环境中安装 JetBrains Toolbox，可以让 Linux 用户在 Windows 系统中无缝地使用这些强大的开发工具。

一、准备工作

在开始安装之前，请确保你的 WSL 环境已经正确安装并配置好。以下是检查 WSL 版本的命令：

wsl -v version

如果你的 WSL 版本较低，建议升级到最新版本以获得更好的兼容性和性能。

二、下载 JetBrains Toolbox

首先，我们需要从 JetBrains 官方网站下载 JetBrains Toolbox 的安装包。以下是下载地址：

JetBrains Toolbox 2.6.2.41321 下载链接

你可以使用 wget 或 curl 命令在 WSL 中直接下载：

wget wget https://download-cdn.jetbrains.com/toolbox/jetbrains-toolbox-2.6.2.41321.tar.gz -P /opt/

或者，如果你已经将下载文件保存在 Windows 系统中，可以通过以下命令将其复制到 WSL 的 /opt 目录：

cp /mnt/c/Users/你的用户名/Downloads/jetbrains-toolbox-2.6.2.41321.tar.gz /opt/

三、安装 JetBrains Toolbox

解压安装包

打开 WSL 终端，切换到 /opt 目录：
```
cd /opt
```
然后解压下载的安装包：
```
tar -zxvf jetbrains-toolbox-2.6.2.41321.tar.gz
```
解压完成后，你会在 /opt 目录下看到一个名为 jetbrains-toolbox-2.6.2.41321 的文件夹。
安装 FUSE

JetBrains Toolbox 是一个 AppImage 文件，它需要 FUSE（Filesystem in Userspace）才能运行。因此，在运行 JetBrains Toolbox 之前，我们需要安装 FUSE。

在 WSL 中，运行以下命令安装 FUSE：
```
sudo add-apt-repository universe
sudo apt update
sudo apt install libfuse2t64
```
如果你使用的是 Ubuntu 22.04 或更早版本，安装 libfuse2 即可：
```
sudo apt install libfuse2
```
运行 JetBrains Toolbox

安装完 FUSE 后，切换到 JetBrains Toolbox 的安装目录：
```
cd /opt/jetbrains-toolbox-2.6.2.41321
```
然后运行以下命令启动 JetBrains Toolbox：
```
./jetbrains-toolbox
```
如果一切正常，JetBrains Toolbox 应该会自动启动，并在 WSL 的桌面环境中打开。

四、将 JetBrains Toolbox 添加到环境变量

为了让你可以通过输入 toolbox 命令直接启动 JetBrains Toolbox，我们需要将其添加到环境变量中。以下是具体步骤：

创建一个可执行脚本

在 /usr/local/bin 目录下创建一个名为 toolbox 的脚本文件，该脚本将指向 JetBrains Toolbox 的可执行文件：
```
sudo nano /usr/local/bin/toolbox
```
在打开的编辑器中，输入以下内容：
```
#!/bin/bash
/opt/jetbrains-toolbox-2.6.2.41321/jetbrains-toolbox "$@"
```
保存并退出编辑器（在 nano 中按 Ctrl+X，然后按 Y 确认保存，最后按 Enter）。
赋予脚本可执行权限

运行以下命令，为 toolbox 脚本赋予可执行权限：
```
sudo chmod +x /usr/local/bin/toolbox
```
测试命令

现在，你可以在终端中直接输入 toolbox 来启动 JetBrains Toolbox：
```
toolbox
```

在这里插入图片描述

如果一切正常，JetBrains Toolbox 应该会立即启动。

五、可能遇到的问题及解决方法

权限问题

如果你在运行 JetBrains Toolbox 时遇到权限问题，可以尝试使用 sudo 命令赋予其可执行权限：
```
sudo chmod +x ./jetbrains-toolbox
```
FUSE 版本问题

如果你仍然遇到与 FUSE 相关的错误，可以尝试更新 FUSE 到最新版本，或者检查 FUSE 是否正确安装。
图形界面问题

如果 JetBrains Toolbox 无法正常显示图形界面，可能是因为 WSL 的图形支持没有正确配置。你可以尝试更新 WSL 到最新版本，并确保安装了 x11-apps 和 xorg 等图形支持包。