VSCode 要支持 Nim 完整功能，必须手动配置 nim 编译器、nimlsp 语言服务器和 tasks.json 构建任务三者；需用 choosenim 安装并显式指定 compilerPath 和 languageServerPath 绝对路径，项目根目录须有 project.nimble 文件。
VSCode 本身不支持 Nim，装了插件也不代表能补全或编译——必须手动配齐 nim 编译器、nimlsp 语言服务器、tasks.json 构建任务三者，缺一不可。
确认 nim 和 nimlsp 已安装并可被终端调用
这是所有功能的前提。VSCode 的 Nim 插件（如 genotrance.nim）不自带编译器或语言服务器，只负责桥接。如果终端里连 nim --version 或 nimlsp --help 都报 command not found，VSCode 一定无法工作。
- 推荐用
choosenim安装：运行curl https://nim-lang.org/choosenim/init.sh -sSf | sh，再执行choosenim stable - 然后运行
nimble install nimlsp，它会把nimlsp放进~/.nimble/bin/nimlsp - 在 VSCode 集成终端中运行
which nim和which nimlsp，确保路径输出正常；若无输出，检查 shell 配置文件（如~/.zshrc）是否已 source~/.nimble/bin
在 settings.json 中正确配置 nim.compilerPath 和 nim.languageServerPath
VSCode Nim 插件不会自动猜路径，必须显式指定两个关键路径，否则状态栏一直卡在 Nim: initializing，补全、跳转全部失效。
-
nim.compilerPath填nim可执行文件的绝对路径，例如/Users/xxx/.nimble/bin/nim -
nim.languageServerPath填nimlsp可执行文件的绝对路径，例如/Users/xxx/.nimble/bin/nimlsp - 这两项必须同时存在，且路径不能带
~符号（得写成完整路径），改完后必须关闭并重新打开整个 VSCode 窗口（不是重载窗口） - 项目根目录下需有
project.nimble或package.nimble，否则nimlsp初始化失败，补全仍不生效
用 tasks.json 实现一键编译（支持任意 .nim 文件）
手动敲 nim c -r main.nim 很快就烦，但错配 tasks.json 会导致错误不显示在“问题”面板，只刷屏在终端里，调试困难。
- 在项目根目录创建
.vscode/tasks.json，"args"字段不要硬写"main.nim"，改用"${file}"，这样当前打开的任意.nim文件都能编译 - 若要后续调试，必须加
"-g"和--debugger:on，例如：["c", "-g", "--debugger:on", "${file}"] - 务必设置
"problemMatcher": "$nim"（不是默认的"$gcc"），否则编译错误不会解析进“问题”面板 - Windows 用户注意路径分隔符，
"program"在 launch.json 中要用双反斜杠或正斜杠，例如"${fileDirname}/${fileBasenameNoExtension}.exe"
补全失效、跳转失败时优先检查这三点
90% 的“插件没反应”问题都集中在这几个地方，而不是插件本身或 VSCode 版本。
- 右下角状态栏是否显示
Nim: ready？如果一直是initializing或报Failed to start nimlsp，说明nim.languageServerPath错了，或nimlsp启动时找不到nim（即nim.compilerPath未配或配错） - 打开的是单个文件（
File > Open File），还是整个文件夹（File > Open Folder）？只有后者才能识别project.nimble并启用完整 LSP 功能 - 当前文件是否属于某个 nimble 项目？如果只是临时新建的
test.nim且不在任何.nimble文件所在目录下，nimlsp会降级为无项目模式，符号补全范围极小
最易被忽略的一点：nimlsp 对项目结构敏感，哪怕 project.nimble 文件内容为空或只有空行，也比完全缺失强；而一旦删掉它，整个语义功能就退回原始状态——这时候你再怎么调 settings.json 都没用。
