page.waitForSelector() 必须使用，因动态页面元素需等待加载完成才能交互；应优先等待容器而非单个元素，点击前确认可见、可交互并触发必要事件，避免固定延时和复用过期句柄。
page.waitForSelector()必须用，否则大多数交互会失败——动态页面的元素根本还没加载出来。
等待元素出现再操作，不是可选项
Pyppeteer 不像 requests 那样拿到 HTML 就能开干。现代页面大量依赖 JS 渲染，page.goto() 返回时 DOM 往往是空的或不完整的。
-
await page.waitForSelector('button#submit', visible=True)等元素可见（已渲染且不在display: none或visibility: hidden状态） -
await page.waitForSelector('div.result-list', hidden=False)显式排除隐藏状态，比只等存在更可靠 - 避免用
time.sleep()：网络波动、CPU 负载都会让固定延时失效；超时默认 30s，可通过timeout=10000缩短 - 对异步加载列表，优先等容器而非单条项，比如等
'ul.product-list'而不是'li.product-item:nth-child(5)'
点击前先确认元素可交互
按钮可能被遮挡、禁用、或处于 loading 状态，直接 click() 会抛 ElementHandleError 或静默失败。
- 先检查
await element.isIntersectingViewport()，确保在视口内（滚动后才能点） - 读取属性：
await element.getProperty('disabled')返回null才表示未禁用 - 用
page.evaluate()判断 CSS 状态：await page.evaluate(el => !el.hasAttribute('disabled') && getComputedStyle(el).opacity !== '0', element) - 真要点击遮挡元素？改用
page.mouse.click(x, y)坐标点击，但需先element.boundingBox()计算位置
表单输入别只靠 type()
element.type() 模拟打字，但很多前端框架（React/Vue）监听的是 input 或 change 事件，光填值不触发事件会导致提交失败。
python-flask-vue-creator
下载
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
- 输入后手动触发：
await element.evaluate(el => el.dispatchEvent(new Event('input', { bubbles: true }))) - 对下拉框，
element.select()比click() + keypress更稳定，但只支持元素 - 日期控件、富文本等自定义组件，往往得用
page.focus(selector)+page.keyboard.type()组合 - 防 bot 的输入框可能校验
inputEvent.isTrusted，这时只能走真实事件链，type()无法绕过
处理多步骤交互时，避免“一步到位”思维
比如“打开弹窗 → 填写表单 → 提交 → 关闭”，不能写成连续 await，中间任何一环失败就中断。真实用户会看反馈、等动画、重试。
- 把每步封装成带重试的函数，例如
async def wait_and_click(selector, timeout=5000, retry=2): - 关键节点加截图诊断：
await page.screenshot(path=f'step-{step}.png')，出问题立刻定位是哪步挂了 - 用
page.on('response', ...)监听接口返回，比等 DOM 更准——比如提交后等/api/submit返回 200 再继续 - 不要复用
element句柄太久，DOM 更新后它会 stale，下次调用直接报错；需要时重新querySelector
真实项目里，80% 的交互失败不是代码写错，而是没处理好「时机」和「状态」。你写的不是脚本，是在模拟一个会观察、会等待、会重试的人。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
