本文详解如何使用 cypress 的 eq() 方法精准选择多个具有相同类名和属性的 元素（如 ant design 的 ant-input-number-input），并通过 .type() 正确输入数值，避免因元素重复导致的定位失败。
在 Cypress 端到端测试中，当页面存在多个结构完全一致的输入框（例如两个 Ant Design 的数字输入组件），仅靠通用选择器（如 cy.get(‘.ant-input-number-input’)）会返回多个匹配元素，而后续链式操作（如 .type()）默认作用于第一个匹配项，且若未显式限定，还可能因 dom 渲染顺序不稳定引发 flaky 测试。
正确做法是结合语义化属性与索引定位。观察目标元素：
其 role=”spinbutton” 和 class=”ant-input-number-input” 组合具备强语义性，比单纯依赖 class 更可靠。推荐使用属性组合选择器提升健壮性：
// ✅ 推荐：用 role + class 精准筛选，再用 eq() 定位第 n 个（索引从 0 开始） cy.get('[role="spinbutton"].ant-input-number-input').eq(0).type('25'); // 第一个输入框 cy.get('[role="spinbutton"].ant-input-number-input').eq(1).type('42'); // 第二个输入框⚠️ 注意事项：
- 勿用 .text() 输入：.text() 是读取文本内容的命令，无法向输入框写入值；必须使用 .type()。
- 避免 .click().type() 链式调用冗余：.type() 内部会自动聚焦并触发必要事件，通常无需前置 .click()；若需确保可交互状态，可加 .should(‘be.enabled’) 断言。
- 增强稳定性：对关键输入框建议添加显式等待与状态校验：
cy.get('[role="spinbutton"].ant-input-number-input') .eq(1) .should('be.visible') .should('be.enabled') .clear() // 清空可能存在的默认值 .type('100'); - 替代方案参考：若元素有唯一 data-testid（如 ），应优先使用 cy.get(‘[data-testid=”price-input”]’) —— 这是最推荐的、面向测试的定位方式。
总结：面对重复 DOM 结构，eq(n) 是 Cypress 提供的简洁索引定位工具，但需配合语义化选择器（如 [role=”spinbutton”]）和防御性断言，才能构建稳定、可维护的自动化测试脚本。