SwiftUI预览构建失败,报__designTimeString类型兼容错误求助
SwiftUI Preview Failed:
__designTimeString Requires AnyHashable Conform to ExpressibleByStringLiteral 这个问题我之前也碰到过,本质是SwiftUI预览模式的设计时代码生成bug——预览会自动插入__designTimeString这类辅助函数来处理UI元素的动态属性,但在处理命名坐标空间的字符串字面量时,它错误地把字符串当成了AnyHashable类型,而AnyHashable并没有遵循ExpressibleByStringLiteral协议,所以编译报错。而运行时不会触发这些设计时逻辑,所以你的App能正常运行。
下面是几个靠谱的解决思路:
1. 用常量替代字符串字面量(推荐)
把坐标空间的名字定义成一个静态常量,避免预览的代码生成器误判类型。修改你的代码如下:
// 在GameCellView.swift文件顶部定义常量 private let BoardCoordinateSpaceName = "BoardCoordinates" // 然后在手势里使用这个常量 .gesture( DragGesture(coordinateSpace: .named(BoardCoordinateSpaceName)) .onChanged { point in guard CanDrag else { return } dragAmount = CGSize(width: point.translation.width, height: point.translation.height) dragState = GetDragState(Point: point.location) } .onEnded { point in CellDropped(Point: point.location) dragAmount = .zero dragState = .unknown } )
这样预览的代码生成器会直接识别这个常量的类型,不会触发__designTimeString的类型错误。
2. 清理缓存并重启Xcode
有时候预览的缓存会导致奇怪的编译问题,你可以:
- 执行
Product > Clean Build Folder(快捷键Shift+Command+K) - 完全退出Xcode,重新打开项目
- 尝试重新生成预览
3. 升级Xcode到稳定版本
这个bug在Xcode 14.x的部分版本中比较常见,如果你用的是旧版Xcode,升级到最新的稳定版(比如Xcode 15.x)大概率能直接修复这个问题。
内容的提问来源于stack exchange,提问作者Jim
相关产品推荐
相关产品推荐

