iOS文件夹内容展示异常排查：FolderContentsViewController无内容显示

核心问题分析 #

• 数据源未正确初始化：FolderContentsViewController的folderContents数组大概率未被赋值，导致numberOfItemsInSection返回0，CollectionView没有可展示的cell。
• Cell设计逻辑错误：HoldGroupCell中的configureContents方法完全违背CollectionView的复用机制，试图在单个cell内部创建并添加子cell，且self.folderURL调用时可能为nil，引发崩溃。
• Cell配置冗余且失效：cellForItemAt中重复设置label和图片，未复用已有的configure(with:)方法；若图片名与文件夹名不匹配，图片会显示空白。
• 子Cell无布局约束：即便configureContents创建了子cell，也未设置frame或约束，导致子cell无法显示。

修复方案 #

1. 修正数据源加载逻辑 #

在FolderContentsViewController中确保接收选中的文件夹URL，并正确加载内容：

class FolderContentsViewController: UIViewController {
    var selectedFolderURL: URL!
    var folderContents: [URL] = []
    @IBOutlet weak var collectionView: UICollectionView!
    let fileManager = FileManager.default
    
    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView.register(HoldGroupCell.self, forCellWithReuseIdentifier: "HoldGroupCell")
        loadFolderContents()
    }
    
    private func loadFolderContents() {
        do {
            // 加载文件夹内容，跳过隐藏文件
            folderContents = try fileManager.contentsOfDirectory(
                at: selectedFolderURL,
                includingPropertiesForKeys: [.isDirectoryKey],
                options: [.skipsHiddenFiles]
            )
            collectionView.reloadData()
        } catch {
            print("加载文件夹失败：\(error.localizedDescription)")
        }
    }
}

2. 重构HoldGroupCell，删除错误方法 #

让Cell仅负责单个文件/文件夹的展示，移除不合理的configureContents方法：

class HoldGroupCell: UICollectionViewCell {
    
    let folderImageView: UIImageView = {
        let imageView = UIImageView()
        imageView.contentMode = .scaleAspectFit
        imageView.translatesAutoresizingMaskIntoConstraints = false
        return imageView
    }()
    
    let folderNameLabel: UILabel = {
        let label = UILabel()
        label.font = UIFont.systemFont(ofSize: 16)
        label.textColor = .black
        label.textAlignment = .center
        label.translatesAutoresizingMaskIntoConstraints = false
        return label
    }()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        
        contentView.addSubview(folderImageView)
        contentView.addSubview(folderNameLabel)
        
        NSLayoutConstraint.activate([
            folderImageView.centerXAnchor.constraint(equalTo: contentView.centerXAnchor),
            folderImageView.centerYAnchor.constraint(equalTo: contentView.centerYAnchor, constant: -10),
            folderImageView.widthAnchor.constraint(equalToConstant: 50),
            folderImageView.heightAnchor.constraint(equalToConstant: 50),
            
            folderNameLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            folderNameLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            folderNameLabel.topAnchor.constraint(equalTo: folderImageView.bottomAnchor, constant: 5),
            folderNameLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor)
        ])
    }
    
    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    func configure(with itemURL: URL) {
        folderNameLabel.text = itemURL.lastPathComponent
        
        var isDir: ObjCBool = false
        FileManager.default.fileExists(atPath: itemURL.path, isDirectory: &isDir)
        
        // 设置对应图标，优先用通用图标避免空白
        if isDir.boolValue {
            folderImageView.image = UIImage(named: "folder_default") ?? UIImage(systemName: "folder")
        } else {
            folderImageView.image = UIImage(systemName: "doc")
        }
    }
}

3. 简化CollectionView的Cell配置逻辑 #

复用Cell的configure(with:)方法，精简cellForItemAt：

extension FolderContentsViewController: UICollectionViewDataSource {
    
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return folderContents.count
    }
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "HoldGroupCell", for: indexPath) as! HoldGroupCell
        let fileURL = folderContents[indexPath.item]
        
        cell.configure(with: fileURL)
        
        // 根据类型设置背景色
        var isDir: ObjCBool = false
        fileManager.fileExists(atPath: fileURL.path, isDirectory: &isDir)
        cell.backgroundColor = isDir.boolValue ? .gray : .lightGray
        
        return cell
    }
}

4. 确保跳转时传递正确的URL #

在初始ViewController的选中事件中，传递选中的文件夹URL：

extension InitialViewController: UICollectionViewDelegate {
    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
        let selectedFolder = yourFolderArray[indexPath.item]
        let contentsVC = FolderContentsViewController()
        contentsVC.selectedFolderURL = selectedFolder
        navigationController?.pushViewController(contentsVC, animated: true)
    }
}

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