bpftrace变量名须以字母或下划线开头，聚合器必须在probe内声明使用，字符串字面量仅支持双引号，且需注意分号、括号匹配及printf参数对应。
变量名不能以数字开头
bpftrace 要求所有用户定义的变量（包括临时变量、映射键名、聚合器别名等）必须符合 C 风格标识符规则：只能以字母或下划线开头，后续可跟字母、数字或下划线。比如 count1 合法，但 1count 或 2nd_trace 会直接触发编译失败，报错信息可能只显示 “Failed to compile BPF program”，并不提示具体哪行——需人工排查变量命名。
聚合器（@var）不能在 probe 外部直接使用
常见错误是把聚合操作写在 probe 块之外，例如：
❌ 错误写法：
@count = count();
kprobe:do_sys_open { @count++; }
bpftrace 不允许在 probe 外初始化或访问聚合变量。所有 @ 变量必须在 probe 内首次声明并使用（如 @count = count() 或 @count[comm] = count()），且不能跨 probe 共享未声明的聚合器。
字符串字面量必须用双引号，单引号不支持
bpftrace 只接受双引号 “…” 表示字符串。若误用单引号，如：
kprobe:sys_open { printf(‘opened %s’, str(args->filename)); }
编译器会静默失败，报 “Failed to compile BPF program”。注意：str() 的参数本身不能是常量字符串，但 printf 中的格式串必须是双引号。
缺少分号或括号不匹配（尤其在嵌套条件里）
bpftrace 对语法结构敏感，但错误提示不直观。常见低级问题包括：
- if 条件块末尾漏掉右大括号 }
- 多层 if/else 嵌套时缩进正常，但实际少写一个 { 或 }
- 函数调用参数列表中逗号后多空格或换行不当（虽通常容忍，但在某些版本中会干扰解析）
- printf 格式串中用了未对应的参数，如 printf(“%d %s”, pid)（缺第二个参数）
建议用 bpftrace -v script.bt 查看预处理后的 AST，或先用最简版本验证结构再逐步加逻辑。