编程语言语言运行时编译器前端【免费下载链接】brythonBrython (Browser Python) is an implementation of Python 3 running in the browser项目地址https://gitcode.com/gh_mirrors/br/brython点击查看免费下载本指南以 Brython 官方 FAQwww/doc/en/faq.md为骨架围绕浏览器端 Python 运行时最常见的疑问——性能表现、import 机制、404 报错、预编译缓存与 DOM 树构建语法——逐项给出权威解答并结合仓库源码py_import.js、loaders.js、py_dom.js剖析其底层实现。读完本文你将能准确判断 Brython 的适用场景、排查导入类报错、利用标准库预编译缓存优化加载性能并理解其面向 DOM 操作设计的特殊语法。一、Brython 是什么哪些浏览器支持问Brython 这个名字是什么意思答Brython 是Browser Python的缩写即浏览器中的 Python。它同时还是威尔士语中说布立吞语的凯尔特人brittonic-speaking Celt一词恰好与项目定位形成双关。问哪些浏览器支持 Brython答所有现代浏览器都支持包括智能手机上的浏览器。其关键设计约束是Brython 生成的 JavaScript 刻意避免使用尚未被大多数浏览器支持的新语法从而保证在主流浏览器环境中都能稳定运行。这一点在编译目标选择上贯穿始终是 Brython 与仅面向最新浏览器特性的方案之间的重要区别。二、性能对比Brython 与 CPython问Brython 相比 CPython 的性能如何答仓库中的性能对比页面www/speed/index.html在 Firefox 上用最新版 Brython 与 CPython 对比了一批基础操作的执行时间。结果显示不同操作的比值差异很大但整体上两者处于同一数量级order of magnitude。仓库还附带一个本地基准脚本启动服务器后访问localhost:8000/speed_即可在本地机器上对一系列基础操作逐一比较 Brython 与 CPython 的速度。对应页面由 www/speed/speed.py 驱动基准用例存放在 www/speed/benchmarks/如 fib.py、pystone.py、spectral-norm.py 等覆盖整数/浮点运算、字典与列表构建、函数调用、类实例创建、字符串与哈希等典型负载可自行运行验证。需要强调的是性能数据随操作类型、浏览器和机器差异显著不应一概而论实际项目中应以本机基准为准。三、性能对比Brython 与 JavaScript问Brython 相比 JavaScript 的性能如何答与 JavaScript 相比不同程序之间的性能比值差异天然很大。Brython 发行版附带了一个 JavaScript 控制台页面www/tests/js_console.html可以在其中运行 JavaScript 程序并在编辑器中取消勾选 debug 选项后运行等价的 Python 程序从而直接对比两者的执行时间。性能差距主要来自两个因素运行时翻译开销Python 代码需要在浏览器中即时翻译为 JavaScript。作为量级参考标准库datetime模块2130 行 Python 代码在普通 PC 上解析并转换为 JavaScript 约需 0.5 秒。语义合规导致的非优化代码Brython 生成的 JavaScript 必须符合 Python 语言规范包括属性查找attribute lookup的动态性——运行时才能确定属性解析结果这使生成的代码无法像手写 JavaScript 那样被深度优化。这两点决定了 Brython 的适用定位追求极致性能、对体积敏感的场景应优先考虑原生 JavaScript需要 Python 语法、标准库生态与快速迭代的开发场景才是 Brython 的价值所在。四、浏览器控制台大量 404 报错import 机制详解问运行 Brython 脚本时浏览器控制台出现大量 404 错误为什么答这是 Brython 的 import 机制导致的正常现象。当脚本需要导入模块 X 时Brython 会在多个目录中依次查找文件或包标准库JavaScript 模块在libs目录www/src/libs/Python 模块在Lib目录www/src/Lib/第三方库目录Lib/site-packageswww/src/Lib/site-packages/当前页面所在目录。查找过程中Brython 会向对应的 URL 发出 Ajax 请求若文件不存在浏览器会在控制台写入 404 错误消息但该错误会被 Brython 捕获并继续查找直到找到模块或所有路径都尝试完毕仍未命中时抛出ImportError。从源码看导入的最终落点位于 py_import.js 中的$B.$import见 www/src/py_import.js#L1378函数会解析相对导入处理.、..层级、规范化模块名、调用__import__执行真正的加载并在模块无法找到或加载时抛出ImportError如 www/src/py_import.js#L1614 的cannot import name分支。因此404 本身并不可怕它只是逐路径探测过程的中间产物只有当最终抛出ImportError时才说明模块确实没有被找到。五、同步 XMLHttpRequest 弃用警告问为什么浏览器控制台出现 Synchronous XMLHttpRequest on the main thread is deprecated... 警告答这同样与 import 和文件读取机制相关。为了实现这些操作Brython 使用阻塞式blockingAjax 调用被导入的模块必须先加载完毕才能被使用这是 Python import 语义的硬性要求。浏览器厂商短期内不会移除阻塞调用因此该警告在可预见的未来仍会存在。它是 Brython 为保证 import 语义正确性而付出的必要代价可以放心忽略。六、能否预编译脚本以缩短执行时间问能否预编译 Brython 脚本以减少执行时间答Brython 的设计目标是与 JavaScript 一样简单直接地运行把 Python 代码放进 HTML 页面的script标签、加载页面、修改代码、重新加载页面即可。它不同于其他先用 CPython 脚本把 Python 翻译成 JavaScript的项目——后者每修改一次代码都必须重新运行翻译脚本再刷新页面。另一个不建议预编译的原因是Brython 生成的代码通常比原始 Python 源码大 10 倍左右——这是为符合语言规范付出的代价。预编译会让页面加载更慢而官方也未发现预编译比即时编译更快的证据。不过自 3.6.0 版本起情况有了重要改进标准库脚本的预编译版本会被存入浏览器自带的indexedDB 数据库。首次导入某个脚本时执行编译此后若 Brython 版本未变则直接复用缓存大幅缩短导入加载时间。这一机制的底层实现在 loaders.js 中清晰可见数据库名为brython-cache对象仓库objectStore名为modules以模块名name作为 keyPath见 www/src/loaders.js#L198-L201缓存有效性通过时间戳双重校验记录的timestamp必须等于当前 Brython 引擎时间戳且source_ts必须与模块所在 VFS 文件的时间戳一致见 www/src/loaders.js#L173-L175缓存未命中时代码会从brython_stdlib.js中读取源码必要时经 VFS重新编译并把编译结果连同其内部 import 列表写回缓存idb_load回调会解析res.imports并递归预取子模块见 www/src/loaders.js#L67-L105若 indexedDB 无法打开如隐私模式则优雅降级$B.idb_cx置空、indexeddb选项关闭继续以无缓存方式运行见 www/src/loaders.js#L204-L210。配合python -m brython --modules生成的 VFS其时间戳会覆盖引擎默认时间戳见 www/src/loaders.js#L7-L11这套缓存机制能让标准库的重复导入近乎瞬时完成。七、导入标准库模块失败brython_stdlib.js 缺失问尝试从 Brython 标准发行版导入模块却报错为什么答最可能的原因是页面中没有引入brython_stdlib.js脚本。标准库的 Python 模块与 JavaScript 模块分别打包在 www/src/brython_stdlib.js 中只有引入该脚本import语句才能解析到这些模块。正确的最小页面结构是在引入brython.js之后、body结束前按顺序引入两个脚本script typetext/javascript srcbrython.js/script script typetext/javascript srcbrython_stdlib.js/script body onloadbrython()仓库中的测试页面提供了可直接参照的用法例如 www/tests/console.html#L67 与 www/tests/editor.html#L61 都在页面中显式加载了brython_stdlib.js。值得注意的是部分测试页如 www/tests/index.html#L76将其注释掉恰好演示了缺失 stdlib 时标准库导入不可用的行为差异。八、模块兼容性边界并非所有 CPython 模块都能导入问能否导入所有在 CPython 下运行的模块 / 包答不能。只有完全用 Python 编写的模块才能被 Brython 支持使用C 扩展的程序无法运行典型如NumPy、Matplotlib、Pandas调用浏览器上下文不可用的操作系统原语的模块同样受限。例如requests依赖 IP 协议栈向任意 URL 发起 HTTP 请求而浏览器只能向同域发送 Ajax 请求除非目标站点支持跨域 CORS因此这类模块无法在 Brython 中工作。这意味着选型时必须检查依赖链若第三方库或其传递依赖涉及 C 扩展或系统级 API就需要寻找纯 Python 替代方案。Brython 标准库中的纯 Python 实现列表可参考 www/src/Lib/ 目录含email、json、logging、urllib等并可通过 www/src/Lib/VFS_import.py 等机制加载。九、为什么用运算符构建 DOM 树问为什么用运算符来构建 DOM 元素树这不符合 Python 风格答Python 没有内置的树操作结构即没有现成的方式为树节点添加子节点或兄弟节点。这类操作当然可以用函数实现但 Brython 选择运算符方案理由是其更易输入无需括号且可读性更强添加兄弟节点使用运算符添加子节点使用运算符原因如下它的形状像左箭头——值得注意的是Python 的函数注解恰好也因箭头形状而引入了新运算符-不会与小于等于混淆因为一行单独的document elt若被理解为比较运算将是无操作no-op而小于等于总是出现在条件或函数返回值中在 Python 中已用于集合运算且含义不同于小于等于Python 本来就对同一个运算符%承载了取模与字符串格式化两种截然不同的操作运算符复用并非新鲜事标准库的pathlib模块同样用运算符/来构建文件系统路径为运算符表达领域语义提供了先例。从源码看与并不是魔法而是映射到了底层的节点挂载函数在 py_dom.js 中__le__运算符被路由到DOMNode.tp_funcs.attach见 www/src/py_dom.js#L832-L833而attach是向节点追加子元素的真正实现见 www/src/py_dom.js#L936并且是节点公开的常规方法出现在__dir__列表中见 www/src/py_dom.js#L1473。因此对运算符重载过敏的开发者完全可以用更传统的写法from browser import document # 运算符写法 document[container] document.createElement(div) # 等价的方法写法 document[container].attach(document.createElement(div))两种写法行为一致按项目风格与个人偏好选择即可。十、FAQ 技术要点速查疑问结论要点源码/文档依据Brython 含义Br(owser) Python源自威尔士语www/doc/en/faq.md浏览器支持所有现代浏览器含移动端JS 输出避开新语法www/doc/en/faq.md与 CPython 性能同数量级因操作而异可本地跑localhost:8000/speed_基准www/speed/benchmarks/与 JavaScript 性能差距源于即时翻译 动态属性查找的语义合规开销www/tests/js_console.html控制台 404import 逐路径探测的副产品最终未命中才抛ImportErrorwww/src/py_import.js#L1378同步 XHR 警告阻塞式加载是 import 语义要求可忽略www/doc/en/faq.md预编译不推荐整体预编译3.6.0 起标准库缓存于 indexedDBwww/src/loaders.js标准库导入失败检查是否引入brython_stdlib.jswww/tests/console.html#L67CPython 兼容性仅纯 Python 模块C 扩展NumPy/Pandas 等与系统 API 模块不可用www/doc/en/faq.md建 DOM 树运算符映射到attach()添加兄弟节点www/src/py_dom.js#L832、www/src/py_dom.js#L936总结Brython FAQ 表面上是零散的问答实则勾勒出该运行时最重要的三条设计主线以浏览器中直接运行 Python为最高优先级因此不做整体预编译、生成跨浏览器兼容的 JS以 Python 语义合规为不可妥协的底线因此有阻塞式加载、动态属性查找带来的性能开销、运算符这类为语义清晰度做出的设计取舍以标准库可用性为生态支撑因此要求引入brython_stdlib.js并借助 indexedDB 缓存缓解导入性能。理解这三条主线就能在遇到 404、同步 XHR 警告、导入失败等问题时快速定位原因也能在项目选型时准确判断 Brython 的能力边界。赞分享编程语言语言运行时编译器前端【免费下载链接】brythonBrython (Browser Python) is an implementation of Python 3 running in the browser项目地址https://gitcode.com/gh_mirrors/br/brython点击查看免费下载相关推荐Brython 编译与运行机制深度解析从 Python 源码到浏览器中的 JavaScriptBrython 编译与运行机制深度解析从 Python 源码到浏览器中的 JavaScript 本篇技术指南以 Brython 官方文档 www/doc/en编程语言语言运行时编译器前端Brython 包.brython.js完全指南生成、部署与浏览器端导入机制解析Brython 包.brython.js完全指南生成、部署与浏览器端导入机制解析 本篇指南系统讲解 BrythonBrowser Python项目中编程语言语言运行时编译器前端Brython革命性浏览器Python如何在浏览器中运行Python 3的完整指南Brython革命性浏览器Python如何在浏览器中运行Python 3的完整指南 Brython Browser Python 是一个革命性的Python编程语言语言运行时编译器前端上一篇SpacetimeGaussians自定义开发指南创建新的表示与渲染管道下一篇如何深度定制Windows系统字体No!! MeiryoUI终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考