Python中如何微调大语言模型LLaMA：借助PEFT框架与LoRA低秩自适应技术
说到微调LLaMA这类大模型，直接上全参数训练？这可不是个好主意。显存压力大、训练速度慢，还容易陷入过拟合的泥潭。目前来看，PEFT框架配合LoRA技术，算是最为可行的轻量化方案。但问题的关键，从来不是“代码能不能跑起来”，而是“如何确保LoRA真正生效，并且不干扰模型原始的推理能力”。
确认模型是否支持 PEFT 的 LoRA 注入
首先得明确一点：并非所有的LLaMA变体都能开箱即用地支持PEFT。像Hugging Face官方的LlamaForCausalLM（例如meta-llama/Llama-2-7b-hf）是没问题的。但一些社区魔改版本，比如为了适配llama.cpp或者自定义了forward逻辑的分支，可能会绕过标准的nn.Linear层，导致peft.get_peft_model静默失败——也就是看起来成功了，实则LoRA根本没挂载上。
- 检查关键模块类型：核心在于确认模型中的线性层是否标准。例如，
model.model.layers[0].self_attn.q_proj、v_proj、o_proj，以及MLP层的up_proj、down_proj等，必须是torch.nn.Linear的实例。否则，LoRAConfig里的target_modules列表将无法匹配到目标。 - 快速验证方法：一行代码就能搞定：
print(type(model.model.layers[0].self_attn.q_proj))。如果输出是类似 - 版本底线：
transformers库版本建议不低于4.35，peft库不低于0.7.0。更早的版本对LLaMA-2这类将Q/K/V投影层分离的结构支持可能不完整。
LoRA 配置里 target_modules 别硬写 “q_proj,v_proj” 就完事
配置target_modules时，想当然地照搬旧方案可能会踩坑。LLaMA-2的注意力层确实包含了q_proj, k_proj, v_proj，但不同变体或分词器的命名可能有细微差别。盲目指定会导致部分权重未被注入LoRA，训练时梯度更新不完整。结果就是，损失函数（loss）看起来在下降，但模型的实际生成质量却停滞不前。
- 推荐使用正则匹配列表：一个比较稳妥的配置是：
target_modules = [“q_proj”, “k_proj”, “v_proj”, “o_proj”, “gate_proj”, “up_proj”, “down_proj”]。这基本覆盖了LLaMA-2官方结构中的所有线性层。 - 注意模型变体：如果你用的是
Llama-3，需要注意它可能包含lm_head。不过，通常不建议对语言模型头（lm_head）施加LoRA，因为这可能会干扰logits的原始分布，除非你正在进行明确的指令微调或分类头对齐任务。 - 超参数起点：
r=8（秩）、lora_alpha=16、lora_dropout=0.05是一个相对稳健的起始点。要知道，把r设到64在7B模型上，其显存占用已经接近全参数微调了，性价比不高。
训练时 model.train() 不等于 LoRA 参数在更新
这是一个常见的误区。PEFT默认会冻结基础模型（base model）的所有参数，只训练LoRA引入的A和B矩阵。但是，如果错误地调用了model.base_model.model.train()，或者在集成DeepSpeed等复杂训练框架时漏掉了model.enable_input_require_grads()，就可能出现一种诡异的情况：损失曲线在下降，但lora_A的梯度始终为零。
立即学习“Python免费学习笔记（深入）”；
- 必做检查：务必调用
model.print_trainable_parameters()。正常的输出应该类似于：trainable params: 3,932,160 || all params: 3,195,492,352 || trainable%: 0.123。如果显示可训练参数为0，或者比例远低于预期，那基本可以断定LoRA没有成功挂载。 - 使用 Trainer 的注意事项：确保
model = get_peft_model(model, peft_config)这一步在初始化Trainer之前就已经完成。同时，避免在data_collator或compute_loss函数内部再次包装模型。 - 梯度检查点兼容性：如果开启了
gradient_checkpointing=True以节省显存，必须同步调用model.gradient_checkpointing_enable()。否则，在反向传播过程中，LoRA部分的梯度计算链可能会意外中断。
推理时别忘了 merge_and_unload 或 set_adapter
训练结束后，得到的PeftModel可不能直接拿去调用generate函数。因为它默认仍然处于“LoRA分离”模式，权重没有融合。而如果直接使用model.merge_and_unload()，虽然能合并权重，却又失去了基础模型复用、快速切换不同适配器的灵活性。
- 部署阶段推荐策略：保留适配器（adapter）通常是更优选择。使用
model.set_adapter(“default”)切换到目标适配器，再进行model.generate(...)。这种方式支持多个LoRA适配器的热切换，非常适合对不同微调任务进行A/B测试。 - 导出为通用格式：如果需要将模型导出为标准Hugging Face格式供其他框架加载，必须先执行
model = model.merge_and_unload()合并权重，再使用model.sa ve_pretrained(“merged_model”)保存。否则，保存的将是PEFT配置和增量权重，而非一个完整的模型检查点。 - 合并后的验证：权重合并后，强烈建议使用
torch.allclose(base_model_output, merged_model_output)对比相同输入下，基础模型和合并后模型的输出logits是否一致。一个常见的错误是，在merge_and_unload之后没有调用model.eval()，导致推理时仍然受到dropout的影响。
说到底，LoRA微调真正的难点，不在于写几行跑通的代码，而在于精准判断哪些层需要添加适配器、如何验证适配器确实参与了梯度更新。仅仅盯着损失曲线是会被“欺骗”的，有时候你得深入到model.base_model.model.layers[0].self_attn.q_proj.lora_A里面，亲手print(param.grad)看一眼，心里才踏实。
