新建工程最简单的方式是使用 STM32CubeIDE（官方免费一体工具）。以下是具体步骤：

---

一、打开 STM32CubeIDE，选择工作空间

· 启动软件，设置一个全英文路径的工作空间文件夹，点击“Launch”。

二、新建 STM32 工程

1. 点击 File → New → STM32 Project。
2. 在 MCU/MPU Selector 选项卡中：
· 输入你的芯片型号（如 STM32F103C8）
· 在列表中找到对应型号，选中后点击 Next
3. 设置工程名称（英文），选择工程存放路径（全英文），点击 Finish。

三、配置芯片外设

软件会自动打开 STM32CubeMX 配置视图，在这里配置：

1. 配置调试接口（必须）

· 左侧 System Core → SYS
· Debug 选择 Serial Wire（SWD模式）

2. 配置时钟

· 左侧 System Core → RCC
· High Speed External 选择 Crystal/Ceramic Resonator
· 进入 Clock Configuration 页，设置 HSE 为 8 MHz，通过 PLL 配置系统主频（如 72 MHz）

3. 配置 GPIO（例如点灯）

· 在芯片引脚图上找到 LED 连接的引脚（如 PB1）
· 鼠标左键点击，选择 GPIO_Output
· 右侧 Pinout 视图可以设置初始电平、上拉/下拉等

4. 配置串口（如需打印）

· 左侧 Connectivity → USART1
· 模式选择 Asynchronous
· 可在 Configuration 页设置波特率（如 115200）

四、生成代码

1. 点击 Project Manager 标签
2. 确认 Toolchain/IDE 为 STM32CubeIDE
3. 点击右上角 GENERATE CODE
4. 生成完成后，软件会自动切换到代码编辑视图

五、编写用户代码

打开 Core/Src/main.c，在 main 函数的 while(1) 循环中找到：

```c
/* USER CODE BEGIN WHILE */
while (1)
{
/* USER CODE END WHILE */

/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
```

在 /* USER CODE BEGIN 3 */ 和 /* USER CODE END 3 */ 之间添加你的代码，例如点灯：

```c
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_1);
HAL_Delay(500);
```

六、编译与下载

点击工具栏的 锤子图标（Build）编译工程
连接 ST-Link 等调试器，点击 虫子图标（Debug）或 向下箭头（Run）
在弹出的调试配置中确认调试器类型，点击 OK 即可烧录运行

关键提醒

· 路径不能有中文：工作空间、工程名、文件夹路径都不要出现中文
· 调试接口必须配置：否则烧录一次后，下次无法连接芯片
· 用户代码写在 USER CODE 段内：避免重新生成代码时被覆盖

如果你是第一次使用，建议直接按照上述步骤用 STM32CubeIDE 完成一个简单的点灯工程，就能快速上手了。