LibGDX 游戏中纹理在窗口右边界或上边界被裁剪、显示为黑色区域，根本原因在于 Gdx.graphics.setWindowedMode() 在 create() 中调用过晚——此时 OpenGL 上下文尚未完全就绪，导致视口（viewport）与帧缓冲配置异常。正确做法是将窗口模式设置移至 DesktopLauncher 的配置阶段。
libgdx 游戏中纹理在窗口右边界或上边界被裁剪、显示为黑色区域，根本原因在于 `gdx.graphics.setwindowedmode()` 在 `create()` 中调用过晚——此时 opengl 上下文尚未完全就绪，导致视口（viewport）与帧缓冲配置异常。正确做法是将窗口模式设置移至 `desktoplauncher` 的配置阶段。
在 LibGDX 中，Gdx.graphics.setWindowedMode(width, height) 和 setResizable(false) 等图形配置必须在 OpenGL 上下文初始化完成前生效，即应在游戏主类（如 SpaceInvaders）的 create() 方法执行之前完成。而你在 create() 内部调用这些方法，会导致以下问题：
- 窗口尺寸虽已变更，但底层
GLSurfaceView或Lwjgl3Window的视口（glViewport）未同步更新； - 坐标系原点（默认左下角）与实际渲染区域错位，尤其在
x + width > windowWidth或y + height > windowHeight时，超出部分被截断并填充为未清除的黑色帧缓冲残留（即你看到的“黑盒子”）； -
SpriteBatch使用的正交投影矩阵仍基于旧窗口尺寸计算，造成纹理坐标映射失准。
✅ 正确解决方案：将窗口配置前置到桌面启动器（DesktopLauncher）中，确保在 Application 实例创建前完成初始化。
✅ 修改步骤（以标准 LibGDX 桌面项目为例）
- 打开
desktop/src/com/yourpackage/DesktopLauncher.java（路径根据你的包名调整）； - 在
Lwjgl3ApplicationConfiguration config = new Lwjgl3ApplicationConfiguration();后添加配置：
public class DesktopLauncher {
public static void main(String[] args) {
Lwjgl3ApplicationConfiguration config = new Lwjgl3ApplicationConfiguration();
config.setWindowedMode(672, 768); // ✅ 正确位置：配置阶段
config.setResizable(false); // ✅ 同上
config.useVsync(true);
config.setTitle("Space Invaders");
// 启动游戏
new Lwjgl3Application(new SpaceInvaders(), config);
}
}- *删除
SpaceInvaders.create()中所有 `Gdx.graphics.` 窗口配置代码**：
@Override
public void create() {
batch = new SpriteBatch();
// ❌ 删除以下两行：
// Gdx.graphics.setResizable(false);
// Gdx.graphics.setWindowedMode(672, 768);
p = new Player(batch);
}- （可选）为确保坐标逻辑清晰，建议在
Player.updateKeys()中统一使用sprite.setPosition(x, y)替代手动设setX/setY，并确认y值未超出安全范围：
// 推荐写法：显式控制位置，避免浮点累积误差
sprite.setPosition(Math.max(0, Math.min(x, Gdx.graphics.getWidth() - sprite.getWidth())),
Math.max(0, Math.min(y, Gdx.graphics.getHeight() - sprite.getHeight())));⚠️ 注意事项
-
Web / Android 平台不适用此方案：
setWindowedMode()仅对桌面后端（Lwjgl3）有效；Android 使用AndroidApplicationConfiguration，Web 使用GwtApplicationConfiguration，需分别处理。 -
切勿在
render()中动态调用setWindowedMode()：会触发窗口重置，引发闪烁、状态丢失甚至崩溃。 - 若使用
OrthographicCamera，还需检查其viewportWidth/Height是否与窗口尺寸一致，并在resize()回调中更新（本例未使用，故无需额外操作）。
✅ 验证效果
重启应用后，Player 精灵将能完整渲染至窗口最右/最上边缘（如 x = 672 - playerImg.getWidth()），不再被黑块遮挡——因为此时 OpenGL 视口、帧缓冲及 SpriteBatch 投影矩阵已严格对齐指定分辨率。
该问题本质是 LibGDX 初始化生命周期理解偏差，而非纹理加载或绘制逻辑错误。掌握“配置前置”原则，可规避 90% 的跨平台渲染异常。
