WSL

配置 WSL

1. 从 Microsoft Store 下载并安装一个 WSL 发行版（例如 Ubuntu）。

   此步骤需确保使用的是 Windows 10 或更新版本，并已安装最新版本的“秋季创意者更新”（最低版本为 1709，内部版本为 16299.15）。 有关安装说明，请参阅官方指南 Install the Windows Subsystem for Linux。

   要使用 WSL 2 ，您的 Windows 版本应为 10，内部版本号不低于 18917。 请按照 这些说明 更改发行版。

2. 运行 Linux 发行版。

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

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

     Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

   • 重启计算机。

安装 Node.js 和 npm

在 Linux（Ubuntu）安装中，请确保已安装 nvm、Node.js 和 npm。 有关详细的安装说明，请参阅 Install Node.js on Windows Subsystem for Linux。

1. 打开 终端 （Alt+F12。

2. 安装 cURL：

   sudo apt-get install curl

3. 安装 nvm：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

4. 安装 Node.js，请运行以下任一命令：

   • nvm install --lts 安装稳定的长期支持版 Node.js

   • nvm install node 安装当前发布版本

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

1. 安装并运行 WebStorm，如常在 Windows 本地运行即可。

2. 在欢迎界面中，点击 新建项目。

   

3. 在打开的对话框中：

   1. 在左侧窗格中选择项目类型。

   2. 在右侧窗格中指定项目名称和位置。 WSL 的项目位置将显示以 \\wsl$ 开头的绝对路径，指向 WSL 文件系统。

      

   3. 通常，WebStorm 会要求您指定 Node.js 的位置。 如果尚未安装 Node.js，请从列表中选择 下载。 或者，选择 添加 配置一个 WSL Node.js interpreter。

      

      然后从弹出窗口中选择 添加 WSL。

      

      在打开的 添加 WSL Node 解释器 对话框中，指定当前使用的 Linux 发行版和 Node.js 的路径。

      

   4. 在右侧窗格中填写其他字段。 字段集取决于所选的项目类型。 有关详情，请参阅 语言与框架 下的相关文章。

4. 单击 创建。

   

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

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

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

1. 在 欢迎界面 上单击 打开 ，或从主菜单中选择 文件 | 打开。

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

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

   

配置基于 WSL 的 Node.js 解释器

您可以将 Node.js 安装配置为 当前项目的默认解释器 ，也可以在 Node.js 运行/调试配置中配置并使用该版本。

1. 在 设置 对话框（Ctrl+Alt+S ）中，前往 语言与框架 | Node.js。

2. 在 Node 解释器 字段旁单击 ，在打开的 Node.js 解释器 对话框中，单击 ，然后从列表中选择 添加 WSL。

   

3. 在打开的 添加 WSL Node 解释器 对话框中，选择您正在使用的 Linux 发行版，并指定 Node.js 的路径。

   

   配置后的 Node.js 安装将添加到列表中，并设置为当前项目的默认版本。

   

运行并调试项目

运行或调试应用程序时，它会在 WSL 中运行。 如果打开运行配置，请注意，WebStorm 会将 WSL 视为本地计算机。

1. 根据应用程序的类型 创建相应类型的运行/调试配置。 为此，请转到 运行 | 编辑配置。 接着在 运行/调试配置 对话框中，单击工具栏上的 按钮，并选择所需的运行/调试配置类型。 在打开的对话框中，根据需要填写字段，或接受预定义值。

   

2. 要运行应用程序，请在 运行 小部件中选择新创建的运行/调试配置，然后单击其旁边的 。

3. 要调试应用程序，请在必要的位置设置断点，然后在 运行 小部件中选择新创建的运行/调试配置，并单击其旁边的 。