必须手动绑定后缀：点击右下角Plain Text→Open all with current extension as…→Nim，否则即使装对插件仍显示Plain Text；同时需确认Packages/Nim/Syntaxes/Nim.tmLanguage存在，且勿误装NimLSP。
Sublime Text 里 .nim 文件还是 Plain Text？
装完插件后打开 .nim 文件，右下角仍显示 Plain Text —— 这不是插件没装好，而是 Sublime 默认不绑定后缀。它不会自动把 .nim 和 Nim 语法关联起来。
- 必须手动触发一次映射：点击右下角
Plain Text→Open all with current extension as…→ 选Nim - 成功后，Sublime 会在
Packages/User/下生成隐式规则，后续所有.nim文件都会自动高亮 - 如果点完没反应，检查
Packages/Nim/Syntaxes/Nim.tmLanguage是否存在（可通过Preferences → Browse Packages…进入） - 别用 Package Control 直接搜 “Nim” 装一堆孤立语法包，
NimLime或Nim Language Support任选其一即可，NimLSP是服务端组件，装了也没高亮效果
Ctrl+B 报错 “nim not found” 怎么办？
终端能跑 nim --version，但 Sublime 按 Ctrl+B 就报找不到命令 —— 这是 macOS/Linux GUI 应用不继承 shell 的 PATH 导致的，和插件无关。
- 不要改系统级
PATH，直接在构建系统里写死路径：菜单 →Tools → Build System → New Build System… - 填入以下内容（注意替换
"cmd"中的路径）：{ "cmd": ["/Users/yourname/.nimble/bin/nim", "c", "-r", "$file"], "selector": "source.nim", "working_dir": "$file_path" } - 保存为
Nim.sublime-build，文件名必须带.sublime-build后缀，且必须存到Packages/User/目录下 - 再按
Ctrl+B前，确认右下角 Build System 已手动选中刚建的Nim
Ctrl+Click 跳转定义失效或跳错位置
点击函数名没反应，或跳进 std/seqs.nim 而不是你自己的模块 —— 这是 nimsuggest 服务没启用或版本不匹配。
-
nimsuggest在 Nim 1.6+ 已内置，旧版需单独编译：nim c -d:release $NIM_PATH/tools/nimsuggest - 确保生成的
nimsuggest可执行文件在PATH中，或在 LSP 插件配置里显式指定路径 - LSP-nim 客户端启动时若报
command not found: nimsuggest，不是插件问题，是环境变量没透给 Sublime - 项目根目录下必须有
nim.cfg或project.nim.cfg，否则nimsuggest不知道该索引哪些路径
为什么补全慢、卡顿或不生效？
装了 LSP 插件但补全延迟明显，甚至光标卡住 —— nimsuggest 对项目结构敏感，尤其在含大量 import 或跨模块依赖时。
- 避免在项目根目录外打开单个
.nim文件；始终用File → Open Folder加载整个项目 - 关闭不必要的
import，特别是std外的第三方包，nimsuggest会尝试索引所有依赖源码 - 如果用了
static或compileTime计算，nimsuggest可能卡在宏展开阶段，暂时注释掉再试 - Sublime 的 LSP 插件默认启用
semanticTokens，对 Nim 效果有限还拖慢响应，可在 LSP 设置里关掉
PATH 隔离，几乎每次重装 nim 或 choosenim 后都要重新校准构建系统路径。 
