pycharm配置wsl,并启用wsl的virtualenv

本文介绍了如何在PyCharm中配置使用WSL的Python解释器,以及如何在WSL环境下创建和启用Virtualenv,以避免污染全局Python环境。详细步骤包括手动配置自定义WSL发行版、设置PyCharm使用WSL中的Python环境以及在Terminal中使用WSL的设置。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

pycharm配置wsl,并启用wsl的virtualenv

1. pycharm配置wsl,使用wsl的python解释器(举例版本pycharm2020.1)

官方文档Configure an interpreter using WSL

非微软商店安装的wsl,pycharm可能识别不到,需要手动配置自定义发行版

  • 打开pycharm对应配置文件位置

    • %APPDATA%\ JetBrains \ <产品> <版本> \ config \ options wsl.distributions.xml

    • AppData是隐藏目录,在电脑用户目录出执行cd可直接进入

    • 例子:自己电脑位置:C:\Users\zrs\AppData\Roaming\JetBrains\PyCharm2020.1\options\ wsl.distributions.xml

  • 编辑wsl.distributions.xml文件,插入自定义发行版信息

... ...

<descriptor>
  <id>ubuntu-2004</id>
  <microsoft-id>ubuntu-2004</microsoft-id>
  <!--需要指到.exe执行文件-->
  <!--注意:这里要用LX安装,是看不到exe文件的!-->
  <executable-path>D:\wsl\ubuntu_2004\ubuntu2004.exe</executable-path>
  <presentable-name>Ubuntu-20.04</presentable-name>
</descriptor>

<descriptor>
  <id>DEBIAN</id>
  <microsoft-id>Debian</microsoft-id>
  <executable-path>debian.exe</executable-path>
  <presentable-name>Debian GNU/Linux</presentable-name>
</descriptor>

... ...
  • 打开pycharm,在Setting- Project - Project Interpreter下改成wsl的python解释器
    • Linux Distribution 选中自定义的发行版
    • Python interpreter path 写入wsl中python的执行路径: /usr/bin/python3

2. 配置pycharm,使用python virtualenv

通过以上操作,可以将设置为wsl的python解释器。并且pycharm默认也是只能支持到这一步。

现在想让解释器使用wsl中python环境中创建的env环境,避免污染整个wsl的python环境。

实现方式如下(已wsl自带的python3.8为例):

  • 进入wsl命令行,通过python virtualenv包进行操作

  • 通过正常的mkvirtualenv py38_env创建虚拟环境(这里是用root用户创建,.virtualenvs则会存在于/root/下)

  • 此时如果想直接触发py38_env环境内的python,那么执行路径为 /root/.virtualenvs/python38/bin/python3.8

  • 将此路径配置为pycharm中Python interpreter path的设置,重启pycharm,pycharm的python解释器,则会自动指向wsl的py38_env中的解释器

3. 关于pycharm Terminal中使用wsl的设置

Terminal设置官方文档

pycharm设置位置: Setting - Tools - Terminal

  • Project settings使用默认即可
  • Application settings
    • Shell path设置为wsl.exe (这里在启动terminal时会自动加载wsl)
    • Tab name默认值即可

上述配置,只能时在启动时terminal时打开的时wsl的bash,但是无法识别出是否为wsl的虚拟环。这里如果想跟上边一样使用虚拟环境py38_env,需要执行workon py38_env进入env环境。暂时还没想到更好的方式 … …

### PyCharm 配置 WSL 下的 Conda 环境 为了在 PyCharm 中成功配置 WSL 的 Conda 环境,以下是详细的说明: #### 一、WSL 开发环境的基础配置 确保已正确安装启动 WSL 和 Ubuntu。可以通过以下方式验证: - 安装完成后可以在开始菜单找到 Ubuntu 图标[^1]。 - 单击该图标可进入 WSL 终端。 #### 二、Conda 环境的创建与激活 在 WSL 中完成以下操作来创建和激活 Conda 环境: ```bash conda create -n qanything-python python=3.10 # 创建名为 qanything-python 的 Python 3.10 环境 conda activate qanything-python # 激活新创建的环境 ``` 下载项目源码安装依赖: ```bash git clone -b qanything-python https://github.com/netease-youdao/QAnything.git # 克隆指定分支的仓库 cd QAnything # 进入项目目录 pip install -e . # 使用 editable mode 安装依赖 ``` #### 三、PyCharmWSL 支持配置 ##### 1. 设置 Python 解释器路径 将 WSL 中 Conda 环境对应的 Python 路径配置PyCharm 的 `Python Interpreter` 中: - 打开 PyCharms 的设置窗口 (`File -> Settings`)。 - 导航至 `Project: <Your Project> -> Python Interpreter`。 - 添加一个新的解释器路径,指向 WSL 中 Conda 环境下的 Python 文件位置,通常类似于 `/home/<username>/miniconda3/envs/qanything-python/bin/python`[^2]。 ##### 2. 切换 Conda 环境 如果发现运行时提示某些包未安装但实际上已经存在,则可能是因为当前使用的非目标 Conda 环境。解决方法如下: - 在 PyCharm 底部状态栏中找到 `Python Interpreter` 的选项。 - 将其切换为之前配置好的 WSL Conda 环境 (即 `qanything-python`)[^3]。 #### 四、Terminal 配置调整 当遇到 PyCharm Terminal 无法正常进入 Conda 环境的情况时,按照以下步骤处理: - 前往 `Settings -> Tools -> Terminal` 页面。 - 取消勾选最后一项(通常是关于继承系统的 shell 环境变量)。 - 修改 Shell Path 为 `cmd.exe` 保存更改。 - 重新打开 Terminal 窗口以应用修改后的设置[^4]。 通过以上步骤,应该能够顺利地在 PyCharm 中使用基于 WSL 的 Conda 环境进行开发工作。 ---
评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值