按指南操作后仍无语法高亮，JetBrains Fleet添加语言语法支持的正确方法

一、先确认Textmate Bundle的兼容性 #

不是所有Textmate Bundle都能直接在Fleet里生效，得满足两个前提：

• Bundle必须包含Syntaxes目录，且目录内有.tmLanguage或.sublime-syntax格式的语法定义文件
• 语法文件的scope名称需为标准格式（比如text.html.liquid这类规范命名）

二、放置Bundle的正确目录 #

Fleet识别Textmate Bundle的目录是固定的，分两种使用场景：

1. 全局生效（所有项目可用） #

在用户主目录下创建严格匹配的层级目录：

~/.fleet/textmate/bundles/

将下载好的Bundle（比如liquid-tmbundle）直接放入bundles目录，最终目录结构需为：

~/.fleet/textmate/bundles/liquid-tmbundle/
├── Syntaxes/
│   └── Liquid.tmLanguage
└── （Bundle内其他配套文件）

2. 仅当前项目生效 #

在项目根目录下创建：

.fleet/textmate/bundles/

同样将Bundle放入该目录，仅对当前项目生效。

三、必须执行的验证步骤 #

1. 重启Fleet：添加Bundle后必须完全退出并重新打开Fleet，否则语法规则不会触发加载
2. 关联文件类型：
   • 打开目标格式的文件（比如.liquid文件）
   • 点击编辑器右下角的语言标识（默认可能显示为Plain Text）
   • 在弹出的列表中选择对应语言（比如Liquid），Fleet会记住该文件格式的关联设置
3. 检查Bundle完整性：
   • 确认Syntaxes目录下的语法文件无缺失
   • 若Bundle是压缩包解压而来，避免出现嵌套目录（比如不要生成liquid-tmbundle-master/liquid-tmbundle/这类多层结构）

四、排查无效情况的方法 #

如果仍未实现语法高亮，可查看Fleet日志定位问题：

• MacOS：~/Library/Logs/JetBrains/Fleet/
• Windows：%APPDATA%\JetBrains\Fleet\logs\
• Linux：~/.local/share/JetBrains/Fleet/logs/
  日志会显示语法文件加载失败的具体原因，比如格式不兼容、路径识别错误等。另外，部分旧版Textmate Bundle需要将.tmLanguage文件转换为.sublime-syntax格式，转换后再放入目录尝试。

内容的提问来源于stack exchange，提问作者quarks