⚠️ 这篇是写给只会用聊天型大模型、最近开始想跟进 AI 新工具的人。你刚刷到“给 Pyodide 发 WASM 包到 PyPI”这类消息,最容易做错的,不是没跟上,而是先按错题做判断。你以为省了 10 分钟,后面可能多花 2 小时去查编译链;如果只盯表面热闹,就会把时间、预算和注意力花错地方。

这次真正会改掉判断的,不是“终于能编了”,而是很多纯 Python 包,也就是只有 Python 代码的包,本来就不用先碰那条路。纯 Python 包缺的不是 WASM(浏览器里的编译产物),是 py3-none-any 这种标准轮子文件。[C002]

证据很直接。Pyodide(浏览器里跑 Python 的环境)的文档写得很明白:纯 Python 包不需要 pyodide-build 这套专门打包工具;用 python -m buildhatchflit 做出来的标准轮子就能兼容,只有带编译扩展的包才该走那套工具链。[C003] 另一个常见误判也被常见问题页说透了:micropip 找不到包,常见原因不是“不支持”,而是 PyPI(Python 包仓库)上根本没有 *py3-none-any.whl;真有二进制扩展,才需要交叉编译。[C004]

Publishing WASM wheels to PyPI for use with Pyodide 这条消息值不值得跟?先别急着搜教程,先看自己的包有没有 py3-none-any.whl。[C001] 一条更新值不值得看,不看它列了多少功能,先看它会不会改掉你下一步的判断。你身边如果也有人老在这一步绕路,把这句转给他就够了。