learningratescheduler仅动态调整优化器学习率而非更新模型参数，需配合model.fit()使用；其本质是epoch级回调函数，接收epoch索引（从0开始）并返回python float型学习率，须注意tf版本对应属性名（learning_rate或lr）及warmup时的step计数。
LearningRateScheduler 本身不调整模型参数，它只负责在训练过程中按规则修改优化器的学习率；真正更新参数的是 optimizer.step()，而学习率只是这个过程中的一个缩放因子。
LearningRateScheduler 的本质是回调函数
它不是模型层或可训练参数，而是在每个 epoch（或 batch）结束时被调用的函数，输入是当前 epoch 索引，输出是新的学习率值。Keras 的 LearningRateScheduler 会把该值写入 optimizer.lr（TF 2.x 中可能是 optimizer.learning_rate），后续梯度更新就自然使用这个新值。
- 必须配合
model.fit()使用，手动训练循环中需自行调用并赋值 - 传入的 schedule 函数接收
epoch（从 0 开始），返回 float 学习率 - 若使用
tf.keras.optimizers.Adam等，确保访问的是正确的学习率属性名：optimizer.learning_rate（TF 2.11+）或optimizer.lr（旧版） - 常见错误：
AttributeError: 'Adam' object has no attribute 'lr'—— 这说明你用了新版 TF 却还在读.lr
自定义 schedule 函数要注意 epoch 起始和类型
schedule 函数第一个参数是 epoch，Keras 默认从 0 开始计数，但有些教程误以为从 1 开始，导致第 0 个 epoch 就触发衰减，实际还没开始训练。
- 想实现“第 10 个 epoch 后开始衰减”，判断条件应为
if epoch >= 9:（因为 epoch=0 是第 1 轮） - 返回值必须是 Python float，不能是
np.float32或 TensorFlow 张量，否则可能报TypeError: float() argument must be a string or a number - 示例：线性衰减到 1e-5
def lr_schedule(epoch):
initial_lr = 1e-3
min_lr = 1e-5
decay_epochs = 50
if epoch <p>然后传给 <code>LearningRateScheduler(lr_schedule)</code> 即可。</p><h3>batch 级别调整要用 LearningRateScheduler + 自定义训练循环</h3><p>Keras 内置的 <code>LearningRateScheduler</code> 只支持 epoch 级别；如果要每 batch 更新学习率（比如 warmup），必须绕过它，改用 <code>tf.keras.backend.set_value()</code> 或直接赋值 <code>optimizer.learning_rate</code>。</p>
- 在
@tf.function训练步骤内，用optimizer.learning_rate.assign(new_lr)安全更新 - 避免在 tf.function 外部用
set_value()修改，可能导致图缓存失效或值未同步 - 常见陷阱：warmup 阶段用
epoch计算步数，但 batch 数远大于 epoch 数，结果 warmup 时间远短于预期 - 正确做法是维护一个全局 step 计数器（
tf.Variable），每次 step 加 1，再按 total_steps 做比例计算
真正容易被忽略的点是：学习率变化不会自动重置优化器内部状态（如 Adam 的一阶/二阶矩估计），所以大幅降低学习率后，历史梯度累积可能不再匹配新尺度——这时往往需要配合 weight decay 或重新初始化优化器状态，但 Keras 默认不提供这种干预入口。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
