WSL怎么在Windows里执行python脚本

唐可
唐可
发布时间:2026-11-20| 3人浏览过
原创

详细介绍如何在Windows环境中利用WSL执行Python脚本,涵盖PowerShell/CMD直调方法、双向路径映射机制、虚拟环境配置、自动化批处理及换行符排错全流程。

WSL & Windows 跨环境互操作

在 Windows 环境下开发时,我们经常遇到某些 Python 脚本依赖 Linux 特有的编译轮子(如部分科学计算或网络底层库)、Linux 系统调用或由团队统一配置好的 WSL 依赖。此时并不需要专门进入虚拟机桌面或手动切换完整的 Linux 终端会话——通过 Windows 原生提供的 wsl.exe 互操作能力,我们能够直接在 PowerShell、CMD、批处理文件或计划任务中,一键调度 WSL 内部的 Python 解释器运行指定的脚本,并实时接收终端输出与退出代码。

WSL怎么在Windows里执行python脚本

一、核心机制:wsl.exe 是如何进行调度的

在 Windows 里执行 WSL 的 Python 脚本,其底层依赖 Windows 10/11 内置的 wsl.exe 命令行工具。该工具扮演了“进程调度隧道”和“输入输出转发器”的角色:

  • 进程启动与重定向:在 Windows 终端中敲入 wsl python3 ... 时,Windows 会通过轻量级虚拟化接口在 WSL Linux 实例内部启动 python3 进程,并将该进程的 stdin、stdout、stderr 实时重定向到 Windows 当前命令行窗口。
  • 退出状态对齐:Linux 脚本运行完毕后的退出码(Exit Code)会被直接回传给 Windows 的环境变量(PowerShell 中为 $LASTEXITCODE,CMD 中为 %ERRORLEVEL%),便于自动化脚本感知成败。
  • 路径访问互通:WSL 预先将 Windows 的所有本地磁盘自动挂载到了 Linux 的 /mnt/ 目录下(例如 C 盘对应 /mnt/c/),允许 Linux 解释器直接读写 Windows 目录下的代码文件。
WSL怎么在Windows里执行python脚本
图 1:WSL 与 Windows 进程调用与双向路径映射机制

二、基础操作:直接从 Windows 命令行运行脚本

最普遍的使用场景是在 Windows 的 PowerShell 或 CMD 中,直接向 wsl 命令传递 python3 以及脚本文件路径。

1. 脚本存放在 Windows 磁盘目录下

假设脚本位于 Windows 的 C:\projects\demo\hello.py。因为此时 Python 解释器在 WSL 内部运行,所以传递给 python3 的文件路径必须符合 Linux 挂载规范:

PowerShell / CMD 直接调用挂载路径
PS C:\> wsl python3 /mnt/c/projects/demo/hello.py
[示例输出] 脚本运行成功,当前平台为: linux, 宿主内核: 5.15.153.1-microsoft-standard-WSL2

如果你当前已经在该目录所在的工作路径(例如 C:\projects\demo),并且需要执行同目录下的 hello.py,直接写相对路径同样可行,因为 WSL 默认会继承 Windows 终端的当前工作路径:

PowerShell 当前目录相对路径执行
PS C:\projects\demo> wsl python3 hello.py
[示例输出] Hello from WSL Linux! Workdir: /mnt/c/projects/demo

2. 脚本存放在 WSL 原生 Linux 文件系统中

如果代码直接存放在 WSL 原生用户主目录(例如 /home/devuser/tasks/worker.py),在 Windows 终端中直接指定该绝对路径即可:

PowerShell / CMD WSL 原生路径调用
PS C:\workspace> wsl python3 /home/devuser/tasks/worker.py --task-id 101
[示例输出] 任务 101 处理完成,处理耗时: 0.12s
路径存储位置的性能建议
如果你的 Python 脚本涉及大量小文件读写(如机器学习数据加载、日志高频写入、大量依赖包扫描),强烈建议将代码和数据存放在 WSL 原生目录(/home/...)下。WSL2 访问原生 ext4 文件系统速度极快,而跨盘访问 /mnt/c/ 会产生 Plan9 协议的跨系统开销,IO 性能差异可达数倍。
WSL怎么在Windows里执行python脚本
图 2:在 Windows 中执行 WSL Python 脚本的标准操作步骤

三、进阶场景:指定发行版、虚拟环境与传递参数

1. 系统中安装了多个 Linux 发行版时

如果电脑上同时安装了 Ubuntu 和 Debian,默认会使用标星号的发行版。若需要强制指定 Ubuntu 中的 Python,可使用 -d(--distribution)参数:

PowerShell 指定特定发行版
PS C:\> wsl -d Ubuntu-22.04 python3 /home/dev/app.py

2. 调用 WSL 内部的虚拟环境(venv 或 conda)

绝大多数实际工程都不会直接依赖全局 python3,而是配有虚拟环境。在 Windows 下调用 WSL 虚拟环境有两种简练有效的方法:

方法 A:直接指定虚拟环境中 python 二进制的绝对路径(最稳健):
虚拟环境的本质就是把对应解释器和第三方包安装在独立目录下。直接调用其中的 bin/python,无需显式执行 source activate,解释器会自动绑定该环境下的 site-packages:

PowerShell 直接定位虚拟环境解释器
PS C:\> wsl /home/devuser/myproject_venv/bin/python /home/devuser/myproject/main.py

方法 B:通过 bash -lc 以登录 Shell 模式激活环境:
若项目深度依赖环境变量或 Conda 环境激活脚本,可以借助 bash -lc(-l 表示 login shell,会加载 ~/.bashrc 中的 PATH 配置):

PowerShell 登录 Shell 激活执行
PS C:\> wsl bash -lc "conda activate pytorch_env && python /home/dev/train.py"

3. 在 Windows 自动化脚本(.bat)中集成

如果你想把执行逻辑打包成一个双击即可运行的 Windows 批处理文件,或注册进 Windows 任务计划程序(Task Scheduler),可以在 .bat 文件中这样写:

run_task.bat Windows 批处理封装
@echo off
echo [INFO] 正在调用 WSL Linux 环境执行 Python 脚本...
wsl -d Ubuntu python3 /mnt/c/scripts/daily_sync.py --mode auto
if %ERRORLEVEL% equ 0 (
    echo [INFO] 脚本执行成功!
) else (
    echo [ERROR] 脚本执行失败,退出代码:%ERRORLEVEL%
)
pause

四、常见报错与避坑指南

跨操作系统环境执行代码往往会踩到一些隐蔽的细节坑。以下是高频问题及对应的解决方案:

WSL怎么在Windows里执行python脚本
图 3:跨系统执行常见问题排查与避坑决策树

1. 换行符异常:/usr/bin/env: 'python3 ': No such file or directory

原因:在 Windows 文本编辑器(如未配置的记事本)中创建或修改的 Python 文件,默认换行符为 CRLF( )。当 Linux 的 shebang 读取首行或特定解释逻辑时,会将多余的 (呈现为 ^M)误当做指令一部分。
解决办法:在 VS Code 底部状态栏将行尾序列从 CRLF 点击切换为 LF;或者在 Windows 终端中运行一条 Linux 命令进行转换:

PowerShell 转换文件换行符
PS C:\> wsl dos2unix /mnt/c/code/script.py

2. 模块未找到:ModuleNotFoundError: No module named 'xxx'

原因:混淆了 Windows Python 与 WSL Python。不少读者在 Windows PowerShell 里执行了 pip install pandas,此时库被装进了 Windows 的 Python 路径下,而 wsl python3 调用的是 Linux 子系统,两者文件与包环境完全隔离。
解决办法:必须在 WSL 内部安装对应依赖包:

PowerShell 在 WSL 内部安装依赖
PS C:\> wsl pip3 install pandas
# 或直接使用虚拟环境中的 pip
PS C:\> wsl /home/devuser/myenv/bin/pip install pandas

3. Windows 路径含空格与反斜杠处理

Windows 常见路径如 C:\My Documents est.py,其中的空格和 Windows 反斜杠 \ 会导致 Linux Shell 解析参数断裂。
解决办法:在 Windows 终端中可以使用 wslpath -u 动态获取正确的 Linux 路径,或者对整体路径使用引号包裹:

PowerShell 路径转换与引号保护
# 使用单引号保护 Linux 路径
PS C:\> wsl python3 '/mnt/c/My Documents/test.py'

# 在 PowerShell 中利用 wslpath 动态转换 Windows 绝对路径
PS C:\> $linuxPath = wsl wslpath -u "C:\My Documents	est.py"
PS C:\> wsl python3 $linuxPath

五、四种核心方案对比速查

为了便于在日常开发中快速选用合适的执行语法,以下将常用方案的适用场景、命令形态与特性总结如下:

WSL怎么在Windows里执行python脚本
图 4:WSL 在 Windows 中执行 Python 脚本的四种核心方案速查
调用方式 典型命令示例 适用场景 特点与优势
默认环境直调 wsl python3 /mnt/c/app.py 独立短小脚本、快速功能验证 写法最简,继承当前终端目录
虚拟环境绝对路径 wsl /path/to/venv/bin/python app.py 实际工程项目、特定版本依赖 无需 activate,依赖隔离确定性高
登录式 Shell 链式 wsl bash -lc "conda activate py39 && python app.py" 依赖 .bashrc 环境变量、复杂 Conda 矩阵 完整加载 Linux 用户环境配置
Windows 批处理封装 wsl -e python3 /mnt/c/app.py Windows 计划任务、桌面快捷双击运行 无多余弹窗,支持标准错误码捕获
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。