问题：pyautogui输入中文显示乱码如何解决？

Question

在使用 PyAutoGUI 进行自动化操作时，部分用户会遇到输入中文显示乱码的问题。该问题通常出现在不同操作系统或编码格式不匹配的情况下，尤其是在 Windows 系统中使用非 UTF-8 编码时更为常见。PyAutoGUI 本身并不直接处理字符编码，而是依赖 Python 脚本的默认编码设置和系统环境。 解决方法包括：确保脚本文件保存为 UTF-8 编码格式；在代码开头声明 `# -*- coding: utf-8 -*-`；使用 `pyperclip` 库复制中文文本再通过 `pyautogui.hotkey('ctrl', 'v')` 粘贴，避免直接输入导致的编码错误；也可尝试使用 `pyautogui.write()` 的 `interval` 参数降低输入速度以提高兼容性。通过这些方式可有效解决 pyautogui 输入中文显示乱码的问题。

Answer 1

解决 PyAutoGUI 中文输入乱码问题的深度剖析与实践方案

在自动化测试和桌面自动化场景中，PyAutoGUI 是一个功能强大且跨平台的 GUI 自动化工具。然而，在处理中文字符时，很多用户会遇到“显示乱码”的问题。该问题通常出现在不同操作系统或编码格式不匹配的情况下，尤其是在 Windows 系统中使用非 UTF-8 编码时更为常见。

一、问题现象：为什么 PyAutoGUI 输入中文会乱码？

• PyAutoGUI 本身并不处理字符编码逻辑，而是依赖 Python 解释器默认的编码方式。
• 当脚本文件保存格式与运行环境的默认编码不一致时，中文字符容易出现解码错误。
• Windows 系统某些版本（如简体中文版）默认编码为 GBK 或 GB2312，而非 UTF-8，这会导致中文字符读取失败。

二、分析过程：从代码到系统环境的逐层排查

1. 首先检查 Python 脚本文件的保存编码格式是否为 UTF-8。
2. 查看代码中是否有声明编码格式，如：# -*- coding: utf-8 -*-。
3. 确认运行环境中 Python 的默认编码设置，可通过以下代码验证：

import sys
print(sys.getdefaultencoding())

操作系统	默认编码	常见问题点
Windows	GBK / CP936	未转换为 UTF-8 时易出错
Linux / macOS	UTF-8	兼容性较好

三、解决方案：多角度应对中文乱码问题

以下是几种经过验证的有效解决方法：

• 1. 设置脚本文件编码为 UTF-8：使用支持编码设置的编辑器（如 VSCode、Sublime Text）将文件另存为 UTF-8 格式。
• 2. 声明编码格式：在 Python 脚本开头添加编码声明：

# -*- coding: utf-8 -*-

• 3. 使用 pyperclip 辅助输入中文：通过剪贴板复制粘贴方式避免直接写入可能引发的编码问题：

import pyperclip
import pyautogui

pyperclip.copy("你好，世界！")
pyautogui.hotkey('ctrl', 'v')

• 4. 调整 pyautogui.write() 输入速度：适当增加间隔时间，提高兼容性：

pyautogui.write("你好，世界！", interval=0.1)

四、进阶建议：构建健壮的中文输入流程

为了提升脚本的稳定性和可移植性，推荐结合多种手段进行优化。以下是一个流程图示例：

graph TD
            A[开始] --> B{检测系统编码}
            B -->|UTF-8| C[直接使用 write()]
            B -->|非 UTF-8| D[使用 pyperclip 复制粘贴]
            D --> E[调用 hotkey('ctrl','v')]
            C --> F[结束]
            E --> F