Matplotlib中Colorbar刻度值与标签不匹配问题求助

这问题我之前调试代码时也踩过坑，核心原因是自定义等高线层级和对数刻度的冲突，加上错误的刻度标签修改操作，咱们一步步理清楚：

首先先贴出你的代码和运行输出方便对照：

你的代码 #

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.colors import LogNorm
fig, ax = plt.subplots()
contour_levels = [10,100,500,1000,10000]
h = np.histogram2d(np.random.normal(0,2,10000),np.random.normal(0,2,10000),bins=10)
c = ax.contourf(h[0].T,cmap='magma',norm=LogNorm(),levels=contour_levels,extend='both')
cbar = plt.colorbar(c)
ticks = cbar.ax.yaxis.get_ticklabels()
cbar.ax.tick_params(which='minor',size=8,width=1,colors='white')
cbar.ax.tick_params(which='major',size=15,width=1,colors='white')
[t.set_color('black') for t in ticks]
ax.set_aspect('equal')
plt.show()

运行输出 #

print(ticks)
[Text(1, 10.0, '$\mathdefault{10^{1}}$'), Text(1, 56.234132519034915, '$\mathdefault{10^{2}}$'), Text(1, 316.2277660168379, ''), Text(1, 1778.2794100389228, '$\mathdefault{10^{3}}$'), Text(1, 10000.0, '$\mathdefault{10^{4}}$')]

核心成因拆解 #

1. LogNorm的自动刻度逻辑与自定义levels不兼容
   当你用LogNorm()时，matplotlib会默认生成对数等距的刻度：主要刻度是10的整数次幂（10¹、10²、10³、10⁴），次要刻度是对数空间里的中间点（比如56.23≈10^{1.75、316.23≈10}2.5）。但你指定的contour_levels是[10,100,500,1000,10000]，其中500并不是10的整数次幂，这就导致colorbar同时要适配你的自定义层级和自动生成的对数刻度，两者的位置完全不对齐。

2. 错误的刻度标签修改操作
   你通过cbar.ax.yaxis.get_ticklabels()获取的ticks列表，是主要刻度标签+次要刻度标签的混合体。你做了两个冲突的操作：

   • 先给次要刻度的tick设置了白色，又把所有ticks（包括次要刻度的标签）改成黑色；
   • 更关键的是，那些错位的标签（比如56.23位置的10²）本来是对应主要刻度100的标签，但因为自定义层级插入了500，matplotlib把这个标签错放到了次要刻度的位置上，而你修改颜色的操作没有区分主次刻度，直接把所有标签强制显示，就出现了标签和刻度位置完全不匹配的情况。

3. 空白标签的来源
   输出里那个空字符串的Text对象，对应你自定义的500这个层级——因为它不是10的整数次幂，LogNorm不会自动生成对应的对数格式标签，所以就留空了，同时这个位置又和自动生成的次要刻度（316.23）重叠，进一步加剧了混乱。

简单说就是：自定义的非对数等距层级打乱了LogNorm的自动刻度映射，加上你没区分主次刻度就修改标签颜色，最终导致了刻度和标签错位的问题。

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