PhpStorm 2025.2 Help

WSL

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

配置 WSL

  1. 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
  4. 按照 配置远程 PHP 解释器 中的描述配置基于 WSL 的远程解释器。 您可以将创建的解释器指定用于所有常见任务:执行 脚本Composer 命令 ,运行 PHP 质量工具等。

在 WSL 文件系统中打开项目

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

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

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

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

    打开存储在 WSL 文件系统中的项目

防火墙配置

您需要执行以下步骤以确保项目构建正常运行。

配置防火墙设置

  1. 以管理员身份运行 Windows PowerShell

    将防火墙恢复为默认设置
  2. 执行以下命令以允许使用 WSL 进行连接:

    New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow

    使用以下命令检查确切的接口名称,例如 vEthernet (WSL)vEthernet (WSL2) ,或者如果您已重命名则可能是其他名称:

    Get-NetAdapter
  3. 然后执行命令以更新防火墙规则:

    Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "IntelliJ IDEA*" | Disable-NetFirewallRule
  4. 现在开始调试会话。 当 Windows 防火墙 弹出窗口出现时,选择 公共网络 复选框。

    允许公用网络
最后修改日期: 2025年 9月 26日