如何在代码创建的GMSMapView视图上方显示UISearchBar？

我看你遇到的问题核心在于直接把view赋值成了GMSMapView，再加上子视图添加的逻辑错误，导致搜索栏无法正常显示。咱们一步步来修复：

问题根源分析 #

当你执行view = mapView时，当前ViewController的根视图就变成了GMSMapView实例。之后你调用view.insertSubview(searchbar, aboveSubview: view)是逻辑错误的——你不能把一个视图添加到它自己的上方，而且如果你的searchbar没有设置有效的frame，它的默认尺寸是CGRect.zero，自然看不到。

推荐解决方案：用ViewController的view作为容器 #

更合理的做法是把GMSMapView作为子视图添加到ViewController的view中，这样view作为容器可以同时容纳地图和搜索栏。修改后的代码如下：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 1. 初始化地图相机（替换成你需要的坐标）
    let camera = GMSCameraPosition.camera(withLatitude: 37.7749, longitude: -122.4194, zoom: 12.0)
    
    // 2. 创建地图视图，设置frame为view的bounds
    let mapView = GMSMapView.map(withFrame: view.bounds, camera: camera)
    mapView.delegate = self
    mapView.isMyLocationEnabled = true
    
    // 3. 把地图添加到ViewController的view上（而不是直接赋值view = mapView）
    view.addSubview(mapView)
    
    // 4. 初始化并配置搜索栏
    let searchbar = UISearchBar()
    searchbar.delegate = self
    searchbar.placeholder = "搜索地点"
    searchbar.backgroundColor = .white // 可选：设置背景色确保可见
    
    // 方式一：用frame设置位置（适合简单布局）
    searchbar.frame = CGRect(
        x: 20,
        y: view.safeAreaInsets.top + 10, // 适配刘海屏
        width: view.bounds.width - 40,
        height: 44
    )
    
    // 方式二：用Auto Layout（推荐，适配不同屏幕）
    // searchbar.translatesAutoresizingMaskIntoConstraints = false
    // NSLayoutConstraint.activate([
    //     searchbar.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 10),
    //     searchbar.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 20),
    //     searchbar.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -20),
    //     searchbar.heightAnchor.constraint(equalToConstant: 44)
    // ])
    
    // 5. 添加搜索栏到view上（后添加的子视图层级更高，会显示在地图上方）
    view.addSubview(searchbar)
}

如果你一定要把mapView作为根视图 #

如果坚持要让view = mapView，那可以直接把搜索栏添加到mapView上，同时确保设置正确的frame：

override func viewDidLoad() {
    super.viewDidLoad()
    
    let camera = GMSCameraPosition.camera(withLatitude: 37.7749, longitude: -122.4194, zoom: 12.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    mapView.delegate = self
    mapView.isMyLocationEnabled = true
    
    // 把mapView设为根视图
    view = mapView
    // 确保mapView的frame和view一致
    mapView.frame = view.bounds
    
    // 初始化搜索栏
    let searchbar = UISearchBar()
    searchbar.delegate = self
    searchbar.placeholder = "搜索地点"
    // 设置正确的frame
    searchbar.frame = CGRect(
        x: 20,
        y: view.safeAreaInsets.top + 10,
        width: view.bounds.width - 40,
        height: 44
    )
    
    // 添加到mapView上，不需要额外调用bringSubviewToFront（后添加的默认在最上层）
    mapView.addSubview(searchbar)
}

额外检查点 #

• 确认你的searchbar已经被正确初始化（如果是类属性，要先执行searchbar = UISearchBar()，不能是nil）
• 如果搜索栏还是看不见，可以尝试设置searchbar.backgroundColor = .white，避免和地图背景色混淆

内容的提问来源于stack exchange，提问作者user9397860