WSL2（Linux）+ VSCode 运行 D 盘 Python 文件全流程文档

一、核心命令整理（按场景分类）

1. WSL2 基础检查命令

表格

命令	作用	说明
`uname -r`	查看 WSL2 内核版本	验证是否为 WSL2 环境（输出含`microsoft-standard-WSL2`）
`wsl -l -v`	查看 WSL 版本（Windows 终端执行）	需在 PowerShell/CMD 中执行，确认 WSL 版本为 2

2. D 盘挂载相关命令

表格

命令	作用	说明
`mkdir -p ~/mnt/d_drive`	创建 D 盘挂载目录	`-p`确保目录不存在时创建，存在不报错
`sudo mount -t drvfs D: ~/mnt/d_drive`	挂载 Windows D 盘到 WSL	需输入 Linux 密码，挂载后`~/mnt/d_drive`对应 D:\
`sudo umount ~/mnt/d_drive`	卸载 D 盘挂载	挂载异常时清理用
`sudo rm -rf ~/mnt/d_drive/ragtest`	删除 WSL 空文件夹	解决挂载后看不到 Windows 文件的冲突
`sudo nano /etc/fstab`	编辑自动挂载配置	末尾添加`D: /home/lyh/mnt/d_drive drvfs defaults 0 0`实现永久挂载
`ls -l ~/mnt/d_drive/`	查看 D 盘内容	验证挂载是否成功，确认文件夹大小写
`sudo chown -R $USER:$USER ~/mnt/d_drive`	赋予 D 盘挂载目录权限	解决读写权限不足问题

3. Miniconda 安装与初始化命令

表格

命令	作用	说明
`wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py311_25.1.1-2-Linux-x86_64.sh`	清华镜像下载 Miniconda	解决官方源下载失败问题
`bash Miniconda3-py311_25.1.1-2-Linux-x86_64.sh`	执行 Miniconda 安装脚本	安装时需选`yes`初始化 conda
`source ~/.bashrc`	加载 conda 环境变量	安装后让 conda 命令生效
`conda -V`/`conda --version`	查看 conda 版本	验证安装成功（大写 V）
`conda config --show-sources`	查看 conda 源配置	验证清华镜像是否生效

4. Conda 虚拟环境管理命令

表格

命令	作用	说明
`conda create -n graph python=3.12 -y`	创建名为 graph 的虚拟环境	`-n`指定环境名，默认存于 WSL 系统目录
`conda create --prefix ./graph_env python=3.12 -y`	在 D 盘创建虚拟环境	`--prefix`指定路径（当前目录），环境存于 D 盘
`conda activate graph`	激活 graph 环境	激活后终端前缀显示`(graph)`
`conda activate ./graph_env`	激活 D 盘的虚拟环境	需指定路径（--prefix 创建的环境）
`conda deactivate`	退出虚拟环境	回到 base 环境或无环境前缀
`conda env list`	查看所有虚拟环境	显示环境名称 / 路径
`conda remove -n graph --all -y`	删除 graph 环境	需先退出环境

5. 文件与目录操作命令

表格

命令	作用	说明
`cd ~/mnt/d_drive/ragtest`	进入 D:\RAGtest 目录	Linux 严格区分大小写，对应 Windows D 盘目录
`pwd`	查看当前工作目录	验证是否进入目标路径
`ls -l`	列出目录下文件 / 文件夹	查看文件详情，确认目标文件存在
`nano analysis.py`	创建 / 编辑 Python 文件	新手友好编辑器，Ctrl+O 保存、Ctrl+X 退出
`ln -s ~/mnt/d_drive/ragtest ~/mnt/d_drive/RAGtest`	创建软链接	解决大小写访问习惯问题

6. Python 包安装命令

表格

命令	作用	说明
`pip install -r ./requirements.txt`	安装 requirements.txt 中的包	需在激活的虚拟环境中执行
`pip install -r ./requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`	清华镜像安装包	解决下载慢 / 超时问题
`pip list`	查看已安装的包	验证包是否安装成功
`pip uninstall 包名 -y`	卸载指定包	按需卸载

二、WSL2 + VSCode 运行 D 盘 Python 文件全流程

1. 前置准备

已安装 WSL2（Ubuntu 22.04），且版本为 2；
Windows 端安装 VSCode，并安装**Remote - WSL、Python官方插件**；
Windows D 盘有目标 Python 项目目录（如D:\RAGtest），包含requirements.txt和待运行的.py文件。

2. WSL2 环境配置（核心：挂载 D 盘）

步骤 1：打开 WSL2 终端

Windows 开始菜单搜索 "Ubuntu"，打开 WSL2 终端（默认进入用户主目录/home/lyh/）。

步骤 2：创建并挂载 D 盘目录

python 复制代码

# 1. 创建D盘挂载目录
mkdir -p ~/mnt/d_drive

# 2. 挂载Windows D盘（输入Linux密码）
sudo mount -t drvfs D: ~/mnt/d_drive

# 3. 验证挂载（能看到D盘文件夹，如ragtest）
ls -l ~/mnt/d_drive/

# 4. （可选）配置永久挂载（避免重启WSL失效）
sudo nano /etc/fstab
# 在文件末尾添加：
D: /home/lyh/mnt/d_drive drvfs defaults 0 0
# 按Ctrl+O保存→回车→Ctrl+X退出

步骤 3：进入 D 盘项目目录

python 复制代码

# 进入Windows D:\RAGtest（Linux严格区分大小写，实际为ragtest）
cd ~/mnt/d_drive/ragtest

# 验证当前路径（输出：/home/lyh/mnt/d_drive/ragtest）
pwd

# 查看目录下文件（确认有requirements.txt、.py文件）
ls -l

3. Miniconda 安装与虚拟环境创建

步骤 1：安装 Miniconda（清华镜像）

Miniconda3-py311_25.1.1-2-Linux-x86_64.sh

python 复制代码

# 1. 下载Miniconda安装包
wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py311_25.1.1-2-Linux-x86_64.sh

# 2. 执行安装脚本
bash Miniconda3-py311_25.1.1-2-Linux-x86_64.sh
# 安装交互：回车→q跳过协议→yes→回车（默认路径）→yes（初始化conda）

# 3. 加载环境变量（或重启终端）
source ~/.bashrc

# 4. 验证安装（输出版本号如conda 25.1.1）
conda -V

# 5. 配置conda清华镜像（加速装包）
nano ~/.condarc
# 粘贴以下内容：
channels:
  - defaults
show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
# 保存退出：Ctrl+O→回车→Ctrl+X
conda clean -i  # 清除缓存

步骤 2：创建并激活虚拟环境

python 复制代码

# 1. 创建名为graph的虚拟环境（Python 3.12）
conda create -n graph python=3.12 -y

# 2. 激活环境（终端前缀显示(graph)）
conda activate graph

# 3. 安装项目依赖（用清华镜像加速）
pip install -r ./requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 4. 验证依赖安装
pip list

4. VSCode 连接 WSL2 并配置环境

步骤 1：VSCode 连接 WSL2

打开 Windows 端 VSCode；
点击左下角「><」图标→选择「Remote-WSL: New Window」；
等待 VSCode 加载 WSL 环境，左上角显示「WSL: Ubuntu」即连接成功。

步骤 2：打开 D 盘项目目录

VSCode 中点击「文件」→「打开文件夹」；
路径输入：/home/lyh/mnt/d_drive/ragtest→点击「确定」；
此时能看到 D:\RAGtest 下的所有文件（如analysis.py、requirements.txt）。

步骤 3：配置 Python 解释器（关键）

快捷键Ctrl+Shift+P打开命令面板；一定要在VScode中的wsl环境下安装python，只在windows中安装不行。
输入Python: Select Interpreter→回车；
点击「Enter interpreter path...」→输入虚拟环境路径：
python 复制代码
```
/home/lyh/miniconda3/envs/graph/bin/python
```
回车确认，VSCode 左下角显示Python 3.12.xx ('graph': conda)即配置成功。

5. 运行 Python 文件

方式 1：直接运行（新手推荐）

打开目标 Python 文件（如analysis.py）；
点击右上角「▶️ 运行 Python 文件」按钮；
VSCode 集成终端自动激活graph环境，并执行代码，输出结果（如数据分析内容）。

方式 2：集成终端运行（灵活）

VSCode 中点击「终端」→「新建终端」（快捷键Ctrl+Shift+）；
终端自动激活graph环境（前缀(graph)），执行：
复制代码
```
python analysis.py
```
回车后查看输出结果，完成代码运行。

方式 3：调试代码（进阶）

在analysis.py行号旁点击添加断点（红色圆点）；
点击左侧「运行和调试」图标（虫子形状）→「创建 launch.json 文件」→选择「Python 文件」；
点击左上角「▶️ 调试」按钮，代码在断点处暂停，可逐行执行、查看变量。

6. 常见问题与解决方案

表格

问题	解决方案
挂载 D 盘后看不到 Windows 文件	执行`sudo umount ~/mnt/d_drive`→`sudo rm -rf ~/mnt/d_drive/ragtest`→`sudo mount -t drvfs D: ~/mnt/d_drive` # 卸载当前的D盘挂载（需要Linux密码） sudo umount ~/mnt/d_drive # 删除WSL里的空ragtest（不影响Windows D盘的文件） sudo rm -rf ~/mnt/d_drive/ragtest # 重新挂载Windows D盘到WSL的~/mnt/d_drive sudo mount -t drvfs D: ~/mnt/d_drive
conda 命令提示 "未找到"	执行`source ~/.bashrc`重启环境变量，或安装时确认选了`yes`初始化
VSCode 识别不到 conda 环境	手动输入解释器路径（`/home/lyh/miniconda3/envs/graph/bin/python`），重启 VSCode
pip 安装包慢 / 超时	加清华镜像：`pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`
中文乱码	Python 代码开头添加：`import sys; sys.stdout.reconfigure(encoding='utf-8')`

三、流程总结

核心逻辑：WSL2 挂载 Windows D 盘→安装 Miniconda 创建隔离虚拟环境→VSCode 连接 WSL2 并指定虚拟环境→运行 Python 文件；
关键命令 ：挂载 D 盘（sudo mount -t drvfs D: ~/mnt/d_drive）、激活环境（conda activate graph）、指定解释器路径；
避坑要点：Linux 严格区分大小写、conda 环境需手动指定路径、挂载失效需重新挂载并删除空文件夹。

通过以上流程，可在 WSL2 的 Linux 环境中，利用 VSCode 的可视化优势，运行 Windows D 盘的 Python 代码，兼顾 Linux 环境兼容性和 Windows 文件存储的便利性。