imagettftext()的y参数是字体基线位置而非文字顶部，故直接用imagesy($img)-10会导致文字被截断；正确做法是先调用imagettfbbox()获取包围盒，再通过$bbox[7]-$bbox[1]计算基线到顶部距离并修正y坐标。
GD库里文字坐标为什么总偏移？
因为imagettftext()的y参数不是文字左上角，而是基线（baseline）位置——也就是字母“x”的底部所在行。你传100，实际文字顶部可能在70甚至更高，取决于字体和字号。很多开发者误以为这是“文字顶部”，结果水印总被切掉上半部分或压得太低。
真正决定文字垂直位置的是imagettfbbox()返回的包围盒数据，它包含8个坐标点，对应文字四个角（左上、右上、左下、右下），但顺序不直观。必须用min()和max()手动算出真实宽高，再结合基线偏移推导出起始y。
-
imagettfbbox()返回数组索引：[0,1]左下、[2,3]右下、[4,5]右上、[6,7]左上 - 文字高度 ≈
max($bbox[1], $bbox[3], $bbox[5], $bbox[7]) - min($bbox[1], $bbox[3], $bbox[5], $bbox[7]) - 基线到文字顶部的距离 ≈
$bbox[7] - $bbox[1]（即左上y减左下y） - 若想让文字顶部对齐某行
$y_top，应传入$y = $y_top + abs($bbox[1] - $bbox[7])
拖拽式定位时怎么实时换算鼠标坐标？
浏览器拖拽的像素坐标不能直接喂给imagettftext()——画布缩放、CSS尺寸与实际图像分辨率不一致时，坐标会错位。比如前端显示为400×300的<img>，后端生成的可能是800×600真尺寸图，鼠标点(200, 150)对应的真实绘制点其实是(400, 300)。
解决办法是前后端约定一个缩放比例，或让前端主动上报原始图像尺寸与显示尺寸比值：
立即学习“PHP免费学习笔记（深入）”；
- 后端生成图时，记录
$real_width和$real_height - 前端用
img.naturalWidth / img.clientWidth算出横向缩放比，同理得纵向比 - 鼠标坐标
(clientX, clientY)→ 真实坐标(clientX * scale_x, clientY * scale_y) - 这个真实坐标才是
imagettftext()中$x和$y该填的值
文字居中对齐怎么写才不翻车？
所谓“居中”，本质是把文字包围盒中心点对齐到目标点。但imagettftext()只接受左下基线点坐标，所以必须先算出包围盒中心，再反推基线点位置。
例如要在图片中心($center_x, $center_y)放置文字，步骤如下：
- 用
imagettfbbox($size, 0, $font, $text)拿到$bbox - 计算包围盒宽度：
$w = max($bbox[2], $bbox[4]) - min($bbox[0], $bbox[6]) - 计算包围盒高度（从顶到底）：
$h = max($bbox[1], $bbox[3]) - min($bbox[5], $bbox[7]) - 基线y位置 =
$center_y + $h / 2 - ($bbox[7] - $bbox[1]) / 2（关键！抵消基线偏移） - 基线x位置 =
$center_x - $w / 2 - 最终调用：
imagettftext($img, $size, 0, $x, $y, $color, $font, $text)
漏掉$bbox[7] - $bbox[1]这一项，文字就会整体上浮或下沉一截，尤其在大字号时特别明显。
字体路径和编码问题怎么快速排查？
文字显示为空白或方块，90%不是坐标错，而是字体或编码没对上。GD库对字体文件路径敏感，且默认按当前脚本编码（通常是UTF-8）解析字符串，但某些TTF文件内部元数据声明的是GBK或Latin-1。
- 确保
$font路径是绝对路径，用realpath()验证存在：realpath('/var/www/fonts/arial.ttf') - 检查Web服务器是否有读取权限：
ls -l /var/www/fonts/arial.ttf - 如果文字含中文，优先用支持CJK的字体（如
NotoSansCJK.ttc或simhei.ttf），避免用Windows自带arial.ttf - 用
mb_detect_encoding($text)确认字符串编码；必要时强制转码：iconv('UTF-8', 'UTF-8//IGNORE', $text) - 临时加一句
error_log(print_r($bbox, true), 3, '/tmp/gd_debug.log')，看imagettfbbox()是否返回全0——若是，基本确定字体加载失败
坐标算得再准，字体没加载成功，也只会输出空白。这一步必须放在坐标计算之前验证。
