SuperAPI AI 工具集

debugging-cypress-artifacts

测试与质量

查看项目

更新于 10-16 05:05

技能介绍

用途:调试只在 Cypress 发布形态代码中出现的缺陷,即 cli/build/ 下的 Rollup 输出与 binary-package 打包的 Electron 应用,而不是 yarn dev 或 cypress open --dev。

主要能力:给出从构建到复现的完整流程。CLI 构建用 yarn lerna run build-cli --scope cypress;二进制构建用 env -u ELECTRON_RUN_AS_NODE yarn binary-build / binary-package,需匹配 --version 与 --platform。打包 CLI 入口为 node <repo>/cli/build/dist/bin/cypress <command>,注意 cli/build/bin/cypress 不是 Rollup 包,不要用于产物复现。通过 export CYPRESS_RUN_BINARY=/path/to/platform/executable 指向本地打包二进制(macOS 为 …/Cypress.app/Contents/MacOS/Cypress,Linux 为 …/Cypress,win32 为 …/Cypress.exe)。

日志与调试:DEBUG=cypress:cli*、DEBUG=cypress:electron*、ELECTRON_ENABLE_LOGGING=1;CLI 用 node --inspect-brk,Electron 主进程用 cypress open --inspect-brk。

Git 工作流:用 WIP 提交作书签,构建复现后用 git clean -xfd && yarn 恢复,再用 git reset HEAD~1(非 revert)还原改动;未提交的未跟踪文件会被清除。Husky 缺失 .husky/_/husky.sh 时不要反复重试提交。

限制:二进制构建会污染工作区,勿用 git stash push -a;不要假设 yarn dev 与打包行为一致;--dev 不适用。若 yarn/Vite 因 @packages/data-context 的 urqlSchema 等导入失败,可能是陈旧 .js 遮蔽 .ts,需重新构建并删除同名 .js。