SwiftUI开发：SongViewModel报错与songs作用域问题排查

两个报错均为代码结构定义错误导致，按以下步骤修改即可解决：

1. 「Cannot find 'songs' in scope」报错 #

• 根因：你将测试歌曲数组错误定义在了Song结构体内部，一方面会触发Song递归初始化的死循环问题，另一方面ContentView中未声明可访问的songs变量，直接调用必然找不到对应作用域的变量。
• 修复逻辑：移除Song结构体内递归的songs数组属性，将测试数据迁移到ViewModel层管理，在视图中正确引用ViewModel持有的歌曲数组。

2. 「SongViewModel类型不匹配」预览报错 #

• 根因：Song结构体的递归定义导致Xcode生成了错误的派生类型，同时预览代码未传入正确构造的ViewModel实例，修复模型定义后清理构建缓存即可彻底解决。

修正后完整可运行代码 #

模型与ViewModel层 #

import SwiftUI
import Combine

// 歌曲模型：仅保留单首歌曲的固有属性，移除递归的数组定义
struct Song: Identifiable {
    let id = UUID()
    let imageName: String
    let name: String
}

// 收藏列表页ViewModel：管理列表数据源
final class FavoriteSongsViewModel: ObservableObject {
    @Published var songs: [Song]
    
    init() {
        // 测试示例数据在ViewModel初始化时赋值
        songs = [
            Song(imageName: "song1", name: "DJ NYK"),
            Song(imageName: "song2", name: "John Wick Deconsecrated")
        ]
    }
}

// 歌曲详情页ViewModel：持有单首歌曲的数据
final class SongDetailViewModel: ObservableObject {
    let song: Song
    init(song: Song) {
        self.song = song
    }
}

列表页（ContentView）实现 #

struct ContentView: View {
    // 声明列表ViewModel为状态对象，才能访问内部的songs数组
    @StateObject private var listViewModel = FavoriteSongsViewModel()
    
    var body: some View {
        NavigationStack {
            List(listViewModel.songs) { song in
                NavigationLink {
                    // 跳转时传入对应歌曲的详情ViewModel
                    SongDetailView(viewModel: SongDetailViewModel(song: song))
                } label: {
                    SongRow(song: song)
                }
            }
            .navigationTitle("我的收藏")
        }
    }
}

// 列表行组件
struct SongRow: View {
    let song: Song
    var body: some View {
        HStack(spacing: 12) {
            Image(song.imageName)
                .resizable()
                .scaledToFill()
                .frame(width: 44, height: 44)
                .cornerRadius(6)
            Text(song.name)
                .font(.system(size: 16))
        }
        .padding(.vertical, 6)
    }
}

详情页与预览实现 #

struct SongDetailView: View {
    @StateObject private var viewModel: SongDetailViewModel
    
    // 自定义初始化方法，将传入的ViewModel包装为StateObject
    init(viewModel: SongDetailViewModel) {
        _viewModel = StateObject(wrappedValue: viewModel)
    }
    
    var body: some View {
        VStack(spacing: 24) {
            Image(viewModel.song.imageName)
                .resizable()
                .scaledToFill()
                .frame(width: 240, height: 240)
                .cornerRadius(16)
            Text(viewModel.song.name)
                .font(.title2)
                .bold()
            // 后续可添加播放控制、歌词等详情页元素
            Spacer()
        }
        .padding(.top, 40)
        .navigationTitle("歌曲详情")
    }
}

// 页面预览
struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

struct SongDetailView_Previews: PreviewProvider {
    static var previews: some View {
        // 预览时必须传入正确构造的ViewModel实例，避免类型错误
        NavigationStack {
            SongDetailView(viewModel: SongDetailViewModel(song: Song(imageName: "song1", name: "测试歌曲")))
        }
    }
}

后续排查提示 #

• 如果修复代码后预览仍报类型匹配错误，按下Shift + Command + K清理项目构建缓存，重新构建预览即可恢复正常。
• 不要在模型结构体内部定义同类型的数组属性，会触发无限递归初始化，直接导致编译期类型识别错误、运行时崩溃等问题。
• SwiftUI中遵循ObservableObject的ViewModel，需要在视图中用@StateObject（视图拥有生命周期）或@ObservedObject（外部传入生命周期）修饰，才能正确响应数据更新。

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