基于Sublime Text的Nim高性能原型系统研发

必须手动绑定后缀：点击右下角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 设置里关掉

实际开发中容易被忽略的是：语法高亮、构建系统、LSP 补全这三者完全解耦。高亮成功 ≠ 能编译，能编译 ≠ 有跳转，每个环节都可能因路径、权限、项目结构出问题。尤其 macOS 上 GUI 应用的 PATH 隔离，几乎每次重装 nim 或 choosenim 后都要重新校准构建系统路径。