一文详解如何在浏览器前端运行Python程序

更新时间：2025年01月18日 09:30:43 作者：maply

这篇文章主要介绍了如何在浏览器前端运行Python程序的相关资料,在前端运行Python代码的多种方式,包括Pyodide、Brython、Transcrypt等,每种方式都有其特点和适用场景,文中通过代码介绍的非常详细,需要的朋友可以参考下

前言

在传统的 Web 开发中，Python 通常更多地被用作服务器端语言（如 Django、Flask 等），而在浏览器端（前端）通常使用 JavaScript 来操作 DOM、进行事件处理等。不过，随着 WebAssembly 技术的发展和一些 Python-to-JavaScript 转译方案的出现，我们已经可以在前端直接运行（或间接编译）Python 代码。

下面将详细介绍在前端运行 Python 程序的多种主要方式、它们的优点和局限性，并附带一些示例或基本使用思路。

一、直接在浏览器运行 Python：基于 WebAssembly 的 Pyodide

1. 什么是 Pyodide

Pyodide 是基于 WebAssembly 的一个完整 Python 解释器项目，它将 CPython（Python 的官方解释器）编译成了可以在浏览器环境（或者其它 WebAssembly 运行环境）里执行的版本。换句话说，你不需要安装任何插件，只要浏览器支持 WebAssembly，你就可以在前端环境里运行几乎完整的 Python。

2. Pyodide 的主要特点

兼容性好：几乎完整移植了 CPython，包括标准库和部分第三方库的支持（如 NumPy、Pandas 等）。
易集成：官方提供了一个 pyodide.js（或 pyodide.mjs），前端只要将其引入即可使用。
WebAssembly 性能：相较于纯 JavaScript 解释 Python 的方案，Pyodide 的性能更好。

3. 如何使用 Pyodide

引入 pyodide.js从官方的 CDN 或者本地托管，引入 Pyodide 脚本：
```
<script src="https://cdn.jsdelivr.net/pyodide/v0.23.4/full/pyodide.js"></script>
```
提示：版本号可能会不断更新，可以去 Pyodide Releases 查看最新版本。

初始化 Pyodide 环境

<script>
  async function initPyodide() {
    // 加载 Pyodide
    let pyodide = await loadPyodide();
    // 在这里就可以使用 pyodide.runPython 执行 Python 代码了
    let result = pyodide.runPython(\`
      import sys
      sys.version
    \`);
    console.log("Python version:", result);
  }
  initPyodide();
</script>

执行 Python 代码

pyodide.runPython(code) 可以直接执行一段 Python 代码字符串，并返回最后一行表达式的值（如果有）。
pyodide.globals 可以获取当前 Python 解释器中全局作用域的变量。
除了执行简单的脚本外，还可以加载第三方库（部分纯 Python 库已经预编译到 Pyodide 里）。

示例：

<script>
  async function initPyodide() {
    let pyodide = await loadPyodide();
    // 安装 / 加载一些包
    await pyodide.loadPackage("micropip");
    // micropip 可以安装更多的 Python 包，但需要兼容 WASM，如 pyodide.org 中提到的包

    // 运行简单的 Python 代码
    let code = \`
    import math
    def compute_circle_area(r):
        return math.pi * (r ** 2)
    area = compute_circle_area(5)
    \`;
    pyodide.runPython(code);
    let area = pyodide.globals.get("area");
    console.log("Circle area:", area);
  }
  initPyodide();
</script>

4. 优缺点

优点：
- 几乎完整地支持 Python 生态，能够直接使用很多 Python 包，尤其是科学计算相关。
- 依赖 WebAssembly，高度还原 CPython 功能，运行效率相对其他纯 JS 解释器更高。
缺点：
- 体积较大，需要加载编译好的 Python 解释器和相关包，初次加载可能会比较耗时。
- 并非所有 Python 包都能在 Pyodide 中使用，一些依赖本地 C/C++ 扩展的库需要专门移植。

二、Brython：将 Python 作为浏览器脚本语言

1. 什么是 Brython

Brython 是一款用 JavaScript 实现的 Python 解释器，它的目标是让 Python 可以取代前端开发中 JavaScript 的地位。它提供了一个运行时环境，使用纯 JavaScript 解释 Python 语法，并且封装了一系列 DOM 操作、浏览器接口等，使得你可以像写 JavaScript 一样来操作浏览器对象。

2. Brython 的使用

引入 Brython

<script src="https://cdn.jsdelivr.net/npm/brython@3.11.0/brython.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/brython@3.11.0/brython_stdlib.js"></script>

HTML 标记与启动在 <body> 标签中添加 onload="brython()" 或者用 JavaScript 的方式在 DOM 加载后初始化 Brython：
```
<body onload="brython()">
  ...
</body>
```
在 <script type="text/python"> 中编写 PythonBrython 允许我们直接在 HTML 文件中使用 <script type="text/python"> 标签来书写前端 Python 代码，如：
```
<script type="text/python">
from browser import document, alert

def greet(ev):
    alert("Hello from Brython!")

document["mybutton"].bind("click", greet)
</script>
```
这里 document["mybutton"] 与 JavaScript 中的 document.getElementById("mybutton") 类似。

3. 优缺点

优点：
- 使用非常简单，直接 <script type="text/python"> 就能写代码。
- 对 DOM 操作进行了一定的封装，可以让 Python 代码操作浏览器 API。
- 代码体积相对 Pyodide 更小（毕竟没有完整移植 CPython）。
缺点：
- Brython 并不包含完整的 Python 标准库实现，某些场景下功能有限。
- 由于是纯 JavaScript 解释，需要考虑性能影响，复杂运算性能可能远低于 WebAssembly 方案。
- 一些 Python 第三方库可能无法直接使用，或需要依赖特定的 Polyfill。

三、Transcrypt：Python 转译成 JavaScript

1. 什么是 Transcrypt

Transcrypt 是一个将 Python 代码编译成高质量、可读性较高的 JavaScript 代码的工具。可以在开发阶段用 Python 编写逻辑，然后通过 Transcrypt 将其编译成 JavaScript，最终在浏览器端运行的还是 JavaScript。

2. 工作流程

安装 Transcrypt：
```
pip install transcrypt
```
使用 Transcrypt 编译 Python 文件：
```
transcrypt -b -m myscript.py
```
- -b 表示在浏览器模式下编译（browser）。
- -m 表示生成映射文件（source map）。
编译完成后，会生成一个 __javascript__ 文件夹，里面有 myscript.js 以及依赖文件。

在 HTML 中引入编译后的 JS 文件：

<script src="__javascript__/myscript.js"></script>

这样，就可以在浏览器端使用转换后的 JS 逻辑。

3. 优缺点

优点：
- 保持了 Python 语法的开发体验。
- 得到的 JavaScript 体积相对较小，且没有额外的运行时依赖。
- 编译后的速度与 JavaScript 本身类似（毕竟最终产物是 JS）。
缺点：
- 并不是在浏览器里直接执行 Python，而是将 Python 转译成 JS，某种程度上要对 Python 语法有一定限制。
- 对于 Python 的某些动态特性和部分库支持不完美。

四、Skulpt、RapydScript 等其他方案

除上述方案外，还有一些项目也能帮助在前端运行（或近似运行）Python：

Skulpt
- 纯 JavaScript 实现的 Python 解释器。
- 支持 Python 语法的子集，适用于教学或简单脚本场景。
- 不支持完整标准库。
RapydScript
- 一种 Python-like 语法，编译成高效的 JavaScript。
- 更接近于一种独立的语言，兼具 Python 与 JavaScript 的特性。
Trinket、Replit 等在线平台
- 通过远程服务器或 WebAssembly 内嵌的方式，在网页里直接运行 Python 代码。
- 适合教学、演示或小型项目试验。

五、适合不同场景的选择建议

如果你希望在浏览器端完整运行 Python 并使用科学计算库（如 NumPy、Pandas 等）
- Pyodide 是首选方案，但要注意加载速度、兼容性以及内存使用。
如果你想在前端用 Python 语法来操作 DOM，替代部分 JavaScript 功能
- Brython 可以尝试，不过要注意第三方库的支持以及性能。
如果你的核心需求仍然是将 Python 逻辑转成最终的 JavaScript
- Transcrypt 可以帮助你在保持 Python 开发体验的同时，得到优化后的纯 JS 代码。
如果你是教学或简单的 Python 脚本交互
- Skulpt、Trinket 这类项目或在线平台可以快速上手，但功能相对有限。

六、总结

在浏览器里运行 Python 不再是遥不可及的想法，随着 WebAssembly 的普及和多种 Python-to-JavaScript 解决方案的出现，前端与 Python 生态之间的融合将越来越紧密。选择具体方案时，需要综合考虑：

是否需要大量使用 Python 第三方库？
对性能与包体积的要求如何？
是否需要调用浏览器的 DOM 或 Web API？
是否只是教学、实验，还是要应用到生产环境？

无论是直接基于 WebAssembly 的 Pyodide、JavaScript 实现的 Brython，还是把 Python 编译/转译为 JavaScript 的 Transcrypt，都是在不同场景下可选的思路。未来，随着 Web 技术的进一步发展，前端与 Python 的结合也会更容易、更高效。希望以上介绍能帮助你更好地理解和选择前端运行 Python 的最佳方式。

到此这篇关于如何在浏览器前端运行Python程序的文章就介绍到这了,更多相关浏览器前端运行Python程序内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解django2中关于时间处理策略
这篇文章主要介绍了详解django2中关于时间处理策略，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-03-03
python实现的阳历转阴历（农历）算法
这篇文章主要介绍了python实现的阳历转阴历（农历）算法,需要的朋友可以参考下
2014-04-04
Django models文件模型变更错误解决
这篇文章主要介绍了Django models文件模型变更错误解决,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-05-05
使用wxPython和OpenCV实现手势识别相机功能
在这篇博客中,我将分享一个有趣的 Python 项目：通过 wxPython 创建图形界面,利用 OpenCV 的计算机视觉技术实现实时手势识别,以下是项目的完整实现过程,包括代码分析、使用说明和可能的优化建议,需要的朋友可以参考下
2025-04-04
详解python命令提示符窗口下如何运行python脚本
这篇文章主要介绍了详解python命令提示符窗口下如何运行python脚本，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09
Python基于opencv实现的人脸识别(适合初学者)
OpenCV是一个基于BSD许可开源发行的跨平台计算机视觉库,下面这篇文章主要给大家介绍了关于Python基于opencv实现的人脸识别，文中通过实例代码介绍的非常详细,本文的教程非常适合初学者,需要的朋友可以参考下
2022-03-03
详解Python如何使用PyBuilder从零开始构建项目
PyBuilder是一个用于构建Python项目的工具,它提供了一种简单而强大的方式来管理项目的依赖、运行测试、生成文档等任务,下面就跟随小编一起来学习一下如何使用PyBuilder构建项目吧
2024-03-03
python:接口间数据传递与调用方法
今天小编就为大家分享一篇python:接口间数据传递与调用方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-12-12
Python 使用@property对属性进行数据规范性校验的实现
本文主要介绍了Python 使用@property对属性进行数据规范性校验的实现，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-10-10
探索Python列表合并技术提高代码灵活性
本文将深入研究Python中列表合并的几种方法，通过详细的示例代码和细致的解释，呈现一场关于列表操作的精彩探险，无论是初学者还是有经验的开发者，通过学习本文，将更加熟练地运用这些方法，提升代码的效率和可读性
2024-01-01