已知问题 - macOS
如适用，macOS 版本号会显示在错误标题前，例如"[10.13]"表示此问题仅出现在 macOS 10.13 "High Sierra"中，"[10.12.4+]"表示自 Mac OS X 10.12.4 "Sierra"以来的任何版本。
[macOS 14+] 在帮助菜单中搜索文档标题中包含的术语可能导致程序变慢并最终卡死
症状
如果活页夹中文档标题包含的术语同时出现在嵌套菜单项中（如"合并"、"拆分"、"复制"等），在帮助菜单中搜索该术语可能导致程序变慢，最终可能卡死。
原因
菜单搜索工具是 Apple 代码，它与 Apple 系统设置交互不良，导致 Apple 基础设施进程挂起。Scrivener 本身实际上并没有挂起，而是操作系统本身挂起了。
解决方法
如果遇到此挂起，您可能需要关机重启。建议使用活页夹上方的搜索图标打开"项目搜索"，设置过滤器仅搜索"标题"来替代帮助菜单搜索。
[macOS 10.13 或更早] MultiMarkdown 可能报错或崩溃
症状
编译为涉及运行内置 MultiMarkdown 的文件类型（如转换为 HTML）时，编译器可能崩溃或显示错误。
原因
最新版本的 MMD 是使用较新的 Mac 编译的，以提供 Silicon 和 Intel 支持，该构建在 macOS 10.14 之前的版本上无法正常运行。
解决方法
官网直购版 Scrivener 可以使用已安装的 MultiMarkdown 版本代替自带版本。可以通过安装旧版本官方版（推荐 6.5.2 的安装包）或使用 MacPorts/Homebrew 安装兼容版本。Mac App Store 版不允许使用沙箱外的 UNIX 工具。
Spotlight 无法索引项目中的文本
症状
正常情况下，在 Spotlight 中搜索项目中编写的文本应该能将该项目显示为搜索结果。如果 Spotlight 引擎出问题，则只能发现项目名称或快速预览中的文本。
原因
问题与 Scrivener 技术本身无关，更可能是 Spotlight 引擎或支持它的 macOS 基础架构出现损坏或故障。建议联系 Apple 客户支持获取故障排除建议。
解决方法
如果使用 Spotlight 访问常用项目，可以使用 File ▸ Add Project to Favorites 菜单命令。如果用于查找零散文本，唯一的好方法是从项目中批量导出文本。
使用 Scratch Pad 导致反复崩溃
症状
创建新笔记或编辑现有笔记等正常使用 Scratch Pad 功能可能导致软件崩溃。
原因
已确认的冲突：将 Scratch Pad 功能与任何 iCloud 同步存储区域结合使用。
解决方法
如果使用 iCloud，尝试将 Scratch Pad 文件夹存储在不受 iCloud 同步的位置。如果仍有问题，尝试关闭所有其他软件后单独测试 Scrivener（特别注意仅驻留在菜单栏中的工具）。
使用华文楷体（STKaiti）字体导致系统请求下载字体
症状
在项目中使用华文楷体字体时，系统可能定期要求重新下载该字体。此情况可能导致使用该字体的文本损坏且无法通过更换字体恢复。
解决方法
不要使用此字体。鉴于因文本损坏而丢失作品的风险虽低但真实存在，我们建议完全避免使用。
[10.15] 写作模式下性能缓慢
症状
在 Scrivener 中使用带背景图片的写作模式（Composition Mode）时，打字速度可能急剧下降，整体系统可能变得卡顿。
解决方法
移除项目设置中的背景图片即可大幅提升性能：
- 打开
Project ▸ Project Settings... - 在"背景图片"选项卡中，将写作模式背景设置为"无背景"。
- 点击
Okay保存设置。
启动时因 CODESIGNING 错误崩溃
症状
启动 Scrivener 或 Scapple 时崩溃。崩溃日志包含 Exception Type: EXC_BAD_ACCESS (Code Signature Invalid) 和 Termination Reason: Namespace CODESIGNING, Code 0x2，以及包含"sentinel"的文本。
原因
此崩溃由旧版 SentinelOne 安全软件的冲突引起。
解决方法
更新到最新版 SentinelOne（已修复该冲突）。如果无法更新，可以下载旧版 Scrivener 3.1.1 或 Scapple 1.3.1。
拼写检查停止工作
症状
拼错的单词不再以红色高亮显示，直引号不会自动转换为智能引号，双连字符和三个句点不会转换为破折号和省略号。
原因
由时序错误引起，编辑器窗口的各个元素以错误的顺序初始化，导致与操作系统拼写检查系统断开连接。
解决方法
目前唯一已知的恢复方法是关闭并重新打开项目。
系统文本偏好设置按钮无效
症状
使用 Mac App Store 版 Scrivener 时，在"纠正"偏好设置面板中点击 System Text Preferences... 按钮没有反应。官网直购版无此问题。
解决方法
从 Apple 菜单直接打开系统偏好设置，导航到"键盘"面板点击"文本"选项卡。
列表导出时出现额外编号或项目符号
症状
导出或编译时，作品中某些区域出现列表编号或项目符号（编辑器中没有），或列表在编译后产生重复编号（如"2. 2. 第二行项目"）。
解决方法
- 选择所有受影响的文本，使用
Format ▸ Lists ▸ None菜单命令清除潜在的列表格式。 - 如有必要，手动删除留下的可见项目标记。
- 选择应为列表的文本，重新应用所需的列表格式。
大纲视图中亚洲文字的问题
症状
在大纲视图的摘要区域使用东亚文字（如韩文）时，有时会出现输入问题。
原因
当摘要在大纲视图中显示时，Scrivener 需要确保使用正确的字体。但某些字体不支持所有东亚文字字符，macOS 文本系统会替换字体来正确显示，而 Scrivener 修正字体时可能干扰字体替换。
解决方法
选择完全支持所用文字的大纲字体。前往偏好设置的"外观"面板设置大纲字体。AppleGothic 对许多东亚文字效果良好。