Python实现按键触发写入文件换行 解决写入不全、响应卡顿问题

文件写入不全/写入失败的原因 #

• 文件打开模式错误：你用'w'模式打开文件，该模式每次打开都会清空文件原有内容，多次触发按键只会保留最后一次写入的内容，无法留存所有操作记录。
• 按键判断逻辑错误：判断条件写为key == key.right/key == key.down存在语法逻辑问题，回调传入的key是按键事件对象，正确的方向键枚举值是Key.right/Key.down，错误的判断会导致对应分支根本不会触发，自然不会执行写入操作。
• 冗余的关闭操作：在with open上下文管理器内部手动调用f.close()属于多余操作，上下文管理器会在块结束时自动关闭文件，手动调用在极端场景下反而会触发写入异常。

运行卡顿、响应慢的原因 #

• 监听线程被阻塞：pynput的按键回调默认运行在监听主线程中，你把鼠标移动、强制等待、文件IO这些耗时操作全写在回调里，单次触发就会占住线程近0.6秒，这段时间内所有新的输入事件都无法被响应，自然会出现卡顿、延迟高的问题。
• 重复依赖冲突：你同时导入了pynput.mouse和第三方mouse库，两个库都会hook系统输入接口，同时运行会增加额外性能开销，甚至可能出现事件冲突。
• 不必要的性能损耗：每次触发按键都重新打开、关闭文件，频繁的磁盘IO操作会拖慢运行速度；设置的0.3秒等待时长远超界面响应需要的实际时长，无意义的等待进一步拉长了操作耗时。

• 拆分工作线程：把鼠标操作、文件写入等耗时逻辑挪到独立的后台线程执行，按键回调只负责传递事件、立刻返回，保证监听线程始终能实时响应输入，从根源解决阻塞卡顿问题。
• 修正文件写入逻辑：程序启动时用'w'模式打开一次日志文件清空旧记录，后续所有写入操作都用追加逻辑，不用每次触发都重新打开关闭文件；每次写入后调用flush()把缓冲区内容实时写到磁盘，避免内容丢失。
• 修正按键判断逻辑：使用pynput.keyboard.Key下的正确枚举值判断方向键，移除错误的判断写法。
• 精简等待时长、统一依赖：去掉冗余的长等待，只保留极短的等待时间给界面响应；统一用pynput.mouse.Controller处理鼠标操作，移除第三方mouse库的依赖，避免冲突减少开销。

import time
import queue
import threading
from pynput.keyboard import Listener, Key
from pynput.mouse import Controller, Button

# 初始化鼠标控制器
mouse_ctrl = Controller()
# 事件队列，用于跨线程传递按键事件，避免阻塞监听线程
event_queue = queue.Queue()

# 程序启动时初始化记录文件，清空历史内容
log_file = open('Get Position.txt', 'w', encoding='utf-8')

def process_event():
    """后台工作线程，处理所有耗时操作"""
    while True:
        key = event_queue.get()
        # 收到退出信号时终止线程、关闭文件
        if key == 'exit':
            log_file.close()
            break
        try:
            if key == Key.right:
                # 直接设置鼠标坐标，比带duration的移动响应更快
                mouse_ctrl.position = (1028, 350)
                # 仅保留50ms等待给界面响应，可根据实际情况调整
                time.sleep(0.05)
                mouse_ctrl.click(Button.left)
                # 追加写入记录，实时刷新到磁盘
                log_file.write('RIGHT\n')
                log_file.flush()

            elif key == Key.down:
                mouse_ctrl.position = (959, 350)
                time.sleep(0.05)
                mouse_ctrl.click(Button.left)
                log_file.write('MID\n')
                log_file.flush()
        except Exception as e:
            print(f"执行操作出错: {e}")
        finally:
            event_queue.task_done()

def on_press(key):
    """按键按下回调，仅传递事件不做耗时操作"""
    print(f'Press ON: {key}')
    event_queue.put(key)

def on_release(key):
    """按键抬起回调，按上方向键退出程序"""
    print(f'Press OFF: {key}')
    if key == Key.up:
        event_queue.put('exit')
        return False

if __name__ == "__main__":
    # 启动后台工作线程
    threading.Thread(target=process_event, daemon=True).start()
    # 启动按键监听
    with Listener(on_press=on_press, on_release=on_release) as listener:
        listener.join()

补充说明：如果不需要鼠标平滑移动效果，直接设置mouse_ctrl.position比调用带duration参数的move方法响应速度快很多；如果实际使用时感觉点击位置不准，可以适当把sleep时长从0.05调到0.1，不要超过0.1就不会有明显卡顿感。

内容的提问来源于stack exchange，提问作者coder_1234