PyTorch中用register_forward_hook提取某层输出最直接：需目标层对象可访问，钩子函数签名固定为hook(module, input, output)，output即特征图；必须在model.forward()前注册、执行后及时handle.remove()，且output须存入外部容器（如dict），不可赋值局部变量。
PyTorch中用register_forward_hook提取某层输出最直接
只要目标层对象可访问（比如model.layer3或model.features[5]），就能挂载钩子捕获前向传播时的输出。钩子函数签名固定为hook(module, input, output)，其中output就是你要的特征图。
常见错误是把钩子挂到整个模型上，结果拿到的是最终logits而非中间层；或者在eval()模式下忘记torch.no_grad()，导致显存暴涨——其实forward本身不计算梯度，但没关掉的话output仍带requires_grad=True，后续操作容易误触发反向传播。
- 钩子必须在
model.forward()调用前注册，且不能在forward内部临时注册 - 如果只取一次特征，注册后记得用
handle.remove()及时清理，否则每次forward都重复执行 -
output可能是tuple（如某些CNN+BN组合），需先print(type(output))确认结构
提取多层特征时别用多个独立register_forward_hook
同时监控3层以上时，手动管理一堆handle极易出错，更稳妥的方式是封装一个FeatureExtractor类，内部用字典缓存各层输出，并支持按层名或序号索引。
关键点在于：钩子函数里不能直接赋值全局变量，而应写入预先定义的容器（如self._features）；另外，module参数可用于区分不同层——比如检查isinstance(module, torch.nn.Conv2d)或比对module.__class__.__name__，避免硬编码层名。
立即学习“Python免费学习笔记（深入）”；
- 层名可能随模型结构变化（如ResNet的
layer2.1.conv2vslayer2.0.conv1），建议用named_modules()遍历后筛选 - 若需梯度信息（如做特征可视化），改用
register_full_backward_hook，但注意它只在loss.backward()后触发 - 某些层（如
nn.Sequential）本身不存储参数，其子模块才是实际计算单元，钩子要挂在子模块上
output形状不对？检查是否漏了unsqueeze(0)或permute()
输入图像通常为(H, W, C)，但PyTorch要求(N, C, H, W)。如果传入单张图却没加batch维，output会少一维，导致后续torch.nn.functional.interpolate等操作报错：Expected 4-dimensional input。
另一个高频坑是预训练模型（如ViT、Swin）输出含cls_token，此时output形状为(N, L+1, D)，直接当空间特征图用会出错。得先切片去掉[:, 0]再reshape回(N, D, H, W)。
- 打印
output.shape永远是第一步，尤其在加载不同backbone时 - CV任务中常用
output = output[:, 1:].permute(0, 2, 1).reshape(N, D, H, W)还原空间结构 - 如果模型用了
torch.compile，钩子可能失效——目前compile不支持钩子机制，调试阶段需临时禁用
Hook在DataParallel或DistributedDataParallel下行为异常
多卡训练时，DataParallel会把模型复制到各GPU，但钩子只注册在主卡模型上，其他卡的输出无法捕获；DistributedDataParallel虽不复制模型，但钩子注册位置若在model.module之外，也会因分布式包装导致module引用错乱。
解决方法很直白：确保钩子注册在model的最外层包装体上（即model本身），而不是model.module；如果是DataParallel，则必须在每个GPU上单独注册（通过torch.cuda.set_device()切换后注册），但更推荐直接迁移到DistributedDataParallel。
- 验证是否生效：在钩子函数里加
print(f"GPU {torch.cuda.current_device()}: {output.shape}") - DDP下
model.named_modules()返回的module对象已自动适配，无需额外处理 - 一旦用了
torch.compile，就别指望钩子能稳定工作——这是当前版本明确不支持的组合
.cpu().detach().numpy()，直接转PIL或保存会导致显存泄漏；而跨进程通信（如用torch.multiprocessing）时，钩子函数不能包含不可序列化的对象（如lambda、未绑定方法）。 
