N8n Expression Syntax 说明文档

# n8n 表达式语法 在工作流中编写正确 n8n 表达式的专家指南。 --- ## 目的 教授正确的 n8n 表达式语法 ({{ }} 模式) 并修复常见错误，特别是关键的 Webhook 数据结构陷阱。 ## 激活条件 - expression - {{}} 语法 - $json, $node, $now, $env - webhook 数据 - 排除表达式错误 - 工作流中的 undefined ## 文件数量 4 个文件，总计约 450 行 ## 依赖 **n8n-mcp 工具**： - 无直接依赖（语法知识技能） - 可与 n8n-mcp 验证工具配合使用 **相关技能**： - n8n 工作流模式 (在示例中使用表达式) - n8n MCP 工具专家 (验证表达式) - n8n 节点配置 (在需要表达式时) ## 覆盖范围 ### 核心主题 - 表达式格式 ({{ }}) - 核心变量 ($json, $node, $now, $env) - **Webhook 数据结构** ($json.body.*) - 何时不使用表达式 (代码节点) ### 常见模式 - 访问嵌套字段 - 引用其他节点 - 数组和对象访问 - 日期/时间格式化 - 字符串操作 ### 错误预防 - 15 个常见错误及修复方案 - 快速参考表 - 调试过程 ## 评估 4 个场景 (预期 100% 覆盖)： 1. **eval-001**: 缺少花括号 2. **eval-002**: Webhook body 数据访问 (关键！) 3. **eval-003**: 代码节点与表达式混淆 4. **eval-004**: 节点引用语法 ## 关键特性 ✅ **突出关键陷阱**：Webhook 数据位于 `.body` 下 ✅ **真实示例**：来自 MCP 测试和真实模板 ✅ **快速修复表**：常见错误的快速参考 ✅ **代码 vs 表达式**：清晰的区别 ✅ **全面性**：覆盖 95% 的表达式使用场景 ## 文件 - **SKILL.md** (285 行) - 包含所有必要知识的核心内容 - **COMMON_MISTAKES.md** (380 行) - 包含 15 个常见错误的完整错误目录 - **EXAMPLES.md** (450 行) - 10 个真实运行示例 - **README.md** (本文件) - 技能元数据 ## 成功指标 **预期成果**： - 用户正确地将表达式包裹在 {{ }} 中 - 零 Webhook `.body` 访问错误 - 代码节点中不使用表达式 - 正确的 $node 引用语法 ## 最后更新 2025-10-20 --- **所属**：n8n-skills 仓库 **构思者**：Romuald Członkowski - [www.aiadvisors.pl/en](https://www.aiadvisors.pl/en)