SwiftUI访问JSON数据遇类型转换错误，求解决方案

问题1：Cannot convert value of type [String : Village] to expected argument type Binding #

原因 #

你直接把解码得到的[String: Village]字典传给了需要可遍历集合或Binding类型参数的控件（比如ForEach/List），字典本身不能直接作为SwiftUI控件的数据源，且Binding的使用场景错误。

解决方法 #

• 取字典的values属性得到[Village]数组，作为遍历的数据源
• 若需绑定单个Village对象，确保传给Binding的是具体对象的绑定，而非整个字典

问题2：Cannot convert value of type Binding to expected argument type 'String' #

原因 #

你在需要普通String值的场景（比如Text、Image的初始化参数）传入了带$的Binding值，Text/Image不需要绑定，直接传原始值即可。

解决方法 #

去掉变量前的$符号，直接使用原始值。

完整修正代码示例 #

1. Village结构体（含图片加载计算属性） #

struct Village: Codable, Identifiable {
    let id: String
    let name: String
    let description: String
    let imageName: String // 对应Assets中的图片名称
    
    // 计算属性加载Assets中的图片
    var image: Image {
        Image(imageName)
    }
    
    // 自定义解码：用JSON字典的key作为id
    enum CodingKeys: String, CodingKey {
        case name, description, imageName
    }
    
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        name = try container.decode(String.self, forKey: .name)
        description = try container.decode(String.self, forKey: .description)
        imageName = try container.decode(String.self, forKey: .imageName)
        
        guard let id = decoder.userInfo[.villageIdKey] as? String else {
            throw DecodingError.dataCorrupted(.init(codingPath: [], debugDescription: "Missing village ID"))
        }
        self.id = id
    }
}

// 自定义解码userInfo的key
extension CodingUserInfoKey {
    static let villageIdKey = CodingUserInfoKey(rawValue: "villageId")!
}

2. Bundle解码扩展（适配字典转数组） #

extension Bundle {
    func decode<Village>(_ type: [String: Village].Type, from fileName: String) throws -> [Village] where Village: Decodable {
        guard let url = url(forResource: fileName, withExtension: "json") else {
            throw NSError(domain: "BundleError", code: -1, userInfo: [NSLocalizedDescriptionKey: "找不到目标JSON文件"])
        }
        let data = try Data(contentsOf: url)
        let decoder = JSONDecoder()
        
        // 解码字典并转为带id的Village数组
        let villageDict = try decoder.decode([String: Village].self, from: data)
        return villageDict.map { key, _ in
            do {
                let singleData = try JSONSerialization.data(withJSONObject: villageDict[key]!, options: [])
                var singleDecoder = JSONDecoder()
                singleDecoder.userInfo[.villageIdKey] = key
                return try singleDecoder.decode(Village.self, from: singleData)
            } catch {
                fatalError("单个Village解码失败：\(error)")
            }
        }
    }
}

3. ContentView（遍历数据+跳转详情页） #

struct ContentView: View {
    let villages: [Village]
    
    init() {
        do {
            villages = try Bundle.main.decode([String: Village].self, from: "villages.json")
        } catch {
            print("JSON解码失败：\(error)")
            villages = []
        }
    }
    
    var body: some View {
        NavigationStack { // iOS 16+使用，iOS 15及以下用NavigationView
            List(villages) { village in
                NavigationLink(destination: VillageDetailView(village: village)) {
                    HStack {
                        village.image
                            .resizable()
                            .frame(width: 50, height: 50)
                        Text(village.name) // 直接传原始值，不要加$
                    }
                }
            }
            .navigationTitle("村庄列表")
        }
    }
}

// 详情页视图
struct VillageDetailView: View {
    let village: Village // 直接接收Village对象，无需Binding（若无需修改数据）
    
    var body: some View {
        ScrollView {
            village.image
                .resizable()
                .scaledToFit()
            Text(village.description)
                .padding()
        }
        .navigationTitle(village.name)
    }
}

补充说明 #

• 若你的JSON是直接的数组格式[Village]，可简化解码逻辑，直接解码为[Village]即可
• 确保Village遵守Identifiable协议，这样ForEach/List可直接遍历，无需手动指定id参数
• 图片加载时，需保证JSON中的imageName与Assets中的图片名称完全一致（含大小写）

内容的提问来源于stack exchange，提问作者CrisI.Kim