Python中os.system调用时字符串插值致ImageMagick命令执行失败

问题现象 #

• 终端直接执行以下ImageMagick命令完全正常：

  convert -verbose -size 732x142 xc:transparent -fill black -stroke black -strokewidth 2 -draw "roundrectangle 0,0 732,142 18,18" "Sample Card Title.png"
  

• 但在Python脚本中通过字符串插值生成命令参数，用os.system或subprocess.run调用时，ImageMagick抛出错误：

  convert: non-conforming drawing primitive definition `roundrectangle' @ error/draw.c/RenderMVGContent/4506.
  

• 硬编码roundrectangle相关参数时，脚本执行正常；把脚本打印的命令复制到终端执行也没问题。

问题根源 #

插值生成的字符串中存在肉眼不可见的非ASCII字符，这些字符会破坏ImageMagick对绘图命令的解析逻辑，导致识别不了roundrectangle原语。

解决方案 #

1. 清理字符串中的非ASCII字符 #

编写简单的过滤函数，只保留可打印的ASCII字符：

def filter_non_ascii(s):
    # 只保留ASCII码小于128的字符（可打印ASCII范围）
    return ''.join(char for char in s if ord(char) < 128)

# 生成坐标字符串时不用额外加引号
rectangle_coordinates = f"roundrectangle 0,0 {mm_to_px(62)},{mm_to_px(box_height)} {mm_to_px(1.5)},{mm_to_px(1.5)}"
# 清理非ASCII字符
cleaned_coords = filter_non_ascii(rectangle_coordinates)

2. 优先使用subprocess.run的参数列表形式 #

避免手动拼接命令字符串，直接传递参数列表给subprocess.run，这样不需要处理引号转义，还能彻底避免字符解析问题：

import subprocess

subprocess.run([
    "convert", "-verbose", "-size", dimensions, "xc:transparent",
    "-fill", "black", "-stroke", "black", "-strokewidth", "2",
    "-draw", cleaned_coords, filename
])

调试小技巧 #

如果不确定是否存在非ASCII字符，可以把字符串转成ASCII码值列表查看：

print([ord(char) for char in rectangle_coordinates])

正常空格的ASCII码是32，如果出现其他数值（比如160，非断空格），就是需要清理的问题字符。

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