【案例复盘】异形地图坐标漂移：镜头偏移的事故复盘

实战应用：用在哪里

新开放的异形地图上线后，玩家反馈角色走到东侧海岸时镜头整体偏移半个屏，小地图标记全部错位。复盘发现异形地图的绘制原点与逻辑原点不一致，坐标换算少加了偏移量，一次美术资源的调整变成了全员 bug。

事故的还原

通用地图组件按矩形地图的左上角原点做坐标换算，异形地图的美术原点在中心，两套原点差了半个地图宽，所有 UI 标记整体偏移三百像素。

local function toScreenV1(wx, wy)
    return wx * TILE, wy * TILE
end

直接乘格子尺寸的换算没算绘制原点偏移，矩形地图看不出问题，异形地图原点一变就穿帮。

原点偏移的补丁

补丁在地图配置里登记原点偏移量，换算统一叠加偏移，矩形地图的偏移量配零，异形地图配真实偏移。

local ORIGIN = { x = 150, y = 80 }
local function toScreenV2(wx, wy)
    return wx * TILE + ORIGIN.x, wy * TILE + ORIGIN.y
end

验证与监控

地图四角与中心五点的坐标换算抽样断言；换地图时的原点配置自动随图加载。上线后镜头类反馈归零，原点配置进了地图规范，新地图提审时必须附原点参数。

踩坑记录

ORIGIN写死在组件里等于换一张异形图就改一次代码，偏移量必须进地图配置表随图加载。负坐标的异形地图原点在图内时换算结果为负值，渲染层对负坐标做钳制会吃掉边缘标记，钳制策略要可配置。美术调整地图尺寸后原点偏移同步变化，尺寸与偏移的联动校验加进资源提审脚本。同类事故的通用教训：任何坐标换算都要先问“原点在哪”，坐标体系的文档每张地图一份。