科学计算开发工具【免费下载链接】pyodidePyodide is a Python distribution for the browser and Node.js based on WebAssembly项目地址https://gitcode.com/gh_mirrors/py/pyodide点击查看免费下载导读本文讲解 Pyodide 在 Node.js 运行时中启用 socket 能力的官方方案pyodide.useNodeSockFS()。由于浏览器不提供底层 socket APIPyodide 默认在浏览器环境直接报错而在 Node.js 中你可以通过这一实验性 API 让 Python 的socket模块、asyncio网络操作以及 pymysql、pg8000、redis-py 等数据库驱动正常工作。读完本文你将掌握启用前提Node.js 版本与 JSPI 标志、完整的 JavaScript 与 Python 示例、底层实现原理NodeSockFS、WinterCG Sockets、syscall 挂钩以及已知限制。实验性警告该特性处于实验阶段未来版本可能变更或移除且仅在 Node.js 中可用浏览器不支持。1. 为什么浏览器里没有 socketNode.js 却能支持Pyodide 是构建在 WebAssembly 之上的 Python 发行版。浏览器的安全模型与 Web 平台没有提供标准的底层 socket API因此 Pyodide 默认不包含浏览器端 socket 实现——在浏览器中执行任何使用 socket 的代码都会抛出错误。Node.js 则不同它拥有完整的网络能力node:net、node:tls。Pyodide 因此在 Node.js 侧提供了一套实验性的 socket 实现JavaScript 层用NodeSockFS替换 Emscripten 默认的 SOCKFS底层传输基于WinterCG Sockets API见 src/js/fs/nodesockfs.ts 与 src/js/fs/wintercg-sockets.ts内核层通过 src/core/socket_syscalls.c 对connect、recvfrom、sendto、poll、shutdown、fcntl64等 syscall 进行包装把 NodeSock 文件描述符上的操作路由到异步实现Python 的asyncio事件循环webloop也通过_nodeSock桥接层直接调用 Node.js 的异步 socket 操作见 src/py/pyodide/webloop.py。2. 启用 socket 支持2.1 在 JavaScript 中调用 useNodeSockFS()关键要求必须在导入任何使用 socket 的 Python 模块之前调用await pyodide.useNodeSockFS()const pyodide await loadPyodide(); await pyodide.useNodeSockFS();该 API 的实现在 src/js/api.ts 中定义在非 Node.js 环境调用会直接抛出useNodeSockFS only works in Node错误它会初始化 NodeSockFS动态加载node:net/node:tls/node:stream把Module.SOCKFS.createSocket与Module.SOCKFS.pollAsync替换为 NodeSockFS 的实现并挂载一个伪文件系统节点详见 src/js/fs/nodesockfs.ts。提示useNodeSockFS接受一个可选参数options.connect可以传入自定义的 connect 函数需满足 WinterCG socket-api 接口该设计主要用于 Cloudflare Workers 等环境见 src/js/fs/nodesockfs.ts。2.2 JSPIJavaScript Promise Integration前提该特性依赖 JavaScript Promise IntegrationJSPI因为同步的 Python socket 调用在 WASM 栈上阻塞时需要通过WebAssembly.Suspending挂起栈、等待异步操作完成后恢复见 src/core/socket_syscalls.c 中对 GIL 与syscall_syncify()的说明。Node.js 版本是否需要额外参数Node.js 22–24需要显式开启node --experimental-wasm-jspiNode.js ≥ 25JSPI 默认启用无需额外参数# Node.js 22–24 node --experimental-wasm-jspi your_script.mjs2.3 命令行入口已内置支持仓库的 Node 命令行入口 src/templates/python_cli_entry.mjs 在启动 Python REPL 时会自动尝试调用py.useNodeSockFS()失败仅打印警告而不中断方便直接以node --experimental-wasm-jspi python_cli_entry.mjs的形式体验。2.4 环境变量与构建仓库通过 pyodide_env.sh 与 Makefile.envs 管理构建环境。若你从源码构建 Pyodide 用于 Node.js请确保构建时启用了 JSPI 相关的编译选项PYODIDE_JSPI相关开关运行环境则按上表确保 JSPI 可用。3. 在 Python 中直接使用 socket完成上述设置后Python 的socket模块即可像原生环境一样工作。文档给出的完整示例import socket # Create a socket s socket.socket(socket.AF_INET, socket.SOCK_STREAM) # Connect to a server s.connect((localhost, 8080)) # Send some data s.sendall(bHello, world) # Receive some data data s.recv(1024) print(Received, repr(data)) # Close the socket s.close()源码级佐证仓库的 src/tests/test_python_socket.py 使用selenium_nodesockfixture 对上述场景做了大量覆盖包括基本连接与数据收发test_socket_connect多次 send/recvtest_socket_multiple_send_recv大数据量传输test_socket_large_data_transfer、test_socket_large_recvgetpeername/getsockname/fileno等辅助方法连接被拒ECONNREFUSED、对端关闭后收发、部分读写、EOF、双重 close、shutdown等边界情况并发场景test_socket_asyncio_concurrent用asyncio.gather并发操作多个 socketsocket.makefile()基于行的 I/O。这些测试证明该实现不仅支持最基础的 TCP 收发还覆盖了错误码、非阻塞语义与超时等细节。4. 配合数据库驱动使用许多数据库驱动依赖 socket 连接数据库服务器。启用 socket 支持后在 Node.js 上运行的 Pyodide 即可使用这些驱动。文档给出的 pymysql 示例import pymysql # Connect to the database connection pymysql.connect(hostlocalhost, useruser, passwordpassword, databasetest) # Create a cursor cursor connection.cursor() # Execute a query cursor.execute(SELECT * FROM my_table) # Fetch the results results cursor.fetchall() print(results) # Close the connection connection.close()仓库的 src/tests/test_database_driver.py 提供了更丰富的验证矩阵均使用selenium_nodesockfixtureMySQLpymysql、aiomysql并含 TLS 场景test_mysql_pymysql_tlsPostgreSQLpg8000Redisredis-pyORMSQLAlchemy同时对接 MySQL 与 PostgreSQL。这表明只要目标驱动走标准 TCP socketAF_INET / SOCK_STREAM就可以在 Pyodide Node.js 中直接跑通真实数据库业务。5. 底层实现原理5.1 NodeSockFS替换 Emscripten 的 SOCKFSNodeSockFS 是 Node.js 原生 socket 文件系统以 WinterCG Sockets API 为传输层在两个上下文中被使用见 src/js/fs/nodesockfs.ts替换 socket 系统调用JSPI 路径同步的 Pythonsocket.connect/recv/send通过WebAssembly.Suspending挂起 WASM 栈等待异步操作完成后再恢复asyncio webloop 路径异步事件循环的 socket 函数sock_connect、sock_recv、sock_sendall通过API._nodeSock桥接直接调用 NodeSockFS见 src/py/pyodide/webloop.py。每个 socket 在内部对应一个NodeSock结构包含 WinterCG socket、ReadableStream reader、WritableStream writer、接收缓冲区recvBuffer、EOF 状态以及阻塞模式下的dataAvailable可解析 Promise 等字段。5.2 支持的地址族与类型重要限制在 createSocket 中做了严格校验仅支持 AF_INETIPv4其它地址族抛EAFNOSUPPORT仅支持 SOCK_STREAMTCPSOCK_DGRAMUDP抛EOPNOTSUPP其它类型抛EINVAL协议仅接受IPPROTO_TCP服务器端操作未实现bind、listen、accept全部抛EOPNOTSUPP见 src/js/fs/nodesockfs.ts。也就是说当前只能作为客户端发起连接不能作为服务器监听端口。5.3 syscall 挂钩与 JSPI 同步src/core/socket_syscalls.c 用__wrap_系列函数重写__syscall_connect、__syscall_recvfrom、__syscall_sendto、__syscall_poll、__syscall_shutdown、__syscall_fcntl64每个_maybe_*_async辅助函数先检查 fd 是否属于 NodeSock存在sock_ops.connectAsync/recvmsgAsync等非 NodeSock fd 返回 null 并回落到 Emscripten 原始实现保证兼容性对 NodeSock fd把异步操作封装成 Promise交给syscall_syncify()完成保存状态 → 挂起 → 等待 Promise → 恢复状态的完整周期CPython 的socketmodule.c在进入 syscall 前已释放 GILsendto在跨异步边界前先把数据从HEAPU8拷贝出来避免 WASM 内存增长导致指针失效setsockopt被重写为总是返回成功避免 Emscripten 桩实现返回ENOPROTOOPT而破坏依赖该调用的应用。5.4 WinterCG Sockets API 封装wintercg-sockets.ts 提供了connect()与Socket类通过node:net/node:tls建立连接再借助stream.Duplex.toWeb转成 Web 标准的ReadableStream/WritableStream同时暴露opened/closedPromise 与可选的startTls()升级能力。它采用动态import()加载 Node 模块因此该文件在浏览器构建中也能被安全导入而不产生顶层 Node 依赖。5.5 非阻塞与 poll 语义NodeSockFS 实现了与 Emscripten SOCKFS 风格一致的poll/pollAsync可读POLLRDNORM | POLLIN缓冲区有数据或到达 EOF可写POLLOUT已连接且有 writer挂起POLLHUP底层传输已关闭非阻塞 recv 在无数据时返回-EAGAIN超时通过Promise.race([waitForData(sock), sleep(timeout)])实现见 src/js/fs/nodesockfs.ts。这保证 CPython 基于poll() 超时的 socket 超时机制在 Node.js 下正常工作。6. 已知限制与注意事项限制项说明浏览器不可用仅 Node.js浏览器调用useNodeSockFS直接抛错webloop 中的 socket 方法也会抛NotImplementedError仅 IPv4 TCP 客户端无 UDP、无 IPv6、无服务器端 bind/listen/acceptJSPI 依赖Node.js 22–24 必须加--experimental-wasm-jspi≥ 25 默认开启实验性官方明确可能变更或移除NodeSockFS 依赖 Emscripten 内部结构源码中留有 FIXME见 src/js/fs/nodesockfs.ts调用时机必须在导入任何使用 socket 的 Python 模块之前调用useNodeSockFS()TLS底层 WinterCGSocketOptions.secureTransport支持off/on/starttls三态数据库 TLS 场景如 pymysql TLS 测试已覆盖7. 快速上手清单使用 Node.js ≥ 25或 Node.js 22–24 时以node --experimental-wasm-jspi启动加载 Pyodide 后、导入 socket 相关 Python 模块前执行await pyodide.useNodeSockFS()在 Python 中正常import socket编写客户端代码AF_INET SOCK_STREAM或接入 pymysql / pg8000 / redis-py 等数据库驱动如需深入验证行为参考 src/tests/test_python_socket.py 与 src/tests/test_database_driver.py 中的测试用例。关联文档docs/usage/socket.md核心实现src/js/fs/nodesockfs.ts、src/core/socket_syscalls.cAPI 定义src/js/api.ts。赞分享科学计算开发工具【免费下载链接】pyodidePyodide is a Python distribution for the browser and Node.js based on WebAssembly项目地址https://gitcode.com/gh_mirrors/py/pyodide点击查看免费下载相关推荐3分钟快速上手番茄小说下载器完整使用指南3分钟快速上手番茄小说下载器完整使用指南 你是否经常遇到网络小说想读却无法离线保存的烦恼番茄小说下载器正是为你解决这一痛点的终极工具这是一款基于Rust开科学计算开发工具如何在Node.js中使用Redis图数据库完整实战指南如何在Node.js中使用Redis图数据库完整实战指南 Redis图数据库RedisGraph是Redis Stack中强大的图数据库模块它基于属性图后端数据库客户端缓存终极QuickDraw Dataset指南零基础掌握Python与Node.js API使用技巧终极QuickDraw Dataset指南零基础掌握Python与Node.js API使用技巧 QuickDraw Dataset是一个包含5000万幅手绘数据集上一篇wgpu粒子系统大规模粒子效果渲染下一篇如何永久保存微信聊天记录3步掌握WeChatMsg数据备份终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考