yaml配置中缩进必须用空格（推荐2个）、含特殊字符的字符串须加引号、列表须用“- ”格式；锚点引用在豆包ai中无效，应避免使用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
YAML 文件里不能用 Tab 缩进
豆包AI（或任何 YAML 解析器）读取配置时，遇到 Tab 会直接报错，典型错误是 while scanning for the next token found character '\t' that cannot start any token。YAML 规范明确要求缩进必须用空格，且同一层级缩进数要一致。
实操建议：
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
- 编辑器设为「插入空格」模式，缩进统一用 2 个空格（最稳妥，多数工具默认支持）
- 避免复制粘贴网页代码——里面常混有不可见
Tab或全角空格 - 用命令行快速检查：
yamllint config.yaml（需先装yamllint），它能定位缩进问题
字符串值加不加引号，结果可能完全不同
YAML 对字符串的自动类型推断很“积极”，比如 yes、no、on、off、123、true 这些会被当成布尔或数字，而不是你想要的字符串。豆包AI 的配置若把 model: qwen-2.5 写成 model: qwen-2.5（没引号），某些解析器会把它当浮点数处理，导致加载失败。
实操建议：
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
- 所有含短横线（
-）、点（.）、冒号（:）、斜杠（/）的字符串，一律加单引号或双引号，例如：model: 'qwen-2.5' - 变量名、路径、URL、API key 等敏感字面量，无条件加引号，防意外类型转换
- 不要依赖“看起来像字符串就不用引号”——不同 YAML 解析器行为不一致，豆包AI 后端用的是 PyYAML，它对未引号字符串更严格
列表项写错格式，豆包AI 会静默忽略整个字段
YAML 列表不是用方括号写的，也不是用逗号分隔。写成 tools: [search, file] 或 tools: search, file 都会导致解析失败或字段被跳过，而豆包AI 不会报错提示，只会按默认值运行。
正确写法是每项前加 - （短横+空格），顶格对齐或按层级缩进：
tools: - search - file - code_interpreter
实操建议：
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
- 别手写方括号或逗号列表——那是 JSON/Python 风格，不是 YAML
- 如果列表项本身是对象（比如多个 API 配置），每个
-后接缩进块，注意空格数一致 - 用 VS Code 装
Red Hat YAML插件，它能实时高亮格式错误和悬空缩进
锚点与引用（&/*）在豆包AI 配置中基本无效
YAML 支持用 &id 定义锚点、*id 引用复用结构，但豆包AI 的配置加载逻辑通常禁用该特性（出于安全和简化考虑），强行使用会导致解析中断或字段为空。
实操建议：
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
- 别在豆包AI 的
config.yaml里写&common或*common—— 它不会生效，还可能让整个文件加载失败 - 需要复用配置？用外部手段：比如用
envsubst做模板替换，或写脚本生成最终 YAML - 如果看到别人示例用了锚点，那大概率是给本地 LLM 工具链（如 Ollama + LangChain）用的，不适用于豆包AI 的 Web/API 配置场景
YAML 表面简单，但缩进、引号、列表符号这三个地方，只要错一个空格或少一个短横，豆包AI 就可能读不到你的配置。最稳妥的做法：写完立刻用在线 YAML 验证器（比如 yamlchecker.com）粘贴检查，别靠肉眼确认。
