自定义导航栏返回按钮图片阴影被移除问题求助

开发者阿泽

2026-5-19

解决自定义导航返回按钮图片阴影消失的问题

我之前也碰到过完全一样的情况！问题根源在于iOS导航栏对返回按钮图片的默认渲染逻辑——它会把图片当作**模板图像（Template Image）**处理，自动用导航栏的tintColor统一着色，这就把你图片里自带的阴影细节给覆盖掉了，而UIImageView默认不会触发这个模板渲染，所以能正常显示阴影。

下面是两种高效的解决思路：

方案1：针对单个页面设置

在需要自定义返回按钮的ViewController里，给图片指定alwaysOriginal的渲染模式，让它保持原始像素信息：

// 加载你的返回箭头图片，并禁用模板渲染
let customBackImage = UIImage(named: "your-back-arrow-image")?.withRenderingMode(.alwaysOriginal)

// 创建自定义返回按钮并绑定点击事件
let backButton = UIBarButtonItem(image: customBackImage, style: .plain, target: self, action: #selector(backButtonTapped))

// 替换默认返回按钮
navigationItem.leftBarButtonItem = backButton

记得补充对应的点击回调：

@objc private func backButtonTapped() {
    navigationController?.popViewController(animated: true)
}

方案2：全局统一配置（全App生效）

如果你的App所有导航栏都需要用这个带阴影的返回按钮，可以在App启动时全局设置：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let backImage = UIImage(named: "your-back-arrow-image")?.withRenderingMode(.alwaysOriginal)
    // 同时设置返回按钮图和过渡遮罩图，保证转场动画正常
    UINavigationBar.appearance().backIndicatorImage = backImage
    UINavigationBar.appearance().backIndicatorTransitionMaskImage = backImage
    
    return true
}