mdBook项目：如何禁用自动创建缺失文件功能

在mdBook文档构建工具的使用过程中，开发者可能会遇到一个常见场景：当修改SUMMARY.md文件时，如果其中引用的文件不存在，mdBook会自动创建这些缺失的文件。虽然这个功能对于快速搭建文档结构很有帮助，但在某些情况下可能会带来不便。

功能背景

mdBook作为Rust生态中的文档工具，默认启用了"自动创建缺失文件"的特性。这个设计初衷是为了简化文档创建流程，特别是在以下场景：

1. 快速搭建新章节框架
2. 批量添加文档结构
3. 团队协作时统一文件结构

潜在问题

然而，这个自动化特性也可能导致一些问题：

• 当SUMMARY.md中出现拼写错误时，会创建错误的文件
• 在严格版本控制的项目中产生不必要的文件变更
• 开发者可能需要频繁手动删除意外创建的文件

解决方案

mdBook提供了配置选项来禁用这一自动创建功能。在项目的book.toml配置文件中，可以添加以下设置：

[build]
create-missing = false

这个配置项的作用是：

1. 禁用从SUMMARY.md自动创建文件的功能
2. 当检测到缺失文件时，会在构建过程中显示警告而非创建文件
3. 保持原有文件结构的完整性

使用建议

对于不同的使用场景，可以考虑以下实践：

1. 开发初期：保持默认开启状态，快速搭建文档框架
2. 项目稳定后：关闭自动创建功能，避免意外修改
3. 团队协作项目：在版本控制配置中明确说明此设置

注意事项

修改此配置后需要：

1. 重新启动mdBook服务才能生效
2. 已有的自动创建文件不会被删除
3. 缺失文件警告不会影响实际构建过程

通过合理配置这个选项，开发者可以更好地控制文档项目的文件管理流程，避免不必要的文件变动，同时保持文档构建过程的灵活性。