nRF Connect SDK 开发环境配置踩坑记录

一发现问题我在搭建 nRF52832 的开发环境时从网盘下载了 nCS v2.4.0 的 SDK 和工具链压缩包解压后目录结构看起来没问题但 VS Code 的 nRF Connect 扩展就是不认。WELCOME 视图里一直显示 Install SDK 和 Install Toolchain 两个按钮SDK 和工具链的按钮都没消失。正常识别到的话对应的按钮会消失全部识别到就会显示 Manage SDKs、Manage Toolchains、Open an Existing Application 等选项。但我的状态栏一直会显示 Install SDK 和 Install Toolchain说明扩展没认到任何东西。二排查过程先是试了在 settings.json 里加nrf-connect.toolchainManager.installDirectory目录填对了但没效果。又试了旧版教程里常见的nrf-connect.sdk.path和nrf-connect.toolchain.path结果 VS Code 提示是未知配置——新版本已经废弃了这两个设置项。去 Nordic DevZone 看了一下才知道2026 版的扩展改成了只认 Toolchain Manager 安装的工具链手动复制进去的不在注册列表里扩展不认。然后发现toolchains/目录下缺了一个toolchains.json这个文件是扩展用来识别工具链的注册清单。SDK 也需要手动把文件夹加入 VS Code 工作区扩展才会认到里面的.west\config。三解决方法1. 目录结构D:\ncs\ ├── toolchains\ │ ├── toolchains.json ← 工具链注册文件 │ └── v2.4.0\ ← 工具链 │ ├── environment.json │ ├── manifest.json │ └── opt\... │ └── v2.4.0\ ← SDK 源码有 .west\config ├── zephyr\ └── nrf\...2. toolchains.json这个文件是扩展扫描工具链的入口。内容参考了网上其他博客按自己的版本信息改[{default_toolchain:{ncs_version:v2.4.0},schema:1,toolchains:[{identifier:{bundle_id:v2.4.0},ncs_versions:[v2.4.0]}]}]其中ncs_version和bundle_id填你实际下载的工具链版本号。工具链目录名这里是v2.4.0也要跟配置里对应。3. 扩展设置Ctrl, → 搜索 toolchainManager nrf-connect.toolchainManager.installDirectory → D:\ncs告诉扩展工具链装在哪个目录下。4. SDK 加入工作区在 VS Code 里打开 SDK 所在的文件夹含 .west 的那一层扩展自动认到。四总结新版 nRF Connect 扩展2026.x去掉了手动添加 SDK 路径的设置入口改用 Toolchain Manager 统一管理。如果网络不好想从网盘手动配置需要自己补上toolchains.json、配好目录结构、把 SDK 文件夹加入工作区。如果有纰漏之处欢迎指正。