PyGWalker 开发环境遇到 Missing PyGWalker frontend asset 错误怎么解决？

PyGWalker 开发环境遇到 Missing PyGWalker frontend asset 错误怎么解决【免费下载链接】pygwalkerPyGWalker: Turn your dataframe into an interactive UI for visual analysis项目地址: https://gitcode.com/GitHub_Trending/py/pygwalker在本地克隆 PyGWalker 源码、装好 Python 侧依赖后进入开发模式第一次调用pyg.walk()就可能抛出RuntimeError报错形如Missing PyGWalker frontend asset: pygwalker/templates/dist/...。这不是数据或代码问题而是前端 JS 产物bundle还没有构建出来PyGWalker 的前端 UI 编译进pygwalker/templates/dist/该目录被 git 忽略、只由构建流程生成开发模式下 anywidget 直接从这个目录读文件文件不存在就会在渲染前抛错。本文基于 DEVELOPMENT.md 的 Troubleshooting 一节与 AGENTS.md给出在源码检出source checkout环境中补上构建、恢复运行的完整路径。错误从哪来两条抛出路径两处报错都在 pygwalker/utils/frontend_assets.pyfrontend_asset_pathlib()开发模式PYGWALKER_DEV1或ANYWIDGET_HMR1下由 pygwalker/services/anywidget_widget.py 的_resolve_widget_esm()调用。此时_esm是dist/pygwalker-app.es.js的文件路径而不是内嵌字符串文件不存在就抛错提示先运行python scripts/dev.pydev watch或cd app yarn build。read_frontend_asset()普通非开发模式读取同一文件抛错时提示在仓库根目录运行./scripts/compile.sh适用于源码检出构建source-checkout build。普通 pip 安装不会遇到这个错误——发布包的构建流程Hatch jupyter-builder hook会负责生成dist/而源码检出里这个目录是空的所以必须先跑一次前端构建。前置条件按 DEVELOPMENT.md 的 PrerequisitesPython 3.10Node.js 22.x与 CI 一致Yarn 1.xgit clone 仓库地址 cd pygwalker python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -e .[dev]pip install -e .[dev]只装 Python 侧它不会帮你生成dist/bundle 由下一步的yarn build写入。解决首次构建前端 bundlecd app yarn install yarn build # 首次完整构建产物写入 pygwalker/templates/dist/ cd ..yarn build包含 typecheck 并构建全部四个 bundlepygwalker-app.es.js、pygwalker-app.iife.js、dsl-to-workflow.umd.js、vega-to-dsl.umd.js输出均到pygwalker/templates/dist/日常开发只需要完整构建一次之后由增量重建接手。如果构建失败先修好 Node 侧依赖不要跳过这一步直接进 notebook。进入开发模式scripts/dev.py 会自动完成首次构建如果你要长期改前端代码推荐直接启动文档推荐的一键开发栈在仓库根目录执行source venv/bin/activate python scripts/dev.py它会同时启动两个长驻进程yarn dev:buildvite build --watch编辑app/src/后自动重建 bundle和带PYGWALKER_DEV1、ANYWIDGET_HMR1的jupyter labkernel 继承这两个变量。文档说明若你还没构建过等它完成首次构建再渲染即可。启动后打开 JupyterLabURL 打印在控制台或记录在logs/jupyter.log在 notebook 单元里直接正常使用 PyGWalker无需额外配置import pandas as pd import pygwalker as pyg pyg.walk(pd.DataFrame({x: [1, 2, 3], y: [4, 5, 6]}))以上代码块为文档示例。常用参数--no-jupyter只跑前端 watch 构建、--no-frontend只启动 JupyterLabbundle 已构建时、--jupyter-port N、--no-browser输出不是 TTY 时自动启用例如 agent 运行、--log-dir DIR。用CtrlC停止整个栈两个进程会被干净地关掉。如果你不打算跑 watcher手动路径是修改app/src/下的文件重建cd app yarn build:app快、不做 typecheck或yarn build全量重新运行 notebook 单元改动没出现时重启 kernel。备选没有本地开发工具链的源码检出构建read_frontend_asset()的报错提示指向仓库根目录的./scripts/compile.sh。该脚本先npm install -g yarn当命令找不到 yarn 时即全局安装 yarn然后在app/下执行yarn yarn build。如果你的环境不允许全局安装 yarn改用上面的cd app yarn install yarn build手动步骤。验证与后续排查构建完成的判断scripts/dev.py会把 vite 输出记到logs/frontend.log看到built in …文档示例输出说明重建完成。回到 notebook 重新运行pyg.walk(...)单元不再抛出Missing PyGWalker frontend asset界面正常渲染即视为解决。报错信息本身会带出具体缺失的文件路径例如pygwalker/templates/dist/pygwalker-app.es.js对照它确认要补的是哪个 bundle。改动不生效时按 DEVELOPMENT.md 的 Frontend edits dont appear 一节确认logs/frontend.log已出现重建完成标记、JupyterLab 是在ANYWIDGET_HMR1下启动的、必要时重跑单元或重启 kernel。日志位置logs/frontend.logvite 构建/watch 输出、logs/jupyter.logJupyterLab 输出含打开用的 URL 与 token、logs/pygwalker.logkernel 侧 Python 日志经PYGWALKER_LOG_FILE写入。也可以用PYGWALKER_LOG_FILE/path/to/file.log把 Python 日志附加到文件、PYGWALKER_LOG_LEVELDEBUG调高日志级别默认INFO注意前端运行时的 comm 错误、渲染问题只出现在浏览器 devtools 控制台不在logs/里。边界与注意pygwalker/templates/dist/是 git 忽略的生成产物不要提交它由 wheel 构建和 CI 负责重建。PYGWALKER_DEV与ANYWIDGET_HMR是开发模式专属开关只影响你的开发会话不要在面向最终用户的运行环境中依赖它们。想进一步了解构建与加载模型两个半区如何拼合、各 bundle 由谁加载可看 AGENTS.md 第 3 节和 docs/ARCHITECTURE.md。测试用例 tests/test_frontend_assets.py 校验了报错信息的格式包含缺失文件路径且普通模式会提示./scripts/compile.sh可用于对照你看到的错误文本。【免费下载链接】pygwalkerPyGWalker: Turn your dataframe into an interactive UI for visual analysis项目地址: https://gitcode.com/GitHub_Trending/py/pygwalker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考