如何在 VS Code 中开发 MCU

嵌入式专栏 · 发表于 2025-5-3 22:50:00

VS Code 是程序员必备的工具，这款工具最大的特点在于免费且好用，还有丰富的插件，支持主流的几大平台，可以说深受广大程序员的喜爱。

作为单片机开发者， VS Code也是常用的一款功能，本文结合瑞萨 RL78单片机给大家讲述，如何在 VS Code 中开发 MCU。

具体步骤如下：

软件安装
请先确保安装了VS Code（>=v1.96.0）软件和以下VS Code extension。

Renesas Build Utilities构建项目
（您可复制下方链接至浏览器查看）
Renesas Build Utilities构建项目
https://marketplace.visualstudio.com/items？itemName=RenesasElectronicsCorporation.renesas-build-utilities

Renesas Debug调试项目
（您可复制下方链接至浏览器进行查看）
Renesas Debug调试项目
https://marketplace.visualstudio.com/items?itemName=RenesasElectronicsCorporation.renesas-debug

1
Python安装
从下方链接下载并安装64位Python 3.10.0或者以上版本。（您可复制下方链接至浏览器查看）
64位Python 3.10.0
https://www.python.org/downloads/

将Python 3.10文件夹的路径添加到“path”环境变量中。可以参考这篇博文。（您可复制下方链接至浏览器查看）
Windows上安装Python环境并配置环境变量（超详细教程）_python windows环境变量-CSDN博客
https://blog.csdn.net/Lyh1gguyg/article/details/146276117

2
RL78 Smart Configurator
（RL78 SC）安装
从下方链接下载并安装。（您可复制下方链接至浏览器查看）
RL78 Smart Configurator（RL78 SC）
https://www.renesas.com/en/software-tool/rl78-smart-configurator#downloads

3
CMAKE和Ninja安装
从下方链接下载CMake Windows x64 installer（.msi），并安装。（您可复制下方链接至浏览器，或扫描二维码进行查看）
注：CMAKE版本大于3.31.1即可。
CMake Windows x64 installer（.msi）
https://cmake.org/

在安装的时候，注意将CMake文件夹的路径添加到“path”环境变量中。

elxpa5142jy6404450707.png

从下方链接下载ninja-win.zip。解压zip文件，并把ninja.exe复制到CMake的安装路径下的bin文件夹下。（您可复制下方链接至浏览器，或扫描二维码进行查看）
ninja-win.zip
https://github.com/ninja-build/ninja/releases/

打开windows命令窗口。输入ninja--version和cmake--version检查是否安装正确，并且已经添加到了环境变量中。

jlbe1xi5pq46404450807.png

4
安装编译工具链CC-RL和
LLVM for Renesas RL78
CC-RL（您可复制下方链接至浏览器，或扫描二维码进行查看）
CC-RL
https://www.renesas.com/us/en/software-tool/c-compiler-package-rl78-family

LLVM for Renesas RL78（您可复制下方链接至浏览器，或扫描二维码进行查看）
LLVM for Renesas RL78
https://llvm-gcc-renesas.com/rx-download-toolchains/

将CC-RL的bin文件夹路径添加到RENESAS_CCRL_TOOLCHAIN_PATH环境变量中，将LLVM for Renesas RL78的bin文件夹路径添加到RENESAS_LLVM_TOOLCHAIN_PATH环境变量中。

注意
有些电脑用户，如果在添加了CC-RL和LLVM for Renesas RL78到环境变量中，在接下来的步骤中，遇到了上述变量找不到的情况，可以尝试使用管理员权限打开和运行VS Code。

4xeumu4z15h6404450907.png

5
打开VS Code
打开VS Code，请先确保已经在VS Code中已经安装好Renesas Build Utilities和Renesas Debug扩展。

打开Command Palette（鼠标左键选择View=>Command Palette菜单，或者使用CTRL+SHIFT+P快捷键），然后再点击Renesas：Create RL78 Project with Smart Configurator。

5rsnsadakfq6404451007.png

VS Code将显示已经安装的RL78 Smart Configurator列表，从列表中选择一个RL78 Smart Configurator。

ghig0vawwlf6404451107.png

如果您看不到已经安装的RL78 Smart Configurator列表，VS Code右下方会弹出消息框，提示“No RL78 Smart Configurator installation found！”。

点击Browse RL78 SC按钮。

x1v0euq35ic6404451207.png

在弹出的对话框中选择已经安装的RL78 Smart Configurator执行文件（SmartConfigurator.exe）。
RL78 Smart Configurator将自动导入并注册RL78 SC到VS Code中。

创建工程
打开VS Code，点击View→Command Palette后，选择Renesas：Create RL78 Project with Smart Configurator。

VS Code会显示已经安装的RL78 Smart Configurator列表，选择其中的一个RL78 Smart Configurator。

选择创建工程的文件夹

nbdut5sohv26404451307.png

输入项目名称，配置好您的板子信息，设备类型和工具链。然后点击Next。

lk4ondrhu4e6404451407.png

点击System，在On-chip debug operation setting处选择Use emulator或者COM Port。

jepexgmwzzh6404451507.png

单击Generate Code并闭RL78 Smart Configurator。

krmrkqzuxem6404451607.png

工程编译
注意
VS Code中的Restricted模式，会造成Command Palette中CMake命令不可用。

csnutwft1gm6404451707.png

需要将Restricted模式关闭。点击左下角的Restricted Mode，点击Trust。

kb1bg1drpfs6404451808.jpg

在VS Code，请使用Command Palette中的 “CMake：Delete Cache and Reconfigure”。