手写MultiHeadAttention需注意:q@k.T/sqrt(d_k)维度对齐与归一化、mask用-inf且形状为[B,1,L,L]、q/k/v线性层bias=False、reshape用transpose而非view、FFN后必须接residual+LayerNorm、dropout置于add前、验证时检查attn_weights分布与梯度。

PyTorch里自己写MultiHeadAttention要注意什么
直接复用 torch.nn.MultiheadAttention 最省事,但如果你想控制每个计算步骤(比如改mask逻辑、换score函数、插自定义归一化),就得手写。关键不是“能不能写”,而是别在 q @ k.T / sqrt(d) 这步手动写错维度或漏除以 sqrt(d_k) —— 这会导致梯度爆炸或注意力全趋同。
常见错误现象:RuntimeError: mat1 and mat2 shapes cannot be multiplied,基本是 q 和 k 的最后两维没对齐(比如 q: [B, H, L, D] 却和 k: [B, L, H, D] 盲算);或者 attn_weights softmax 前没 mask 掉 padding 位置,训练时 loss 突然 nan。
- 输入
x先过三个线性层得到q,k,v,注意 bias 默认要设为False(官方实现也这么干,避免和后续 LayerNorm 冲突) - 把
q/k/vreshape 成[B, H, L, D_h]形式再计算,别用view硬压——用transpose(1, 2)更安全 - mask 必须是
[B, 1, L, L]或[1, 1, L, L],广播时才不翻车;填-inf而非0,否则 softmax 后残留干扰项
用einsum写Scaled Dot-Product Attention更清晰还是更慢
einsum 不是银弹。它让维度操作显式可读(比如 "b h l d, b h s d -> b h l s" 直观表达 qk^T),但 PyTorch 1.12+ 对 einsum 的优化仍弱于原生 @ 和 matmul,尤其 batch 小、序列短时,开销高 15–20%。
真正适合用 einsum 的场景:需要混洗多个轴做复杂 contraction(比如把 relative position bias 加进 attention score),或调试时临时拆解某一步维度变换。
立即学习“Python免费学习笔记(深入)”;
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 写
einsum前先确认所有下标字母唯一且长度匹配,"b h l d, b h d s -> b h l s"比"bhld,bhds->bhls"更少手滑 - 不要在 forward 里反复调用
einsum做相同 shape 的运算——提前用@写好,einsum留给真正需要它表达力的地方 - 如果用了
torch.compile,某些einsum表达式可能无法被 trace,报UnsupportedNodeError,这时得切回transpose + matmul
Position-wise FFN之后要不要再接LayerNorm
标准 Transformer 是 “Sublayer → Dropout → Add → Norm”,也就是 LayerNorm(x + Sublayer(x))。如果你手写 attention 层后直接连 FFN,FFN 输出**不能**直接进下一个 attention——必须加 residual + norm。漏掉这步,模型根本训不起来,loss 下降极慢,attention map 一片模糊。
容易被忽略的点:norm 的 eps 值。官方实现用 1e-5,但有些论文(如 ALiBi)建议用 1e-6 配合 fp16 训练。你如果加载 HuggingFace 权重,得保持一致,否则推理输出偏差明显。
- FFN 两个线性层之间用
GELU,别用ReLU—— 后者在torch.compile下可能触发 shape 推断失败 - Dropout 要放在每个 sublayer 输出后、add 之前,顺序错会导致 dropout 掩盖 residual 连接效果
- 如果模型要跑 TPU,避免在 norm 前用
torch.mean(x, dim=-1, keepdim=True)这类跨设备同步开销大的操作
怎么验证自定义Attention真的在学东西
最简单的办法:固定输入,打印训练前后几层的 attn_weights[0, 0, :5, :5](第一个 head 前 5×5 的 attention score)。初始化时应接近均匀分布;训 100 step 后,同一句子中动词和宾语位置的权重应该明显高于无关词对。
别依赖可视化工具(如 BertViz)第一眼判断——它默认归一化整个矩阵,会掩盖局部差异。真要看机制是否生效,得结合梯度:在 attn_weights 上加 register_hook,检查反向传播时各位置梯度是否非零且有结构(比如句首/句尾梯度持续偏低,说明 mask 生效)。
- 用
torch.no_grad()抽样几个 batch,统计每层 attention entropy:entropy 太低(3.0)说明没聚焦 - 如果用了 causal mask,确保
attn_weights[:, :, i, j] == 0对所有j > i成立,哪怕在 eval 模式下也要测——有些实现只在 train 时 mask - 多头之间权重差异小(std q/k/v 的线性层是否共享了 weight,或
nn.init.xavier_uniform_范围设得太窄

















