# 前情提要

2026年了，前端用AI，后端用AI，而且软件开发这边一个比一个厉害，今天还是代码补全，明天就是聊天写代码，后天就是从环境配置到部署一气呵成贼牛逼。而且软件这边一个比一个现代，JetBrains全家桶，vscode，trae，codeserver（云原生开发）各种现代工具功能多到专门出一本书介绍他都得来个上下册，但是来到硬件这边...

我是从2021年开始接触硬件编程的，用的第一个软件是arduino，开发esp12用的；然后是keil5，这个如果玩嵌入式的肯定不陌生，也肯定听过一首歌

![一阵强劲的音乐](https://developer.qcloudimg.com/http-save/yehe-3335308/30b287de3d9b7ebb55691fb62351000f.png)

以stm32的开发为例，直到今天，我接触到的身边做硬件的朋友，以及去网上找一些教程，大部分还是keil5，它好就好在支持很多芯片，调试功能也很厉害，可惜需要点手段（听一下音乐）来获得「学习版」。而且它的界面实在是一言难尽，arduino虽然现代一些，但也不像vscode intellicense那么智能，代码补全总差点意思，而且也不集成git代码管理，实在不适合我这种软转硬的小白做项目。再再再再加上，我用的是macOS，本身就没有keil，苹果M芯片引以为傲的单核性能编译性能得被虚拟机打个折。

![Arduino界面](https://developer.qcloudimg.com/http-save/yehe-3335308/fd3552463f019c275f05290ebb5185ca.png)

现在AI时代了，硬件怎么能落后呢。

vscode这么强大，格式化代码，智能提示，AI补全，引用定位什么的都很方便，而且免费，开源，再加上AI生态加持，硬件也怎么能少了它。

# 电脑介绍

因为我用的是mac做开发，接下来的教程偏向macOS的配置，windows一样的，只不过安装可能麻烦一些。

电脑是MacBook Air M4，所以都是基于arm配置的软件

# 软件工具链

## 软件依赖

- Home-brew macOS安装一些软件依赖
- CMake/ninja 编译代码
- git 代码版本管理
- vscode 主角，代码编辑器（只能vscode，trae、cursor这些里面的插件不兼容）
- Clang-format 代码格式化

## STM32依赖

- STM32CubeMX 用于配置芯片引脚和功能
- STLink Utility/STM32 Programmer/你的什么国产进口高端Link的烧录软件 用来写入程序

## 安装

注意，由于懂的都懂的原因，以下所有方式安装都需要特殊手段，全局，tun模式最佳

brew（mac）：运行`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`

VSCode：[Visual Studio Code - The open source AI code editor | Your home for multi-agent development](https://code.visualstudio.com/)

CMake、ninja：mac直接运行`brew install cmake ninja`，windows百度一下

Git：mac直接运行`brew install git`

clang-format：直接运行`brew install clang-format`

stm32cubemx、烧录软件：见下文

## stm32类软件安装

### stm32cubemx

下载链接：[STM32CubeMX | Software - STMicroelectronics](https://www.st.com/en/development-tools/stm32cubemx.html)

到页面下方，找到对应的系统下载，注意，mx2只有C5系列芯片可以用，其他的下载mx

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/673b14e952c282017dbf23d79620967d.png)

下载需要登录账号，可以直接注册一个，或者网上找一个，注册不复杂

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/f0b72bfbe942ab4e493ab5f115ddd293.png)

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/d0b574bc6225c17f729d9b0292c0bca6.png)

macOS下载下来是个压缩包，解压后打开会出现类似windows安装那样的界面，一步一步走就行。但是安装完不要急着打开，有个大坑！！！！

**注意：macOS安装完有大坑！！！**

### stm32cubemx安装的坑

注意最好装在大小写不敏感的磁盘上（系统盘默认就是不敏感的）

安装完后点击那个.app，是打不开的，会提示已损坏，千万别丢垃圾桶了

右键它，显示包内容
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/bf53684d9108dbce8ed40023597680a0.png)

打开`Contents`，如果你是大小写敏感的磁盘，把`MacOs`改为`MacOS`

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/f1ba1191334819470202b1bee6bd5c9b.png)

然后进入`Resources`，右键`STM32CubeMX`，制作替身，也就是软连接

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/01eacc2b7eb01eae5a8b089176a1026f.png)

⌘C复制，然后回到上一级，进入MacOS，⌘⌥V剪切粘贴到MacOS下，重命名为`STM32CubeMX`![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/2b157dd79cd68c1ffc46f5dbbef9d152.png)

接下来点开`STM32CubeMX.app`就可以打开了

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/634988a34eafe63a6a5bd0bd321ba28a.png)


### 烧录软件

因为我手头没有正版stlink，只有powerlink，mac上没有上位机软件，只能通过串口烧录，没有好办法调试。

跟上面一样的，需要进入`Contents`，把`MacOs`改为`MacOS`，然后打开会报错，这时候打开设置，隐私和安全，滑到下面，仍要打开
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/9fedab61ef15f7b8adad8398954bcb25.png)

如果大家是其他厂商的国产烧录器，就用对应的软件就行了。

# VSCode配置

## stm32插件

搜索`stm32cubeide`，第一个就是

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/32a806adf9124880bbffd9ce0ef31abd.png)

同样的，dddd的原因，需要一些特殊手段才能顺利安装，因为过程中还要安装各种依赖环境。

在侧栏出现stm32图标就完成了

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/41eeb2c1d82c77c0e2f95373742e246c.png)



## 格式化工具

搜索`clang-format`，确保电脑安装了clang-format就行。windows需要安装llvm

## AI

这里推荐codebuddy，trae插件有些bug。

然后把codebuddy的窗口拖到右边，就有那感觉了
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/51b4a811dbe4e4b1af01e6d36c5d512c.png)


# 开始第一个项目

至此环境一切准备就绪，开始编程吧

## 配置芯片

先关闭vscode，打开stm32cubemx，创建工程，第一次打开需要安装一些东西，依旧是dddd
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/3edc891a48b675df103988383a2495ce.png)

file，然后new project，选择你的芯片，这里以stm32f103c8t6为例，搜它，双击对应芯片![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/dbf18fa2c54b0b8f135a75a27599edf7.png)

可以收藏起来，下次点击星星就有收藏的芯片了

接下来进入配置页面
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/59671176af738f074ef86ec96de38f35.png)

这里我用的最小系统开发版，接了一颗LED，但是我已经放假回家了，开发版不在身边不演示了。

LED正极接在PA4，负极GND，点击芯片的PA4，然后设置为`GPIO_Output`

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/6adc3ade7051da1de3bd049fd904ed32.png)

接下来进入System Core，点击GPIO，可以看到已经配置成功了

*这里就不过多赘述时钟配置、GPIO模式了，我们不讲这些，讲环境配置用个最简单的demo就好*

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/fd85e5920d822ab02db2d7bb08f3fd14.png)

## 配置项目

来到Project Manager，设置项目路径（上一层目录，因为要在这里创建子文件夹）和名称，默认会帮你创建一个文件夹

关键地方在下面，要把toolchain设置为`CMake`，Compiler默认即可

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/b1be2ce96287f342d7c940799e8ad796.png)

Code generator勾上这个

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/9a4c05570fbaf326d01297cd08d77bcf.png)

然后点击右上角Generate Code，就生成了工程

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/67a3dc6070336dcb70a219c8a4e0b84b.png)

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/1ec7de2fd1aab2a44b67f89aff516355.png)

## vscode开发

打开vscode，打开刚刚生成的文件夹，这里会提示巴拉巴拉stm32巴拉巴拉，意思是自动配置cmake，Yes即可

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/c6a1bdf1db454c3095af190316d67b05.png)

弹窗，预设选择Debug

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/3f1ce51dafc5c075c4039e3b484f18c4.png)

如果点了别的，弹窗没了，就到cmake侧栏，点一下这个

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/d92154bc9dda624697bfe1d7f5a47cbe.png)

接下来就是正常开发了

# 点灯大师

在`Core/Src/main.c`就是我们的主函数

写个小灯闪烁，这里我懒得动手，直接codebuddy

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/0c0b6083fe56a01ca37913fd057546b1.png)

````C
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_4);
HAL_Delay(1000);
````

注意，代码要加在带有`User Code xxxxx`的注释里面，不然CubeMX重新生成会覆盖

点击下面的生成
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/fd5f0a539af9f93256c77fc2cf8d8668.png)

这样就编译好了elf文件

如果用的是正版stlink，可以来到运行和调试，选择stlink，就可以像开发软件那样打断点测试了

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/a0acff76b71a1490f3d9695cdb3584ea.png)

没有的话就用别的方式

# 库导入

由于cmake不会自动加库，自己新建的库文件必须手动配置一下，比如这里我随便写个点灯的库，在`Lib/led`下

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/bdb3340cbc35b60922665a1031dbd05c.png)

在主函数导入，会发现报错

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/bebad255d830d80c1ec2c2539cffd2e6.png)

打开根目录的CMakeList.txt，这么写入

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/f1842df17537150c78ef3b5d3cc3896c.png)

他不支持什么\*\*，\*\*/\*.c这种通配符，代码文件可以这样
```cmakefile
file(GLOB_RECURSE LIB_SOURCE "Lib/*c")

# Add sources to executable
target_sources(${CMAKE_PROJECT_NAME} PRIVATE
    # Add user sources here
    ${LIB_SOURCE}
)
```

这样Lib下所有.c的文件都匹配上了，注意每次新增文件都要去cmake里面⌘S一下刷新一下文件，不然问题依然存在。


保存一下，生成，就没有报错了
![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/f19a237ad9cec52a2f9920be441f7f9c.png)


# git
接下来就是大家最熟悉的东西了，五件套起手

```shell
git init
git remote add origin 你的仓库url
git add .
git commit -m "init"
git push -u origin HEAD:main
```

![image.png](https://developer.qcloudimg.com/http-save/yehe-3335308/0d9988aa8c1b3cae5ac97abeeb0cc060.png)

当然也可以用vscode的git插件功能完成

vscode那个插件帮我们配置了ignore，所以不用担心产物和缓存上传，但是mac要注意.DS_Store

# Demo

这是Demo

[arsrna/hardware/stm32-vsc-demo · Cloud Native Build](https://cnb.cool/arsrna/hardware/stm32-vsc-demo)

至此，整个开发环境就这么解决了，这下硬件开发也可以AI化了，vscode开源、免费，而且界面美观，高级，这才像现代开发的模样，有着丰富的编辑器生态，各种AI插件辅助，像我这样的硬件新手上手更快了，项目管理也能像软件那样方便快捷，这才是真正的future。未来能不能云原生硬件开发呢？毕竟现在用CNB只实现了硬件的仓库托管，期待一下。

2026年了，前端用AI，后端用AI，而且软件开发这边一个比一个厉害，今天还是代码补全，明天就是聊天写代码，后天就是从环境配置到部署一气呵成贼牛逼。而且软件这边一个比一个现代，JetBrains全家桶，vscode，trae，codeserver（云原生开发）各种现代工具功能多到专门出一本书介绍他都得来个上下册，但是来到硬件这边...

STM32现代化AI开发指南-VSCode环境配置（macOS）

宣传大使

人工智能

硬件

2026年AI时代硬件开发新方案：MacOS下使用VSCode+STM32CubeMX搭建现代化嵌入式开发环境，集成AI代码补全、Git管理和CMake编译，告别传统Keil5的繁琐界面，实现硬件开发的智能化升级。包含STM32配置、代码生成、烧录调试全流程教程，让硬件开发也能享受现代IDE的便捷体验。

云原生开发

软件开发

硬件开发

虚拟机

云原生

MacOS

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

STM32现代化AI开发指南-VSCode环境配置（macOS）-腾讯云开发者社区-腾讯云

STM32现代化AI开发指南-VSCode环境配置（macOS）

STM32现代化AI开发指南-VSCode环境配置（macOS）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐