Makie.jl 中 contour 绘图标签格式化函数的注意事项

在使用 Makie.jl 进行科学可视化时，contour 函数是一个非常实用的工具，它可以绘制等高线图并添加标签。然而，在使用过程中有一个容易被忽视的细节需要特别注意 - 关于标签格式化函数(labelformatter)的作用域问题。

问题现象

当我们在同一个坐标轴上连续绘制多个等高线图时，如果使用相同的变量名定义不同的标签格式化函数，可能会出现意外的行为。例如：

fig = Figure()
ax = Axis(fig[1,1])

# 第一个等高线图
x = y = 0:0.1:10
levels = 0:10
labelformatter(v) = map(x -> "第一个等高线 $x", v)
contour!(ax, x, y, x .- y'; levels, labels=true, labelformatter)

# 第二个等高线图
x = y = -10:0.1:0
levels = -10:0
labelformatter(v) = map(x -> "第二个等高线 $x", v)
contour!(ax, x, y, x .+ y'; levels, labels=true, labelformatter)

在这种情况下，两个等高线图的标签都会显示为"第二个等高线 X"，而不是预期的各自显示不同的标签格式。

原因分析

这种现象并非 Makie.jl 的 bug，而是 Julia 语言本身的特性。在 Julia 中，函数定义会覆盖之前的同名函数定义。由于等高线标签在坐标轴布局变化时会重新绘制，因此会使用最新的函数定义。

解决方案

有几种方法可以避免这个问题：

1. 使用不同的函数名：

labelformatter1(v) = map(x -> "第一个等高线 $x", v)
labelformatter2(v) = map(x -> "第二个等高线 $x", v)

2. 使用匿名函数：

contour!(ax, x, y, x .- y'; levels, labels=true, 
         labelformatter = v -> map(x -> "第一个等高线 $x", v))

3. 使用闭包捕获不同的格式化字符串：

function make_formatter(prefix)
    return v -> map(x -> "$prefix $x", v)
end

contour!(ax, x, y, x .- y'; levels, labels=true, 
         labelformatter = make_formatter("第一个等高线"))

最佳实践建议

1. 在同一个脚本或函数中定义多个标签格式化函数时，始终使用不同的变量名或函数名
2. 考虑使用工厂函数(如上面的make_formatter)来创建具有不同前缀的格式化函数
3. 对于简单的格式化需求，直接在contour调用中使用匿名函数

理解这一行为有助于开发者在使用Makie.jl进行复杂可视化时避免混淆，特别是在需要叠加多个图层并自定义其标签显示的情况下。