本文介绍使用 documentlistener 替代 keylistener 实现字母输入后自动跳转焦点的稳定方案，避免因按键重复、事件触发时机不当导致的“跳格”问题，并提供可运行示例与关键注意事项。
在 Swing GUI 开发中，为实现“输入一个字符后自动聚焦下一文本框”的交互（如矩阵乘法计算器中的字母输入框），初学者常误用 KeyListener 监听 keyPressed 事件。但该方式存在严重缺陷：键盘重复触发（auto-repeat）、事件与文本实际更新不同步、以及 getText() 可能尚未包含刚按下的字符——这正是原问题中“光标跳过一个框”的根本原因。
✅ 推荐方案：使用 DocumentListener
DocumentListener 监听的是 JTextField 底层 Document 的内容变更，它在文本真正被插入/删除后触发，时序准确、语义清晰，完全规避了按键事件的不确定性。
以下是一个精简、健壮的实现示例（已适配原需求场景）：
import javax.swing.*;
import javax.swing.event.DocumentEvent;
import javax.swing.event.DocumentListener;
import java.awt.*;
public class AutoFocusTextFieldDemo extends JFrame {
private final JTextField[] fields;
public AutoFocusTextFieldDemo() {
// 创建 4 个单字符输入框（如 A_RUCE, B_RUCE 等）
fields = new JTextField[4];
JPanel panel = new JPanel(new FlowLayout(FlowLayout.CENTER, 10, 10));
for (int i = 0; i < fields.length; i++) {
JTextField tf = new JTextField(1);
tf.setFont(new Font("Serif", Font.PLAIN, 18));
tf.setHorizontalAlignment(JTextField.CENTER);
// 关键：监听文档变更而非按键
tf.getDocument().addDocumentListener(new FieldDocumentListener(i));
fields[i] = tf;
panel.add(tf);
}
add(panel);
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
pack();
setLocationRelativeTo(null);
}
// 内部监听器：根据当前字段索引决定下一个焦点
private class FieldDocumentListener implements DocumentListener {
private final int currentIndex;
FieldDocumentListener(int index) {
this.currentIndex = index;
}
@Override
public void insertUpdate(DocumentEvent e) {
// 文本插入后检查长度是否为 1（即完成单字符输入）
if (e.getDocument().getLength() == 1) {
int nextIndex = (currentIndex + 1) % fields.length;
fields[nextIndex].requestFocusInWindow(); // 推荐使用 requestFocusInWindow()
}
}
@Override
public void removeUpdate(DocumentEvent e) {
// 输入被清空时，不触发跳转（可选增强：支持 Backspace 回退）
}
@Override
public void changedUpdate(DocumentEvent e) {
// Plain text 不触发此方法（用于富文本）
}
}
public static void main(String[] args) {
SwingUtilities.invokeLater(() -> {
new AutoFocusTextFieldDemo().setVisible(true);
});
}
}? 关键要点说明：
- ✅ insertUpdate() 是核心入口：仅当用户成功输入字符（非粘贴、非程序设置）且文档长度变为 1 时才跳转，杜绝误触发；
- ✅ requestFocusInWindow() 更可靠：相比 requestFocus()，它确保组件在窗口可见且可聚焦状态下获取焦点；
- ⚠️ 避免 KeyListener 的三大陷阱：
- keyPressed 在字符生成前触发，getText() 可能仍为空；
- 长按按键会连续触发，导致多次跳转；
- 中文输入法等复合输入场景下行为不可控；
- ?️ 增强建议（可选）：
- 限制输入为单个字母（使用 DocumentFilter 或 InputVerifier）；
- 支持 Backspace 回退到上一字段（在 removeUpdate 中判断长度为 0 时处理）；
- 添加 setPreferredSize(new Dimension(30, 30)) 统一尺寸，提升 UI 一致性。
通过 DocumentListener，你获得的是基于数据状态变化的响应逻辑，而非脆弱的底层事件钩子——这是 Swing 中处理文本输入焦点流转的惯用且稳健的最佳实践。
