bitbake语法高亮不生效需手动关联.bb/.bbappend后缀到bitbake语法；sublime不支持语义分析，无变量跳转或动态补全；缩进混乱因混合shell/python语法导致，须确保语法识别为bitbake；构建错误与编辑器无关，必须通过bitbake命令验证。
BitBake语法高亮不生效？检查文件关联是否命中 .bb 和 .bbappend
Sublime 默认不认识 BitBake 文件，所以打开 recipe.bb 时全是纯文本。核心问题是 Sublime 没把这类后缀映射到正确的语法定义。不是插件装了就完事，得手动确认文件关联是否生效。
- 右键编辑器右下角的语法标识（比如显示“Plain Text”），选择 Open all with current extension as… → BitBake
- 若列表里没有
BitBake，说明语法包没正确安装或未启用；此时先装好Package Control，再安装BitBake Syntax Highlighting插件 - 验证方式：新建文件，保存为
test.bb，看右下角是否自动变成BitBake—— 不是靠手动选，而是靠扩展名自动识别
变量展开和函数调用没提示？别指望 Sublime 原生支持 BitBake 语义分析
Sublime 是文本编辑器，不是语言服务器。它能高亮 do_compile()、识别 ${PN} 这类变量占位符，但不会像 VS Code + bitbake-lsp 那样跳转定义、补全变量值或校验 inherit 是否合法。
- 所有“智能提示”类功能都属于奢望；插件提供的只是正则匹配式高亮，
${@bb.utils.contains(...)}这种嵌套表达式大概率只高亮外层${@...}，内部函数不解析 - 想查某个变量在哪定义？老老实实用
grep -r "FOO = " meta-*/recipes-*或依赖bitbake -e recipename | grep ^FOO= - 如果硬要补全，可手动建
sublime-completions文件，加几条常用变量（如${PN}、${PV}）和函数（do_install、do_configure），但无法动态感知 layer 中自定义的内容
缩进混乱、括号不匹配？BitBake 的 shell/python 混合语法是罪魁祸首
BitBake 配方里混着 shell 片段（do_install() { cp ... }）和 Python 片段（do_foo[python] () { ... }），Sublime 默认的 ShellScript 或 Python 语法会误判缩进层级和括号配对。
- 确保当前语法确实是
BitBake（不是ShellScript），否则{和}匹配逻辑错乱，折叠也失效 -
do_something[python] () {这种写法中，{属于 BitBake 解析器语法，不是 Python 的代码块起始——但 Sublime 插件通常把它当 shell 处理，所以不要依赖括号高亮来判断逻辑范围 - 遇到缩进异常，优先检查是否粘贴时混入了全角空格或制表符；BitBake 对空白符敏感，建议在
Preferences → Settings中设"detect_indentation": false，并固定用 4 空格
修改配方后构建失败，别怪 Sublime 配置——它根本不参与构建流程
Sublime 只负责显示和编辑，bitbake 调用完全由终端或外部构建系统触发。你看到 SyntaxError: invalid syntax 报错，99% 是配方本身写错了，和编辑器配置无关。
- 常见诱因：
${@...}里 Python 表达式漏括号、inherit拼错名字、FILESEXTRAPATHS路径末尾多写了:、shell 函数里用了 Bash 特有语法（BitBake 只跑 dash） - Sublime 插件不会校验这些；它连
do_install是不是拼成do_intsall都不知道 - 真正有效的验证方式只有执行：
bitbake -e recipename 2>/dev/null | head -20看是否报错，或者直接bitbake recipename
BitBake 配方的“正确性”永远在构建时才落地，编辑器能做的只是让你少看错几个 $ 和 {。最常被忽略的是：不同 layer 的 bbclass 可能重定义同名函数，而 Sublime 完全看不到跨文件的覆盖关系。
