解决CustomTkinter中CTkLabel图片适配的拉伸黑边问题

• 调整CTkLabel的布局约束
  用sticky="nsew"会让Label完全填充所在的grid单元格，若Frame的单元格被拉伸，Label也会跟着变形。可以给Label固定width=272和height=153，同时设置maxsize=(272,153)和minsize=(272,153)，避免被强制拉伸。或者直接去掉sticky="nsew"，改用padx和pady参数让Label在Frame中居中显示。

• 修正图片处理逻辑

  • 使用ImageOps.fit()裁剪图片时，确认传入的目标尺寸是(272, 153)，裁剪后打印图片尺寸检查是否符合预期，避免因原图片比例问题导致裁剪偏差。
  • 生成圆角遮罩时，必须基于裁剪后的图片尺寸创建，确保遮罩和图片像素完全匹配，示例代码：

    mask = Image.new("L", cropped_image.size, 0)
    draw = ImageDraw.Draw(mask)
    draw.rounded_rectangle((0, 0) + cropped_image.size, radius=12, fill=255)
    cropped_image.putalpha(mask)
    

  • 转换为CTkImage时，明确指定size=(272,153)，避免自动缩放导致尺寸不匹配：

    ctk_image = customtkinter.CTkImage(light_image=cropped_image, size=(272,153))
    

• 优化CTkLabel的显示设置
  将CTkLabel的fg_color设为"transparent"，避免Label背景色透过图片圆角边缘显示出黑边；同时确保Label的corner_radius=12和图片遮罩的圆角半径一致，避免视觉上的错位。

• 尝试替代布局方式
  如果需要Label随Frame自适应但保持图片比例，可以改用place布局：

  label.place(relx=0.5, rely=0.5, anchor="center", relwidth=1, relheight=1)
  

  同时转换CTkImage时不指定固定size，让图片自动按Label的比例缩放，再配合圆角遮罩，能更好地适配不同尺寸的容器。

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