【PyCharm教程】PyCharm 使用 WSL 配置 Python 解释器

您可以使用适用于 Linux 的 Windows 子系统 (WSL) 来使用 Linux 发行版中提供的 Python 解释器。
完成初步步骤
- 确保您已在计算机上下载并安装Python。
- 单击屏幕左下角的 Windows 按钮并开始输入
System Information
。为确保您的系统与 WSL 配合使用,请将您的 Windows 升级到最新的可用版本。 - 安装适用于 Linux 的 Windows 子系统并按照WSL 安装指南中的说明初始化 Linux 发行版。
- 如果你的 Linux 发行版没有 rsync,你需要安装它:
Debian
sudo apt install rsync
使用 WSL 2 时,请注意以下已知的 WSL 问题:
- 将“允许”规则添加到 WSL2 网络的 Windows 防火墙
- 标准输入对 Python 进程显式关闭
- 如果没有为 WSL IP 打开防火墙,调试器将无法正常工作。
通过 WSL 配置远程解释器
执行以下操作之一:
- 单击Python 解释器选择器并选择添加解释器。
- 按Ctrl+Alt+S打开项目设置/首选项并转到项目 <项目名称> | Python 解释器。单击
并选择添加。
- 在对话框的左侧窗格中,单击WSL。
- 选择 Linux 发行版并指定所选 Linux 发行版中 python 可执行文件的路径。通常,您应该寻找wsl.exe,但您可以指定任何非默认 WSL 发行版。
完成后,新的解释器将添加到您的项目中,并设置默认的mnt 映射。
PyCharm 允许您使用在 WSL 上运行的自定义 Linux 发行版。PyCharm 自动检测这样的发行版并将其添加到Linux 发行版列表中:
为 \wsl$ 中的目录创建基于 WSL 的解释器
如果你有任何包含一些 Python 文件的目录\\wsl$
,你可以在 PyCharm 中打开这个目录。IDE 将创建一个项目并建议创建一个基于 WSL 的解释器。
- 选择文件 | 从主菜单打开。在 中选择一个目录
\\wsl$
。
- 如果 PyCharm 无法发现任何预配置的 WSL 解释器,您将在 Ubuntu 安装中看到提示发现 Python 的横幅:
单击在 Ubuntu 中搜索 Python以查找 Python 可执行文件并创建基于 WSL 的解释器。
- 创建解释器后,PyCharm 会通知您。
在 WSL 中配置终端
- 要在 WSL 配置中运行终端,请打开项目设置/首选项( Ctrl+Alt+S) 并转到工具 | 终端。
wsl.exe
在Shell path字段中输入并单击OK。
- 切换到终端工具窗口并键入任何命令来检查输出。
要在 WSL 终端中激活虚拟环境,请运行以下命令:
source .venv/bin/activate
.
配置系统设置以启用调试
执行以下步骤以确保调试器正常工作:
- 以管理员身份运行Windows PowerShell 。
执行以下命令以允许使用 WSL 进行连接:
New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow
然后执行命令更新防火墙规则:
Get-NetFirewallRule | where DisplayName -ILike "*PyCharm*" | Remove-NetFirewallRule
- 现在启动调试器会话。当Windows 安全警报弹出窗口出现时,选择公共网络复选框。