使用pyautogui自动粘贴文件路径时盘符丢失是什么原因

问题描述 #

使用Python实现Excel自动另存为功能：触发「另存为」弹窗后，将目标文件路径填入文件资源管理器的「文件名」输入框完成保存。
核心实现代码如下：

# TODO 实现保存逻辑
    fileName = os.getcwd() + r'\bracReg.csv'
    pc.copy(fileName)
    pyautogui.write(pc.paste())
    pause()
    pyautogui.press(['tab', 'c', 'c', 'enter', 'tab', 'enter'], interval=.1)
    xw.apps.active.api.Quit()

异常现象 #

校验确认剪贴板中存储的文件路径完整正确，手动在文件名输入框执行粘贴操作可正常保存，但脚本运行时自动填入的路径会丢失开头的盘符：例如原路径为C:\blah\whatever，实际输入结果为:\blah\whatever。
最初怀疑异常由xlwings的特殊交互导致，附完整功能代码：

def create_bracket_registration():
    # 初始化Excel应用实例
    app = xw.App()
    # 绑定对应工作簿和工作表
    wb = app.books['Book1']
    ws = wb.sheets('Sheet1')
    # 写入表头
    ws.range('A1').value = ['First', 'MI', 'Last', 'Nick', 'Vintage', 'Lane number', 'Play position', 'Avg', 'Hbrac', 'Sbrac']
    # 定位数据最后一列
    last_column = ws.range(1, 1).end('right').get_address(0, 0)[0]
    ws.range('A:{}'.format(last_column)).api.ColumnWidth = 13
    AppHandler.focus_on_window('.*Excel*')
    # 移动光标到数据录入位置
    pyautogui.press('enter')
    pause()
    # TODO 实现保存逻辑
    fileName = os.getcwd() + r'\bracReg.csv'
    pc.copy(fileName)
    pyautogui.write(pc.paste())
    pause()
    pyautogui.press(['tab', 'c', 'c', 'enter', 'tab', 'enter'], interval=.1)
    xw.apps.active.api.Quit()

补充说明：已知该功能存在更优实现方案，当前仅需明确该异常的产生原理。

异常产生原理 #

• 根因是pyautogui.write()的实现逻辑和按键状态残留：该函数本质是逐字符模拟键盘按键输入，并非调用系统原生粘贴接口。
• 调用pc.copy(fileName)时，底层会模拟按下Ctrl+C组合键完成复制，这一步执行后如果Ctrl键没有被系统及时识别为释放状态（常见于UI自动化的按键时序问题），紧接着pyautogui.write()输出路径首字符大写C时，系统会将其判定为新的Ctrl+C组合键指令，直接触发输入框的复制操作，原本要输入的首字符C会被组合键拦截吞掉，最终输入框里就只剩下首字符之后的路径段。
• 该异常和xlwings无直接关联，属于UI自动化中常见的修饰键（Ctrl/Shift/Alt）状态残留问题：pyautogui默认不会在执行输入操作前主动重置所有修饰键的按下状态，只要前序操作有修饰键弹起延迟，就可能出现这类组合键误触发问题。
• 可通过简单测试验证：将路径首字母改为小写c，或在write操作前主动执行释放Ctrl键的逻辑，或直接模拟Ctrl+V组合键完成粘贴而非逐字输入，盘符丢失的问题会直接消失。

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