图片导入：文件可读不等于显示正确

图片进入工程后，Godot 会按导入设置处理为运行资源，并生成导入元数据与缓存。源图仍然要保留。不要把 .godot 缓存当成唯一资产，更不要只复制缓存而遗失源文件。导入成功证明引擎可以处理它，不证明尺度、边缘和拼接正确。

Godot 4 的 2D 纹理过滤可在项目默认项以及 CanvasItem 的 Texture Filter 中设置，节点还可以继承父级。不要机械照搬把 Filter 当作旧版图片导入勾选项的教程。像素练习通常比较 Nearest 与 Linear；但只有原图逻辑网格清楚时，Nearest 才能保住预期硬边。

1. 将一张自绘小 PNG 放入独立工程的 assets/practice/，等待导入完成。
2. 创建 Sprite2D 并引用该文件，在 Inspector 中找到 Texture Filter。
3. 固定位置与倍率，切换 Nearest 与 Linear 作比较；不要同时改相机。
4. 查看 Import 面板的压缩和 Mipmap 设置，但不要为所有资源套同一组合。2D 小图先保持简单，再按缩放需求验证。
5. 关闭并重开工程，确认引用仍正确；运行中看最终效果，不只看资源预览。

检查原图是否早已含抗锯齿、节点是否继承了父级过滤、显示倍率是否非整数、相机或节点是否处于小数位置、UI 或窗口缩放是否改变采样关系。压缩、过滤、逻辑尺寸是不同层的问题，先定位层次再调整。

自己画一张包含直线、斜线、小方格和透明边缘的测试 PNG。它不需要好看，重要的是结构清楚，方便看出哪里被混合或拉伸。把图放到两个 Sprite2D 上，保持位置、缩放和父级设置相同，只改变一个节点的 Texture Filter。这样你看到的差异才主要来自过滤，而不是图案、倍率或相机不同。

先在整数放大倍率下比较，再改成非整数倍率，观察某些像素列是否宽窄不一。最近邻能保留离散色块，但不能保证任意倍率下每个原始像素占据相同数量的屏幕像素。记录每次显示倍率和过滤设置，别只写“开了像素模式”。如果原图本来就有半透明抗锯齿，切换过滤也不会把源图自动还原成未经混合的硬边素材。

可以沿四层排查。第一层看源图：在图像编辑器中观察原始像素，确认是否已经模糊。第二层看纹理使用方式：节点是否继承了父级过滤。第三层看场景变换：节点或相机有没有小数位置与不合适的缩放。第四层看窗口输出：实际窗口是否再次缩放了基础画面。不要因为最后一层显示模糊，就回头反复重新导出原图。

做一个定位记录，每一层写设置、观察和是否排除。若静止时清楚、相机移动时闪动，优先检查采样位置与运动关系，而不是认定图片压缩损坏。若只有某个节点模糊，比较它和正常节点的继承设置。若所有图片都一样，才调查更高层的显示配置。每次只改变一层，恢复无效改动，才能保留清楚的因果关系。

调整完成后，保存场景并关闭练习工程，再重新打开、运行同一测试场景。这个动作能帮助发现只在临时状态下看似生效的改动，或资源引用没有保存的问题。再把同一张纹理用在第二个节点上，确认你知道设置是项目默认、父级继承还是节点覆盖，而不是靠巧合得到正确画面。

为资源留下简短使用说明：源文件路径、预期逻辑尺寸、实际显示倍率、过滤选择、透明边缘检查和未验证事项。压缩与 Mipmap 是否需要调整，应根据缩放与资源用途判断，不要把一张小像素图的实验结果直接套给所有背景和界面。完成结论可以写成“此测试 PNG 在指定条件下显示符合预期”；正式 Compatibility 场景和导出包的结果，仍应在对应环境分别验证。