WSL 中配置 Miniconda 及 VSCode/Cursor 运行 Python 环境

2. 创建 conda 虚拟环境

# 创建名为 python_wsl_env 的环境，指定 Python 版本（推荐 3.10/3.11）
conda create -n python_wsl_env python=3.10 -y
# 参数说明：
# -n：环境名称（自定义，如 py310、my_project）
# python=3.10：指定 Python 版本
# -y：自动确认所有安装选项，无需手动输入 yes

3. 管理 conda 虚拟环境（常用命令）

4. 验证虚拟环境

激活环境后，执行以下命令，确认 Python 路径指向 conda 环境：

conda activate python_wsl_env
# 查看 Python 路径
which python
# 示例输出：/home/你的用户名/miniconda3/envs/python_wsl_env/bin/python
# 查看 Python 版本
python --version
# 示例输出：Python 3.10.14

四、方案 1：VSCode 连接 WSL+conda 环境运行 Python

1. 安装 VSCode 必备插件

打开 Windows 端 VSCode，在左侧扩展商店（Ctrl+Shift+X）安装：

• Remote - WSL（微软官方）：核心插件，用于连接 WSL；
• Python（微软官方）：支持 conda 环境识别、代码运行 / 调试；
• Pylance（自动随 Python 插件安装）：增强 Python 语法提示。

2. 连接 VSCode 到 WSL

方式 1：命令面板连接

• 按下 Ctrl+Shift+P 打开命令面板；
• 输入「WSL: Connect to WSL」，选择你的 WSL 发行版（如 Ubuntu-22.04）；
• 等待连接完成，VSCode 左下角会显示「WSL: Ubuntu-22.04」，表示已进入 WSL 环境。

方式 2：WSL 终端启动 VSCode

打开 WSL 终端，激活 conda 环境（可选），进入项目目录：

cd ~ # 进入用户主目录，或自定义项目目录如 mkdir -p ~/python_project && cd ~/python_project
code . # 在当前目录启动 VSCode（自动连接 WSL）

3. 打开 WSL 项目目录

• 点击 VSCode 左侧资源管理器（Ctrl+Shift+E）→「打开文件夹」；
• 选择 WSL 中的目录（如 ~/python_project），点击「确定」；
• 若提示「信任此文件夹」，选择「是」（否则无法正常运行代码）。

4. 选择 conda 虚拟环境作为解释器

• 按下 Ctrl+Shift+P，输入「Python: Select Interpreter」；
• 在弹出的列表中，找到并选择你的 conda 环境：✅ 正确路径示例：~/miniconda3/envs/python_wsl_env/bin/python ❌ 避免选系统 Python（/usr/bin/python3）或 base 环境；
• 选择后，VSCode 右下角会显示「Python 3.10.14 ('python_wsl_env': conda)」，表示配置成功。

5. 运行 / 调试 Python 代码

步骤 1：新建测试文件

在 VSCode 中右键项目目录→「新建文件」，命名为 test_conda.py，输入代码：

import sys
import numpy # 若已安装 numpy，可验证包是否可用
print("Python 解释器路径：", sys.executable)
print("Python 版本：", sys.version)
print("numpy 版本：", numpy.__version__) # 未安装则注释此行
print("Hello from WSL conda env!")

步骤 2：运行代码（3 种方式）

1. 右上角运行按钮：点击编辑区右上角的「▶️」，选择「Run Python File in Terminal」，VSCode 底部会打开 WSL 终端，输出结果（自动激活 conda 环境）；
2. 终端手动运行：打开 VSCode 内置终端（Ctrl+），先激活 conda 环境 conda activate python_wsl_env，再执行 python test_conda.py`；
3. 断点调试：在代码行号左侧点击添加断点→按下 F5 启动调试，可逐行执行、查看变量（自动使用 conda 环境）。

五、方案 2：Cursor 连接 WSL+conda 环境运行 Python

Cursor 基于 VSCode 内核，配置逻辑与 VSCode 一致，仅界面略有差异，核心步骤如下：

1. 安装 Cursor 的 WSL 插件

• 打开 Windows 端 Cursor，左侧扩展商店（Ctrl+Shift+X）；
• 搜索并安装「Remote - WSL」（微软官方插件，与 VSCode 通用）；
• Cursor 默认内置 Python 支持，无需额外安装 Python 插件。

2. 连接 Cursor 到 WSL

• 按下 Ctrl+Shift+P 打开命令面板，输入「WSL: Connect to WSL」，选择你的 WSL 发行版；
• 连接成功后，Cursor 左下角显示「WSL: Ubuntu-22.04」。

3. 打开 WSL 目录并选择 conda 解释器

• 点击「File → Open Folder」，选择 WSL 中的项目目录（如 ~/python_project），确认信任；
• 按下 Ctrl+Shift+P，输入「Python: Select Interpreter」，选择 conda 环境 python_wsl_env；
• Cursor 右下角会显示 conda 环境版本，配置完成。

4. 运行 Python 代码

• 新建 test_conda.py（同 VSCode 示例代码）；
• 方式 1：右上角运行：点击编辑区右上角「▶️ Run」，选择「Run Python File in Terminal」，终端输出结果；
• 方式 2：终端运行：打开 Cursor 内置终端（Ctrl+），激活 conda 环境后执行 python test_conda.py`；
• 方式 3：AI 辅助运行（Cursor 特色）：选中代码→按下 Ctrl+L 打开 AI 窗口→输入「运行这段代码并验证 conda 环境是否生效」，AI 会执行代码并返回结果 + 环境验证信息。

六、常见问题与解决方案

1. VSCode/Cursor 中找不到 conda 虚拟环境

• 原因：conda 环境未被 VSCode/Cursor 识别，或解释器路径未刷新；
• 解决：
  1. 确保已在 WSL 终端激活过该 conda 环境；
  2. 在 VSCode/Cursor 中执行命令面板→「Python: Refresh Interpreter List」刷新列表；
  3. 手动指定路径：命令面板→「Python: Select Interpreter」→「Enter interpreter path」→输入 /home/你的用户名/miniconda3/envs/python_wsl_env/bin/python。

2. WSL 终端中输入 conda 命令提示「command not found」

• 原因：安装 Miniconda 时未选择 conda init，环境变量未配置；

解决：

# 手动初始化 conda
~/miniconda3/bin/conda init bash
# 重启终端，或执行 source ~/.bashrc 使配置生效
source ~/.bashrc

3. 运行代码提示「ModuleNotFoundError: No module named 'numpy'」

• 原因：包安装在 base 环境，未安装在当前 conda 环境；

解决：激活目标环境后安装：

conda activate python_wsl_env
conda install numpy -y

4. 终端输出中文乱码

解决：在 WSL 终端执行以下命令配置 UTF-8 编码：

echo "export LC_ALL=en_US.UTF-8" >> ~/.bashrc
echo "export LANG=en_US.UTF-8" >> ~/.bashrc
source ~/.bashrc

重启 VSCode/Cursor 的 WSL 终端即可。

5. 激活 conda 环境提示「CommandNotFoundError: Your shell has not been properly configured to use 'conda activate'」

• 原因：shell 未初始化 conda，或使用 zsh 而非 bash；

解决：

# 若用 bash
conda init bash
# 若用 zsh（WSL 默认是 bash，若手动切换过）
conda init zsh
# 重启终端

七、总结

1. WSL 中 conda 环境的核心是「安装 Miniconda→创建虚拟环境→激活使用」；
2. VSCode/Cursor 通过「Remote - WSL」插件连接 WSL 后，选择 conda 环境的 Python 解释器即可无缝运行代码；
3. 关键注意：所有包需安装在目标 conda 环境中，而非 base 环境，避免依赖冲突。

按照以上步骤，你可在 WSL 的隔离环境中安全运行 Python 代码，同时利用 VSCode/Cursor 的便捷开发功能（调试、AI 辅助等）。