Sublime 不自动识别多语言混编项目，仅按文件 selector 触发构建系统或 LSP；需为每种语言单独配置 .sublime-build 文件并置于 Packages/User/ 下，selector 必须精准匹配如 "source.python"，路径含中文或编码混乱会导致构建失败。
Sublime 本身不自动识别“多语言混编项目”这个概念，它只按当前文件的 selector 触发对应构建系统或 LSP 服务。所谓“智能运行”，本质是靠你手动把 Python、JS、Go 等各语言的构建逻辑和语言服务分开配对、再用路径/语法/作用域精准隔离——配错一个 selector 或放错一个 .sublime-build 文件位置，整个流程就断在第一步。
Build System 怎么为不同语言文件自动切换
Sublime 不会根据项目根目录下有 package.json 和 pyproject.toml 就自动选 Node 或 Python 构建系统。它只看当前打开文件的语法 scope（比如 source.python），然后匹配所有 .sublime-build 文件里的 selector 字段。
常见错误现象：Ctrl+B 没反应，或执行了 Python 命令却去跑了一个 .js 文件。
- 每个语言必须单独建一个
.sublime-build文件，存放在Packages/User/目录下（通过Preferences → Browse Packages…打开） -
selector必须写准确：Python 是"selector": "source.python"，TypeScript 是"selector": "source.ts"，不是.ts后缀名，也不是text.typescript - 想让一个构建系统同时支持多个语言？用英文逗号分隔：
"selector": "source.python, source.js"，但要小心误触发 - Windows 用户慎用绝对路径：
"cmd": ["C:\Python311\python.exe", "$file"]—— 换机器就失效；推荐用py -3.11 -u "$file"（注意-u必须紧跟版本号）
LSP 提示为什么在 .vue 或 .html 里不工作
LSP 插件本身不带任何语言能力，它只负责转发请求。你在 <script> 里写 JS 却没提示，大概率不是 LSP 没装，而是 JS 语言服务器压根没被激活——因为 Sublime 默认的 HTML 语法不嵌入 JS 高亮，也就不会把 <script> 块识别为 source.js scope，selector 对不上，LSP 根本不启动。
真实使用场景：Vue 单文件组件里 <script setup> 写 TypeScript，但右下角显示的是 Vue Component 而非 TypeScript (Vue)。
- 先确认当前文件实际 scope：
Ctrl+Alt+Shift+P（Win/Linux）或Cmd+Alt+Shift+P（macOS），看输出是不是source.ts.embedded.html这类复合 scope - HTML 语法默认不嵌入 JS/TS/CSS，需手动编辑
Packages/HTML/HTML.sublime-syntax，在scriptcontext 下加- embed: scope:source.ts（缩进必须对齐） - Vue 文件必须装第三方语法包（如
Vue Syntax Highlight），原生 Sublime 不认识.vue扩展名 - Pyright 对
source.python生效，但对source.python.embedded.html（如 Jinja2 模板）默认不启用，得在 LSP Settings 里显式加"scopes": ["source.python", "source.python.embedded.html"]
中文路径 + 混合编码文件导致 Build 失败或乱码
Windows 下项目路径含中文，或文件本身是 GBK 编码但混了 UTF-8 片段，会导致 shell_cmd 执行失败、print("你好") 输出乱码、甚至构建系统菜单直接消失。
这不是 Sublime 的兼容性问题，是编码探测链路断裂：ConvertToUTF8 插件没正确识别原始编码 → Sublime 用错误编码读取文件 → 构建命令传入含乱码的路径 → shell 报 No such file or directory。
- 确保
ConvertToUTF8设置中"ignore_bom": false，否则 BOM 被剥离后字节偏移错乱 -
"min_confidence_threshold"别设太高（如 0.95），混合文件建议调到0.75～0.85，逼它早点 fallback 到"fallback_encodings": ["GB18030", "CP936"] -
save_to_original_encoding必须设为false，否则即使显示正常，保存时仍写回 GBK，下次打开又乱 - 终极规避法：把项目移到纯英文路径下（如
C:/dev/myapp），比调一堆编码参数更可靠
如何让 Ctrl+B 在混编项目里“看起来像自动识别”
没有真正的“自动识别”，只有足够细的条件组合。你可以用 working_dir + shell_cmd + 文件路径变量模拟出近似效果，但代价是配置变复杂、可维护性下降。
例如：一个项目同时有 src/main.py 和 frontend/App.jsx，你想在任意文件里按 Ctrl+B 就运行对应环境。
- 不要试图在一个
.sublime-build里写 if-else 判断路径，Sublime 不支持逻辑分支 - 可以用
$file_path配合 shell 条件判断（仅限 macOS/Linux）："shell_cmd": "if [[ $file_path == *frontend* ]]; then node '$file'; else python3 '$file'; fi" - Windows PowerShell 可类似处理，但得用
powershell -Command包一层，且引号易出错 - 更稳的做法：用
Project → Edit Project在.sublime-project里为不同子目录设置build_systems，再配合右键菜单快速选择
最常被忽略的一点：所有这些机制都依赖 selector 正确加载。如果一个 .py 文件右下角显示的是 Plain Text，那后续所有构建、LSP、高亮都会失效——先按 Ctrl+Shift+P → Set Syntax: Python 手动指定，再检查语法包是否损坏。
