CLion 2025.2 Help

WSL2

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

通过为您的项目设置 WSL 工具链 ,您可以使用来自 Linux 的工具链进行构建,并在 WSL 上运行/调试,而无需离开运行在 Windows 机器上的 CLion。

配置 WSL

  1. Microsoft Store 下载并安装一个 WSL 发行版(例如,Ubuntu)。

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

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

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

  2. 运行 Linux 发行版。

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

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

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

  3. 设置 Linux 发行版环境:

    安装 cmake、gcc 和/或 clang(以及可选的 构建-essentials 软件包),如下所示:

    sudo apt-get update sudo apt-get install cmake gcc clang gdb build-essential

为您的项目配置 WSL 工具链

  1. 在 CLion 中,转到 设置 | 构建、执行、部署 | 工具链

  2. 点击 加号图标 以创建一个新工具链并选择 WSL

  3. 工具集 字段中,选择一个可用的 WSL 发行版。 列表包括由 wsl.exe --list 检测到的发行版,其中包括导入的发行版。

    WSL 工具链

    等待所有工具被检测到并保存设置。

  4. 现在要开始使用工具链,请执行以下操作:

    1. 将 WSL 工具链设置为 默认 (将其移至列表顶部)或 创建一个关联的 CMake 配置文件

    2. 构建运行调试与往常一样。

    1. 设置 | 构建、执行、部署 | Makefile 中切换到 WSL 工具链。

    2. 调用 工具 | Makefile | 清理并重新加载 Makefile 项目

    3. 本机应用程序配置中,使用 \mnt\.. 表示法将 可执行文件 指向二进制文件(例如, \mnt\c\Users\jetbrains\CLionProjects\SimpleMakefile\runme )。

防火墙配置

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

配置防火墙设置

  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. 现在 start the debugger session。 当 Windows 防火墙 弹出窗口出现时,选择 公共网络 复选框。

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