无法在Ubuntu与Mac上复现Wand/ImageMagick的一致结果

这种跨平台转PDF输出有差异的情况我之前踩过不少坑，结合你给出的版本信息，给你几个针对性的解决思路：

1. 统一GhostScript版本（最可能的核心原因） #

ImageMagick本身不直接处理PDF，是依赖GhostScript来渲染PDF内容的。哪怕你两台机器的ImageMagick版本完全一致，GhostScript版本不同的话，渲染出来的像素细节、字体对齐都会有细微差别，最终导致图片大小不同。

• 先在两台机器上运行 gs --version 检查版本，大概率是不一样的；
• 给Mac和Ubuntu安装完全相同版本的GhostScript（比如9.55.0，这个版本稳定性较好），然后重启Python服务再测试转换结果。

2. 固定所有转换参数，拒绝依赖默认值 #

不同系统的ImageMagick默认配置可能存在差异，比如默认分辨率、压缩级别、颜色空间，这些都会直接影响输出图片的大小和细节。你需要在代码里显式指定所有关键参数：

from wand.image import Image

with Image(
    filename="input.pdf",
    resolution=300,  # 固定分辨率，避免系统默认值不同
    colorspace="srgb"  # 统一颜色空间，消除色域差异
) as img:
    # 针对输出格式设置统一的压缩参数
    if img.format == "PNG":
        img.compression_quality = 95
        img.compression_method = 8  # 使用Deflate压缩，保证跨平台一致
    elif img.format == "JPEG":
        img.compression_quality = 90
        img.interlace_scheme = "nointerlace"  # 关闭隔行扫描，避免编码差异
    img.save(filename="output.png")

3. 统一字体渲染环境 #

PDF里的字体在不同系统上的渲染逻辑可能不一样，哪怕是同名字体，Mac和Ubuntu的字体文件也可能存在细微差异：

• 先用 pdffonts input.pdf 命令查看PDF中用到的字体；
• 把Mac上对应的字体文件复制到Ubuntu的 /usr/share/fonts 目录，然后运行 fc-cache -fv 更新字体缓存；
• 还可以在代码里显式指定字体路径，确保转换时用的是同一个字体文件：

  with Image(filename="input.pdf", resolution=300, font="/path/to/unified/font.ttf") as img:
      img.save(filename="output.png")
  

4. 检查ImageMagick的依赖库一致性 #

虽然ImageMagick版本号相同，但Mac和Ubuntu的编译依赖库（比如libpng、libjpeg、libtiff）版本可能不同，这也会导致输出差异：

• 在两台机器上运行 convert -list configure，对比 DELEGATES 字段里的依赖库版本；
• 如果差异较大，可以尝试在Ubuntu上编译安装和Mac相同版本的依赖库，再重新编译ImageMagick（这个操作稍复杂，优先尝试前面的方法）。

5. 验证像素级一致性（定位差异根源） #

如果前面的方法还没解决，可以用代码对比两张图片的像素，精准定位差异来源：

from PIL import Image as PILImage

img_mac = PILImage.open("mac_output.png")
img_ubuntu = PILImage.open("ubuntu_output.png")

# 逐像素对比找差异
diff_found = False
for x in range(img_mac.width):
    for y in range(img_mac.height):
        if img_mac.getpixel((x, y)) != img_ubuntu.getpixel((x, y)):
            diff_found = True
            print(f"差异位置：({x}, {y})")
            break
    if diff_found:
        break

通过这个方法你能明确是字体渲染的差异，还是颜色编码的差异，再针对性调整。

内容的提问来源于stack exchange，提问作者Edward Atkins