需先安装Nim编译器并配置全局路径，再安装Pragmagic官方Nim扩展，接着在settings.json中设置nim.compilerPath和nim.serverPath指向实际路径，最后配置tasks.json实现一键编译运行。
如果您希望在Visual Studio Code中编写和调试Nim程序，但尚未配置好语言支持、语法高亮、代码补全或构建运行功能，则需要手动安装扩展并调整设置。以下是完成VSCode与Nim语言开发环境配置的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装Nim编译器
VSCode本身不包含Nim编译器，必须先在系统中安装nim可执行文件，否则所有后续扩展功能均无法正常工作。安装后需确保nim命令可在终端中全局调用。
1、访问 https://nim-lang.org/install.html，下载对应macOS平台的官方安装包或使用choosenim工具。
2、在终端中执行 curl https://nim-lang.org/choosenim/init.sh -sSf | sh 完成choosenim安装。
3、运行 choosenim stable 安装最新稳定版Nim编译器。
4、执行 nim --version 验证安装成功，输出应包含版本号及主机架构信息。
二、安装VSCode Nim扩展
VSCode通过扩展提供Nim语言的核心编辑体验，包括语法高亮、括号匹配、缩进识别和基础语义提示。该扩展不依赖外部工具链，但必须启用才能识别.nim文件。
1、打开VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。
2、在搜索框中输入 Nim，找到作者为 pragmagic 的官方扩展（名称为“Nim”）。
3、点击“安装”按钮，等待扩展下载并启用。
4、重启VSCode，新建一个test.nim文件，确认关键字如 proc、let、var 已呈现语法着色。
三、配置Nim Compiler路径
部分扩展功能（如代码跳转、错误检查）依赖nimlsp语言服务器，而nimlsp需明确知道nim编译器所在位置。若未显式指定路径，扩展可能无法启动LSP服务。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
1、按下 Cmd + , 打开设置界面，在搜索框中输入 nim.compilerPath。
2、点击“在settings.json中编辑”，在用户设置JSON中添加键值对："nim.compilerPath": "/Users/yourname/.nimble/bin/nim"（路径需替换为实际nim可执行文件位置）。
3、保存文件后，重新打开一个.nim文件，观察右下角状态栏是否显示 Nim: ready。
四、启用nimlsp语言服务器
nimlsp提供实时类型推导、符号定义跳转、重命名重构等高级编辑能力，是提升开发效率的关键组件。它作为独立进程运行，需由VSCode扩展调用并管理。
1、在终端中执行 nimble install nimlsp，将nimlsp安装至~/.nimble/bin/目录。
2、确认 nimlsp --version 可正常输出版本信息。
3、在VSCode设置中搜索 nim.serverPath，将其值设为 /Users/yourname/.nimble/bin/nimlsp（请替换为实际路径）。
4、关闭并重新打开.nim文件，等待左下角出现 Nim Language Server active 提示。
五、配置任务以支持一键编译运行
VSCode可通过tasks.json定义自定义构建任务，实现快捷键触发编译与执行，避免频繁切换终端。该配置基于Nim标准编译流程，适用于普通项目结构。
1、在项目根目录下创建 .vscode/tasks.json 文件。
2、填入以下内容：{"version":"2.0.0","tasks":[{"label":"nim compile and run","type":"shell","command":"nim c -r","args":["${file}"],"group":"build","presentation":{"echo":true,"reveal":"always","focus":false,"panel":"shared","showReuseMessage":true,"clear":true}}]}。
3、保存后按 Cmd + Shift + B，选择“nim compile and run”任务。
4、观察集成终端输出，确认生成可执行文件并打印预期结果。
