Swift中导航栏右侧按钮不可见及相关报错问题求助

错误信息翻译 #

UINavigationBar 被解析为未锁定状态（针对UINavigationController），或者navigationBar代理设置不正确。配置不一致可能会导致问题。

右侧导航按钮不显示的原因及修复 #

核心问题：访问了错误的navigationItem #

你当前代码中修改的是window?.rootViewController?.navigationItem，但你的根视图控制器是UINavigationController，它自身的navigationItem并不会在界面上显示——导航栏实际使用的是导航控制器栈顶视图控制器（你的目标VC）的navigationItem。

修复方案1：在AppDelegate中正确获取栈顶VC #

修改didFinishLaunchingWithOptions方法中的代码：

var window: UIWindow?

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 确认根视图控制器是UINavigationController
    guard let navController = window?.rootViewController as? UINavigationController else {
        return true
    }
    // 获取栈顶的视图控制器，并设置右侧按钮
    let button = UIBarButtonItem(title: "Logs", style: .plain, target: self, action: #selector(logButtonTapped))
    navController.topViewController?.navigationItem.rightBarButtonItem = button
    return true
}

@objc private func logButtonTapped() {
    // 按钮点击逻辑示例
    print("Logs button tapped")
}

修复方案2：推荐——在视图控制器内部设置按钮（更符合MVC规范） #

把按钮设置代码移到你的目标VC的viewDidLoad方法中，避免在AppDelegate中操作视图控制器的UI：

class YourViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        let button = UIBarButtonItem(title: "Logs", style: .plain, target: self, action: #selector(logButtonTapped))
        navigationItem.rightBarButtonItem = button
    }

    @objc private func logButtonTapped() {
        print("Logs button tapped")
    }
}

控制台错误的修复 #

针对UINavigationBar decoded as unlocked...的错误，检查以下两点：

• 打开故事板，选中你的UINavigationController，在右侧属性面板中找到Navigation Bar的Locked选项，确保它处于勾选状态（UINavigationController默认应管理自己的导航栏，锁定状态是正确配置）。
• 确认你没有在代码中手动给navigationBar设置代理，这会和UINavigationController的默认管理逻辑冲突。

内容的提问来源于stack exchange，提问作者Mert Köksal