如何设置Pygame窗口置顶及启动时居前，现有代码窗口默认后台启动

实现方案 #

前置依赖 #

Pygame本身没有提供直接控制窗口层级的API，需要调用系统窗口管理接口实现需求。Windows平台可以通过pywin32库调用系统接口，先执行以下命令安装依赖：
pip install pywin32

需求1：窗口启动时位于最顶层，不固定置顶 #

原理是窗口创建完成后，临时调用一次置顶接口再取消置顶状态，窗口就会停在当前顶层位置，后续可以被其他窗口正常覆盖。
完整可运行代码：

from os import environ
import win32gui
import win32con
environ['PYGAME_HIDE_SUPPORT_PROMPT'] = "hide"
import pygame  # import after disabling prompt

screen = pygame.display.set_mode((800, 800))
screen.fill((50, 50, 50))  # Dark gray color

# 核心控制逻辑
hwnd = pygame.display.get_wm_info()["window"]
# 先设为置顶
win32gui.SetWindowPos(hwnd, win32con.HWND_TOPMOST, 0, 0, 0, 0, win32con.SWP_NOMOVE | win32con.SWP_NOSIZE)
# 立即取消置顶，窗口会保留在当前顶层位置
win32gui.SetWindowPos(hwnd, win32con.HWND_NOTOPMOST, 0, 0, 0, 0, win32con.SWP_NOMOVE | win32con.SWP_NOSIZE)

pygame.display.update()

# 窗口运行事件循环
while True:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            pygame.quit()
            exit()

需求2：固定Pygame窗口在所有窗口最顶层 #

原理是给窗口添加永久置顶标记，后续不会被其他窗口覆盖。
完整可运行代码：

from os import environ
import win32gui
import win32con
environ['PYGAME_HIDE_SUPPORT_PROMPT'] = "hide"
import pygame  # import after disabling prompt

screen = pygame.display.set_mode((800, 800))
screen.fill((50, 50, 50))  # Dark gray color

# 核心控制逻辑：永久设置窗口置顶
hwnd = pygame.display.get_wm_info()["window"]
win32gui.SetWindowPos(hwnd, win32con.HWND_TOPMOST, 0, 0, 0, 0, win32con.SWP_NOMOVE | win32con.SWP_NOSIZE)

pygame.display.update()

# 窗口运行事件循环
while True:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            pygame.quit()
            exit()

跨平台适配说明 #

如果是Linux或macOS系统，可以对应调用对应系统的原生窗口管理接口实现相同效果：

• Linux：使用xlib库调用X11接口给窗口设置_NET_WM_STATE_ABOVE属性
• macOS：使用AppKit框架获取窗口对象，修改level属性为置顶级别

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