pyscript加载失败主因是py-config配置错误或cdn资源不可达，需确保py-config在body顶部、显式指定pyodide_url，并用network面板验证；import失败因pandas等含c扩展包须用micropip动态安装；dom交互卡顿应避免频繁innerhtml操作；本地开发必须启用http服务规避cors限制。
PyScript 加载失败：检查 py-config 和 CDN 资源可用性
PyScript 页面白屏或控制台报 Failed to load PyScript，八成是配置没生效或资源加载中断。PyScript 不是“引入 JS 就能跑 Python”，它依赖 py-config 声明运行时行为，且默认从 jsdelivr 加载 Pyodide 核心包——国内访问不稳定时会静默失败。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确保
<py-config></py-config>在顶部（不能在<script></script>后面），且闭合正确（） - 显式指定 Pyodide 版本和 CDN 源，避免被重定向到不可达地址：
<py-config> packages = ["numpy"] pyodide_url = "https://cdn.jsdelivr.net/pyodide/v0.24.1/full/pyodide.js" </py-config>
- 用浏览器开发者工具 Network 面板过滤
pyodide.js，确认状态码为 200；若失败，换国内镜像（如 unpkg.com 或自托管）
Pyodide 中 import 失败：区分标准库、纯 Python 包与 C 扩展
写 import pandas 报 ModuleNotFoundError 很正常——Pyodide 只预装了标准库 + 少量常用纯 Python 包（如 requests、numpy），pandas、scikit-learn 这类含 C 扩展的包无法直接用 packages 加载。
实操建议：
立即学习“Python免费学习笔记（深入）”；
-
packages只支持纯 Python 包（如pyyaml、markdown），且需 PyPI 上有 wheel 文件并标记pyodide兼容 - 含 C 扩展的包（
pandas、matplotlib）必须走micropip动态安装，且仅限 Pyodide 官方构建的版本：import micropip await micropip.install("pandas==2.0.3") - 安装耗时长（尤其首次），务必加
async/await，别在同步函数里调用；否则卡死主线程，页面无响应
PyScript 与 DOM 交互卡顿：避免频繁调用 Element.innerHTML 和同步计算
用 document.getElementById("out").innerHTML = result 更新结果，数据一多就明显卡顿。PyScript 运行在 Web Worker 中，但 DOM 操作仍走主线程，频繁跨线程通信 + 字符串拼接会拖垮体验。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 改用
Element.set_text()或Element.create() + Element.append()，它们内部做了批量更新优化 - 复杂渲染逻辑（如表格、图表）先在 Python 侧生成完整 HTML 字符串，再单次写入
innerHTML，而非循环追加 - 耗时计算（如 CSV 解析、数值拟合）用
asyncio.to_thread()或pyodide.ffi.create_proxy()转移至 Worker，别阻塞 UI 线程
本地开发时 CORS 报错：Pyodide 不允许 file:// 协议加载包
双击 HTML 文件打开，控制台报 Blocked by CORS policy: Cross origin requests are only supported for protocol schemes，这是 Pyodide 的硬限制——它要求所有资源通过 HTTP(S) 提供，file:// 协议下 micropip.install() 和 py-config packages 全部失效。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 本地开发必须起 HTTP 服务：Python 用户用
python -m http.server 8000，VS Code 安装 Live Server 插件点一下即可 - 不要试图绕过 CORS（比如改浏览器启动参数），Pyodide 底层依赖 Fetch API，协议校验无法跳过
- 生产部署时确保所有静态资源（.py、.js、.wasm）同域，避免跨域请求触发二次失败
PyScript 不是“前端写 Python”的快捷键，它是把 Pyodide 这个重型科学计算运行时塞进了浏览器——兼容性、包生态、性能边界都得按 Pyodide 的规则来。最常被忽略的是：它没有全局 Python 环境，每个 <py-script></py-script> 是独立上下文，变量不共享；想复用就得显式导出/导入，或者用 pyodide.globals 手动挂载。
