PhpStorm 2026.2 Help

WSL

WSLWSL 2 )——Windows Subsystem for Linux——是一个兼容层,用于在 Windows 10 及更高版本上本地运行 Linux 二进制可执行文件。 目前,它支持若干 Linux 发行版 ,例如 Ubuntu、OpenSUSE 和 SLES。

配置 WSL

  1. 在 Windows 计算机上,从 Microsoft Store 下载并安装一个 WSL 发行版(例如 Ubuntu)

    此步骤请务必使用至少 Windows 10 或更高版本,并安装最新的“秋季创作者更新”(最低版本 1709,构建 16299.15)。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。

    要使用 WSL 2 ,您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。

    请注意,PhpStorm 不支持 旧版 WSL ,而您可能在将系统升级到 Windows 10 build 16299.15 或更高版本之前安装过。 在这种情况下,您需要更新您的 WSL 发行版。

  2. 运行 Linux 发行版。

    首次启动时,系统可能会提示您启用 Windows 可选功能。 在这种情况下,您需要执行以下操作:

    • 以管理员身份打开 Windows PowerShell 并运行

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    • 重新启动您的计算机。

  3. 在 Linux 安装中,确保已安装 PHP。 有关详细的安装说明,请参阅 Debian GNU/Linux installation notes。 如果您使用的是 Ubuntu,您可以在终端中运行此命令以快速安装 PHP:

    sudo apt install php php-mbstring php-xml php-zip php-curl php-xdebug

为 WSL 配置远程 PHP 解释器

  1. 安装并运行 PhpStorm,如常在 Windows 本地进行操作。

  2. Ctrl+Alt+S 打开设置,然后选择 PHP

  3. 在打开的 PHP 页面上,单击 “浏览”按钮 ,位于 CLI 解释器 列表旁边。

  4. 在打开的 CLI 解释器 对话框中,单击左侧窗格中的 "添加"按钮 ,然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...

  5. 在打开的 配置远程 PHP 解释器 对话框中,选择 WSL 方法并提供连接参数:

    通过 WSL 的远程解释器对话框

    字段

    描述

    Linux 发行版

    从下拉列表中选择要使用的已安装 Linux 发行版之一。

    PHP 解释器路径},{

    根据所选远程开发环境的配置,指定 PHP 可执行文件的位置。

    • 对于 WSL,PhpStorm 默认建议 /usr/local/bin/php

    若要指定不同的文件夹,请点击 打开 并在打开的对话框中选择相关文件夹。 请注意,PHP 主目录必须可编辑。

  6. 点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。

    • 如果未找到 PHP 可执行文件,PhpStorm 会显示一条错误消息,询问您是否继续搜索或仍然保存解释器配置。

    • 如果找到 PHP 可执行文件,您将返回到 CLI 解释器 对话框,其中显示了安装文件夹和检测到的 PHP 解释器版本。

    • 选中 仅对该项目可见 复选框后,解释器的可用范围将仅限于当前项目。

    • 单击 显示 phpinfo 按钮 ,位于 PHP 可执行文件 字段旁边,会打开一个单独的信息窗口,其中包含安装详细信息以及已加载的扩展和配置选项的列表。

现在可以从配置的 PHP 解释器列表中选择基于 WSL 的 PHP 解释器,用于所有常见任务:执行 脚本Composer 命令 ,运行 PHP 质量工具等。

Ps select php interpreter wsl

您可以创建一个项目并将其存储在 WSL 环境中,从 WSL 文件系统中打开一个项目,并在 WSL 中进一步开发您的项目。

在 WSL 文件系统中创建一个新项目

  1. 安装并运行 PhpStorm,如常在 Windows 本地进行操作。

  2. 在欢迎屏幕上,点击 新项目

  3. 在打开的页面上,选择要创建的项目类型。

  4. 在右侧窗格的 Location 字段中指定项目的路径。 WSL 的项目位置将显示以 \\wsl$ 开头的 WSL 文件系统的绝对路径。

    新项目:project sdk
  5. 点击 创建

    PhpStorm 创建一个位于 WSL 的项目,您可以在不离开 IDE 的情况下在 WSL 环境中开发和构建您的项目。

在 WSL 文件系统中打开项目

在 PhpStorm,您可以直接打开存储在 WSL 文件系统中的项目,并像处理其他项目一样进行操作。

  1. 请点击 打开欢迎屏幕或从主菜单中选择 文件 | 打开

  2. 在打开的 选择路径对话框中,选择包含要打开项目的 WSL 文件系统中的文件夹,或者手动输入项目位置的路径。

    路径语法为 \\wsl.localhost\DistributionName ,其中 DistributionName 是您的 Linux 发行版名称,例如 Ubuntu、Debian、Arch 等。

    打开存储在 WSL 文件系统中的项目
2026年 7月 16日