Matplotlib双对数图自定义刻度异常：是否为Bug？

问题现象 #

• 配置x轴自定义刻度为[1, 1/2, 1/4, 1/8]，搭配ScalarFormatter并隐藏次要刻度后，图表仍出现额外异常刻度
• 新增刻度值1/16后，刻度显示恢复正常
• 正常显示的版本中设置x轴范围（xlim）后，异常刻度再次出现

问题原因 #

这不是Matplotlib的Bug，而是对数轴刻度生成的特性导致的：

• 对数轴默认依赖LogLocator自动生成刻度，当仅用set_xticks设置少量自定义刻度时，Matplotlib内部的自动刻度逻辑并未完全被覆盖，仍会补充生成额外刻度
• 当自定义刻度数量达到一定阈值（比如5个），自动刻度生成逻辑会被抑制，所以新增1/16后显示正常
• 设置xlim会触发轴的刻度重新计算，此时自动刻度逻辑再次介入，导致异常刻度重现

解决方法 #

要彻底固定自定义刻度，需要显式禁用自动刻度生成逻辑，具体步骤：

• 使用FixedLocator强制指定刻度位置，替代默认的自动定位器
• 配合ScalarFormatter设置刻度格式
• 隐藏次要刻度

示例代码：

import matplotlib.pyplot as plt
from matplotlib.ticker import ScalarFormatter, FixedLocator

fig, ax = plt.subplots()
ax.loglog()

# 自定义刻度列表
custom_xticks = [1, 1/2, 1/4, 1/8]
# 强制固定刻度位置，禁用自动生成
ax.xaxis.set_major_locator(FixedLocator(custom_xticks))
# 设置刻度显示格式
ax.xaxis.set_major_formatter(ScalarFormatter())
# 完全隐藏次要刻度
ax.xaxis.set_minor_locator(plt.NullLocator())

# 即使设置x轴范围也不会出现异常刻度
ax.set_xlim(1/8, 1)

plt.show()

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