📚 目录#

• 开发环境概述
• 安装 STM32CubeMX
• 安装 CLion
• 安装工具链 STM32CubeCLT
• 创建第一个工程

开发环境概述#

IMPORTANT

测试环境说明：
操作系统：Ubuntu 20.04 LTS
MCU 型号：STM32F103C8T6
开发工具：STM32CubeMX、CLion、STM32CubeCLT
调试接口：ST-Link v2

这套组合是 Linux 下开发 STM32 的主流方案，具备完全开源、可定制的特点。

安装 STM32CubeMX#

IMPORTANT

注意：
STM32CubeMX 依赖 Java 环境，安装前请确保系统已正确配置 JDK。

STM32CubeMX 是 ST 官方提供的图形化初始化配置工具，可生成 HAL 库工程框架。

1. 前往 ST 官方下载页面，下载最新版 Linux 安装包。
2. 下载后解压到你想存放的位置（例如 ~/Iot/）。
3. 解压后文件结构如下：

📘 Readme.html 是官方用户手册，可供参考。

4. 授予安装文件执行权限并安装：

   1
   chmod +x SetupSTM32CubeMX-6.14.1
   2
   ./SetupSTM32CubeMX-6.14.1
   

   安装过程与 Windows 类似，按照提示操作即可。

5. 安装完成后界面如下：

安装 CLion#

Windows 下常用 Keil 开发 STM32，本次尝试使用 JetBrains 的 CLion 进行跨平台开发，参考了 B站 UP 主 keysking 的教学视频。

1. 前往CLion 官网下载 Linux 安装包。

2. 解压后进入 ~/CLion/bin 目录，运行：

   1
   ./clion
   

3. 为方便启动，可创建桌面图标：

   1
   nano ~/.local/share/applications/clion.desktop
   

   粘贴以下内容（路径请根据实际修改）：

   1
   [Desktop Entry]
   2
   Version=1.0
   3
   Type=Application
   4
   Name=CLion
   5
   Icon=/home/yourusername/apps/clion-2025.1/bin/clion.svg
   6
   Exec=/home/yourusername/apps/clion-2025.1/bin/clion.sh
   7
   Comment=JetBrains CLion IDE
   8
   Categories=Development;IDE;
   9
   Terminal=false
   10
   StartupNotify=true
   

TIP

⚠️ 替换路径为实际安装路径，可将 .desktop 文件复制到桌面以便图形化启动。

安装工具链 STM32CubeCLT#

1. 在 STM32CubeMX 右下角点击 External Tools，进入 ST 官网下载 STM32CubeCLT。

2. 下载并解压后，在终端执行：

   1
   chmod 777 st-stm32cubeclt_xx_amd64.sh
   2
   ./st-stm32cubeclt_xx_amd64.sh
   

   WARNING

   ⚠️ xx 为具体版本号，例如 1.18.0，建议全屏运行安装程序避免错过条款提示。

3. 安装过程中全程按 Y 同意协议，设置安装路径（如 /home/xx/st/stm32cubeclt_1.18.0）。

4. 安装成功提示：

   1
   STM32CubeCLT installed successfully
   

5. 插入 ST-Link V2（不接开发板），运行 CLT 目录下的 STLinkUpgrade.sh 升级调试器固件。

6. 添加环境变量：

   1
   echo 'export PATH=$PATH:/home/xx/st/stm32cubeclt_1.18.0/bin' >> ~/.bashrc
   2
   source ~/.bashrc
   

   WARNING

   安装完成建议重启系统，否则 CLion 可能找不到 arm-none-eabi-gcc 等工具。

创建第一个工程#

1. 启动 CLion，选择非商业许可证。

2. 选择新建 STM32 项目：

3. 配置 STM32CubeMX 路径：

4. 启动 CubeMX，新建项目，选择芯片（如 STM32F103C8T6）：

5. 配置调试接口（SW），设置 PC13 为 GPIO_Output：

6. 设置工程路径：

7. 配置工具链，使用 GCC 和 Ninja：

8. 勾选 Reload CMake Project，确保路径生效：

9. 启用调试服务器：

10. 配置 ST-Link：

11. 关闭持久会话以支持自动复位：

12. 烧录测试（点灯）：

    

13. 点击右上角运行，左下角查看烧录日志：

14. 点灯成功 🎉：