You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.29 05:57:42