sing-box 使用 JSON 配置文件。通过客户端导入订阅时，用户通常不需要手写这些内容；只有链接格式错误、客户端提示字段不支持，或你准备自行维护核心时，才需要理解配置结构。
按问题选择内容
- 导入订阅后报格式错误：先确认链接是否为 sing-box 兼容格式，再读订阅格式 FAQ。
- 客户端提示配置字段不支持：读配置结构参考，确认当前稳定版支持的字段。
- 看到
tun、规则集或入站/出站术语：只需先理解概念，分别读TUN inbound、rule-set与inbound / outbound。 - 准备升级旧配置：按迁移已弃用配置检查，不要直接套新示例。
必要时再修改配置
- 保存一份可以回滚的现有配置，再进行字段或规则替换。
- 把“JSON 能解析”和“路由结果符合预期”分开验证；
sing-box check解决前一部分，实际日志和测试解决后一部分。 - 当配置引用远程规则集或外部资源时，记录来源、格式和更新策略。
- 只使用目标稳定版本支持的字段。官方弃用页面会注明旧字段的移除计划。
关于示例配置
配置参考与客户端手册提供了结构和示例，但真实配置仍取决于你的入口、出口、DNS 和路由目标。一个适合学习的示例，不自动等于适合生产运行的配置，也不应包含公开可见的节点凭据。