如何在 Pygame 中正确显示全屏尺寸背景图（1920×1080）_技术教程

pygame 背景图被意外裁剪（如左侧缺失约 200 像素），通常并非代码逻辑错误，而是因系统缩放（windows 高 dpi 设置）导致表面分辨率与物理像素不匹配；需启用 dpi 感知并使用 `pygame.display.set_mode()` 的 `pygame.scaled` 或手动适配逻辑解决。

在 Pygame 开发中，即使你将窗口设为 (1920, 1080)、图像也精确导出为 1920×1080，仍可能出现“图像左边缘被截断”（如题中所述的约 200 像素偏移）——这极少是 blit 坐标或图像本身的问题，而极大概率源于操作系统级的 DPI 缩放干扰，尤其在 Windows 高分屏（如 4K 显示器）且系统设置为「125%」或「150% 缩放」时。

? 根本原因：DPI 缩放导致逻辑分辨率 ≠ 物理像素

当你调用 pygame.display.set_mode((1920, 1080)) 时，Windows 可能将该尺寸解释为「逻辑像素」而非「真实屏幕像素」。例如，在 125% 缩放下，1920 逻辑像素实际占用 1920 × 1.25 = 240

0 物理像素宽度，但 Pygame 默认创建的 surface 仍按 1920×1080 渲染，导致绘制时被系统自动缩放/裁剪，表现为图像错位或边缘丢失。

✅ 正确解决方案：启用高 DPI 感知

在 import pygame 后、pygame.init() 前，强制告知 Windows 当前应用支持高 DPI 缩放：

import ctypes
# 启用高 DPI 感知（仅 Windows）
try:
    ctypes.windll.shcore.SetProcessDpiAwareness(1)  # 推荐：系统 DPI 感知
except (AttributeError, OSError):
    pass  # 非 Windows 系统或旧版本忽略

import pygame
pygame.init()

? SetProcessDpiAwareness(1) 表示应用自行处理 DPI 缩放，Windows 不再强制缩放窗口内容，Pygame 创建的 surface 将严格对应物理像素。

?️ 补充建议：确保渲染一致性

避免在循环内反复加载图像（性能与稳定性）：
将 pygame.image.load("tabuleiro.png") 移至主循环外，并在图像更新后重新加载或使用 pygame.transform.smoothscale() 动态适配（若需响应式）。
推荐使用 SCALED 模式（Pygame 2.0+）：
若目标是跨设备适配，可改用：
```
tela = pygame.display.set_mode((1920, 1080), pygame.SCALED | pygame.RESIZABLE)
```
此模式下 Pygame 自动处理缩放，图像始终完整覆盖窗口（需配合 blit 到 (0, 0)）。
验证实际渲染尺寸（调试用）：
在循环中加入检查：
```
print("Screen size:", tela.get_size())
print("Image size:", imp.get_size())
```
若二者均为 (1920, 1080) 但视觉仍偏移，基本可确认为 DPI 问题。

⚠️ 注意事项

SetProcessDpiAwareness 仅对 Windows 有效；macOS/Linux 通常无此问题。
不要依赖 pygame.display.Info().current_w/h 获取“真实分辨率”，它返回的是逻辑尺寸；应以 set_mode 参数和 get_size() 为准。
Pillow 生成图像时，务必保存为 RGB 模式（非 RGBA 透明通道），避免 Alpha 混合异常：
```
img = img.convert("RGB")  # 确保无 alpha
img.save("tabuleiro.png")
```

通过启用 DPI 感知，你的 1920×1080 图像将严格按物理像素渲染，鼠标点击坐标（pygame.mouse.get_pos()）也将与图像像素一一对应，彻底解决裁剪与交互错位问题。