使用Python和PyGetWindow实现程序窗口前置显示-Python教程-PHP中文网

使用Python和PyGetWindow实现程序窗口前置显示

花韻仙語

发布： 2025-12-12 21:48:36

原创

107人浏览过

使用python和pygetwindow实现程序窗口前置显示

本教程将指导您如何使用Python的PyGetWindow库，以跨平台的方式将指定应用程序窗口带到操作系统的前台。通过获取所有窗口标题并利用正则表达式进行精确匹配，您可以轻松激活目标窗口，解决传统subprocess方法无法实现窗口前置的问题。

在日常的自动化脚本或工具开发中，我们有时需要程序不仅启动某个应用，还能将其窗口置于所有其他窗口之上，即“前置显示”。然而，简单地使用Python的subprocess.Popen来启动程序，并不能保证其窗口能被激活并带到前台。例如，尝试通过subprocess.Popen直接启动CMD或VS Code，虽然程序会运行，但其窗口可能仍然隐藏在其他应用之后，无法达到用户期望的“注意力吸引”效果。

传统方法的局限性

当我们尝试通过以下方式将VS Code或CMD带到前台时：

import subprocess
import os

# 尝试启动VS Code并带到前台 (无法直接实现前置)
VS_CODE_PATH = r'C:\Users\Computador\AppData\Local\Programs\Microsoft VS Code\Code.exe'
def launch_vscode_attempt() -> None:
    subprocess.Popen([VS_CODE_PATH, os.getcwd()])

# 尝试启动CMD并带到前台 (无法直接实现前置)
CMD_PATH = r'C:\WINDOWS\system32\cmd.exe'
def launch_cmd_attempt() -> None:
    subprocess.Popen([CMD_PATH, os.getcwd()])

登录后复制

这些方法仅负责启动进程，但操作系统对窗口的激活和前置有其自身的管理机制，subprocess.Popen默认不提供直接控制窗口前置的功能。为了实现这一目标，我们需要借助专门的窗口管理库。

立即学习“Python免费学习笔记（深入）”；

使用PyGetWindow库实现窗口前置

PyGetWindow是一个强大的Python库，它允许我们获取、操作和管理操作系统中的窗口。它具有跨平台特性，支持Windows、macOS和Linux，使其成为实现窗口前置的理想选择。

多个微信小程序源码合集

微信小程序是一种轻量级的应用开发平台，由腾讯公司推出，主要应用于移动端，旨在提供便捷的用户体验，无需下载安装即可在微信内使用。本压缩包包含了丰富的源码资源，涵盖了多个领域的应用场景，下面将逐一介绍其中涉及的知识点。1. 图片展示：这部分源码可能涉及了微信小程序中的``组件的使用，用于显示图片，以及`wx.getSystemInfo`接口获取屏幕尺寸，实现图片的适配和响应式布局。可能还包括了图片懒加

查看详情

1. 安装PyGetWindow

在使用之前，您需要通过pip安装PyGetWindow库：

pip install pygetwindow

登录后复制

2. 核心原理与实现

PyGetWindow的工作原理是获取所有当前运行窗口的标题，然后通过匹配这些标题来找到目标窗口，最后调用该窗口对象的激活方法将其带到前台。

以下是实现窗口前置功能的Python代码示例：

import pygetwindow as gw
from re import match

def bring_window_to_foreground(window_title_part: str) -> None:
    """
    根据窗口标题的一部分，将匹配到的第一个窗口带到前台。

    Args:
        window_title_part: 目标窗口标题中包含的关键词或正则表达式片段。
    """
    try:
        # 1. 获取所有窗口的标题
        all_window_titles = gw.getAllTitles()

        # 2. 使用正则表达式过滤匹配的窗口标题
        # .*? 确保匹配灵活，例如 "Visual Studio Code - [文件名] - [项目名]"
        # 匹配包含 window_title_part 的任意窗口标题
        filtered_titles = [
            title for title in all_window_titles
            if title and match(f".*?{window_title_part}.*?", title)
        ]

        if not filtered_titles:
            print(f"未找到包含 '{window_title_part}' 的窗口。")
            return

        # 3. 获取第一个匹配到的窗口对象
        # getWindowsWithTitle 返回一个列表，即使只有一个匹配项
        target_window = gw.getWindowsWithTitle(filtered_titles[0])

        if target_window:
            # 4. 激活窗口，将其带到前台
            target_window[0].activate()
            print(f"已将窗口 '{filtered_titles[0]}' 带到前台。")
        else:
            print(f"未能获取到窗口 '{filtered_titles[0]}' 的对象。")

    except IndexError:
        print(f"未找到包含 '{window_title_part}' 的窗口。请确保程序已运行。")
    except Exception as e:
        print(f"执行过程中发生错误: {e}")

# 示例用法：将VS Code窗口带到前台
if __name__ == "__main__":
    # 示例1: 将Visual Studio Code窗口带到前台
    # 注意：VS Code的标题通常包含文件名或项目名，所以模糊匹配很有用
    bring_window_to_foreground("Visual Studio Code")

    # 示例2: 将CMD窗口带到前台 (如果CMD窗口标题是 "命令提示符" 或 "Administrator: 命令提示符")
    # 您可能需要根据实际的CMD窗口标题进行调整
    # bring_window_to_foreground("命令提示符")

    # 示例3: 将Chrome浏览器窗口带到前台 (如果其标题包含 "Google Chrome")
    # bring_window_to_foreground("Google Chrome")

登录后复制

3. 代码解析

import pygetwindow as gw: 导入pygetwindow库，并通常以gw作为别名。
from re import match: 导入re模块中的match函数，用于正则表达式匹配。
gw.getAllTitles(): 这个函数会返回一个包含当前所有可见窗口标题的列表。
filter(lambda v: match(f".*?{window_title_part}.*?", v), windows):
- 这里使用了一个列表推导式结合re.match来进行过滤。
- f".*?{window_title_part}.*?" 是一个正则表达式模式。
  - .*? 是非贪婪匹配，表示匹配任意字符零次或多次。这使得模式非常灵活，可以匹配到标题中包含window_title_part的任何部分，例如 "Visual Studio Code - my_file.py - my_project" 也能匹配到 "Visual Studio Code"。
  - window_title_part 是您希望匹配的目标窗口标题的关键词。
gw.getWindowsWithTitle(filtered_titles[0]): 找到第一个匹配到的窗口标题，并获取对应的窗口对象列表。即使只有一个窗口，它也返回一个列表。
win[0].activate(): 从获取到的窗口对象列表中取出第一个窗口对象（因为我们通常只想激活一个），然后调用其activate()方法。这个方法会确保窗口被带到前台并获得焦点。

注意事项与最佳实践

窗口标题的精确性: 不同的应用程序或同一应用程序的不同状态（例如，VS Code打开不同文件时标题会变化）可能会有不同的窗口标题。使用正则表达式进行模糊匹配（如.*?）可以提高匹配的鲁棒性。
多实例处理: 如果有多个相同标题的应用程序实例在运行（例如，多个VS Code窗口），上述代码只会激活第一个匹配到的窗口。如果您需要激活特定的某个实例，可能需要结合其他信息（如窗口位置、大小等）或更复杂的正则表达式来区分。
跨平台兼容性: PyGetWindow库本身是跨平台的，因此这段代码在Windows、macOS和Linux上理论上都能正常工作。
错误处理: 建议在实际应用中加入更健壮的错误处理机制，例如当未找到目标窗口时提供友好的提示。