Swift Playgrounds中code-completion与hidden-code分隔符的正确用法

一、Hidden-Code 分隔符修复方案 #

• 严格遵循格式规范：必须使用/*: hidden-code */作为起始分隔符，/*: end-hidden-code */作为结束分隔符，冒号和空格不能省略或写错，任何格式错误都会导致代码失效或丢失。
• 正确放置位置：分隔符必须直接嵌入代码块中，不能嵌套在普通注释或其他特殊分隔符内。示例：

// 学习者可见代码
print("欢迎使用Swift Playground")

/*: hidden-code */
// 后台执行的隐藏函数
func calculateScore(_ points: Int) -> Int {
    return points * 2
}
/*: end-hidden-code */

// 直接调用隐藏函数
let finalScore = calculateScore(50)

• 确认文件格式与保存流程：确保使用的是Playground Book格式（通过「File > New > Playground Book」创建），普通单页Playground不支持持久化隐藏代码。关闭前等待Playground完全编译完成（右侧预览区无加载动画），避免未保存状态导致代码丢失。若问题持续，尝试新建Playground Book并逐步迁移代码，排除旧文件缓存损坏问题。

二、Code-Completion 设置持久化方案 #

• 全局配置而非单页临时设置：代码补全状态需在Playground Book的全局配置中设置，而非单页临时调整。点击编辑器顶部齿轮图标打开「Settings」面板，找到「Code Completion」选项，调整后点击「Done」并保存整个Book。
• 单页分隔符用法：若需针对单页自定义补全，在页面最顶部添加/*: code-completion(show) */（显示补全）或/*: code-completion(hide) */（隐藏补全），确保分隔符在页面代码之前。
• 权限与退出检查：确认Playground Book所在目录有写入权限，关闭时完全退出Playground应用，避免后台进程未同步保存配置导致设置重置。

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