PyCharm 2025.3 Help

使用 WSL 配置解释器

您可以使用 适用于 Linux 的 Windows 子系统(WSL)与您的 Linux 发行版中可用的 Python 解释器配合工作。

完成准备工作

  1. 请确保已经在计算机上下载并安装 Python

    通过 Microsoft Store 在 Windows 上安装 Python

    如果您使用 Windows,您可以从 Microsoft Store 下载 Python,并将其安装为 Python 解释器。 从 Microsoft Store 下载 Python 应用后,它会出现在 Python 可执行文件列表中。

    请注意,通过 Microsoft Store 安装添加的解释器存在一些限制。 由于 Microsoft Store 应用存在限制,Python 脚本可能无法对 TEMP 和注册表等共享位置具有完全写入权限。

  2. 点击屏幕左下角的 Windows 按钮,然后开始键入 System Information。 为确保系统与 WSL 良好配合,请将 Windows 升级到可用的最新版本。

  3. 按照 WSL 安装指南 的说明安装 适用于 Linux 的 Windows 子系统,并初始化您的 Linux 发行版。

  4. 如果您的 Linux 发行版未预装 rsync,您需要安装它:

    sudo apt install rsync

    sudo pacman -S rsync

通过 WSL 配置解释器

  1. 执行下列任一操作:

    • 点击 Python 解释器选择器 ,然后选择 添加新解释器

    • Ctrl+Alt+S 打开 设置 ,然后导航到 Python | 解释器

    • 点击 Python 解释器选择器 ,然后选择 解释器设置。 点击可用解释器列表旁边的 添加解释器 链接。

  2. 点击可用解释器列表旁边的 添加解释器 链接,并选择 在 WSL 上

  3. 请等待 PyCharm 在您的计算机上检测到 Linux 并完成内省。 点击 下一步 继续:

    检测 Linux
  4. 在对话框的左侧窗格中,选择要创建的 WSL 解释器类型: 虚拟环境Conda 环境系统解释器

    新建 WSL 解释器

    对于系统解释器,只需提供所选 Linux 发行版中 Python 可执行文件的路径。

    对于虚拟环境和 conda 环境,您可以提供所选 Linux 发行版中现有环境的 Python 可执行文件路径,或基于指定的 Python 创建新环境。

完成后,新解释器将添加到您的项目中,并将设置默认的 mnt 映射

PyCharm 允许您使用在 WSL 上运行的 自定义 Linux 发行版。 PyCharm 会自动检测此类发行版,并将其添加到 Linux 发行版 列表中:

为 \\wsl$ 中的目录创建基于 WSL 的解释器

如果您在 \\wsl$ 中有包含一些 Python 文件的目录,您可以在 PyCharm 中打开该目录。 IDE 将创建一个项目,并建议创建基于 WSL 的解释器。

  1. 从主菜单中选择 文件 | 打开。 在 \\wsl$ 中选择一个目录。

    在 WSL 中打开目录
  2. 如果 PyCharm 无法发现任何预先配置的 WSL 解释器,您将看到一个横幅,提示在 Ubuntu 安装中发现 Python:

    发现 WSL 解释器

    点击 在 Ubuntu 中搜索 Python 以查找 Python 可执行文件并创建基于 WSL 的解释器。

  3. 创建解释器后,PyCharm 会通知您。

    已配置的 WSL 解释器

在 WSL 中配置终端

  1. 要在 WSL 配置中运行 终端 ,请打开项目 设置/偏好设置Ctrl+Alt+S ),并转到 工具 | 终端

  2. Shell 路径(S) 字段中指定命令:

    • wsl.exe 以使用默认 Linux 发行版

    • wsl.exe -d <distribution name> 以使用特定的 Linux 发行版

    点击 确定 以保存更改。

    终端设置
最后修改日期: 2025年 12月 2日