Ubuntu 22.04中xdotool key period命令执行失败原因排查

问题概述 #

在Ubuntu 22.04.4 LTS中运行C#脚本，调用xdotool执行key comma可正常模拟逗号按键，但执行key period模拟句号时完全无响应。根据xdotool文档，key period是正确的调用方式，替换为.会触发无效序列错误。脚本日志已输出“Zooming in functions to begin”和“Zooming in functions completed”，说明代码逻辑已执行到对应步骤，但句号按键事件未生效。

相关代码片段：

static void processBaseImage(string windowName, string directoryPath)
{
    string baseImage = processWindow(windowName, directoryPath, "base");
    if (baseImage != null)
    {
        Thread.Sleep(1000);
        Process.Start("xdotool", "key comma");
        string zoomedOutImage = processWindow(windowName, directoryPath, "zoomed_out");
        if (zoomedOutImage != null)
        {
            // 额外添加几次放大按键，确保图像调整到位（肉眼难分辨但图像对比能识别差异）
            Console.WriteLine("Zooming in functions to begin");
            Thread.Sleep(1000);
            Process.Start("xdotool", "key period");
            Process.Start("xdotool", "key period");
            Console.WriteLine("Zooming in functions completed");
            string zoomedInImage = processWindow(windowName, directoryPath, "zoomed_in");
            compareImagesForFocus(baseImage, zoomedOutImage, zoomedInImage, directoryPath);
        }
    }
}

排查方向 #

• 键盘布局差异：部分非美式键盘布局中，句号对应的xdotool键名可能不是period。可以通过xev工具验证：运行xev后点击句号键，查看输出中的keysym字段，确认实际键名（比如小键盘句号对应KP_Decimal）。
• 窗口焦点丢失：执行processWindow截图操作后，目标窗口可能失去焦点，导致后续按键事件发送到错误窗口。
• xdotool按键发送机制：直接使用key period可能存在兼容性问题，键名解析异常。

替代解决方案 #

方案1：使用十六进制键码替代键名 #

句号的X11十六进制键码为0x2e，直接调用键码可避免键名解析问题：

// 替换原有的Process.Start("xdotool", "key period");
Process.Start("xdotool", "key 0x2e");

方案2：强制指定目标窗口发送按键 #

先获取目标窗口ID，再聚焦窗口并定向发送按键事件，确保事件送达正确窗口：

static void processBaseImage(string windowName, string directoryPath)
{
    string baseImage = processWindow(windowName, directoryPath, "base");
    if (baseImage != null)
    {
        Thread.Sleep(1000);
        Process.Start("xdotool", "key comma");
        string zoomedOutImage = processWindow(windowName, directoryPath, "zoomed_out");
        if (zoomedOutImage != null)
        {
            Console.WriteLine("Zooming in functions to begin");
            Thread.Sleep(1000);

            // 获取目标窗口ID
            var windowIdProc = new ProcessStartInfo
            {
                FileName = "xdotool",
                Arguments = $"search --name \"{windowName}\"",
                RedirectStandardOutput = true,
                UseShellExecute = false,
                CreateNoWindow = true
            };
            using (var proc = Process.Start(windowIdProc))
            {
                proc.WaitForExit();
                string windowId = proc.StandardOutput.ReadToEnd().Trim();
                if (!string.IsNullOrEmpty(windowId))
                {
                    // 聚焦窗口并发送按键
                    Process.Start("xdotool", $"windowfocus --sync {windowId}");
                    Process.Start("xdotool", $"key --window {windowId} period");
                    Process.Start("xdotool", $"key --window {windowId} period");
                }
            }

            Console.WriteLine("Zooming in functions completed");
            string zoomedInImage = processWindow(windowName, directoryPath, "zoomed_in");
            compareImagesForFocus(baseImage, zoomedOutImage, zoomedInImage, directoryPath);
        }
    }
}

方案3：改用type命令输入字符 #

如果目标窗口处于可输入状态，直接使用type命令输入句号字符：

Process.Start("xdotool", "type \".\"");

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