STM32CubeIDE 1.19.0 安装及 STM32H745I 固件包配置教程

本教程详细介绍如何在 Windows 系统上下载安装 STM32CubeIDE 1.19.0，并配置 STM32H745I（STM32H7 系列）芯片固件包，从零搭建完整的 STM32H7 双核开发环境。

这个IDE编辑器和固件包官网下载不知道为什么会卡死，有需要的话关注博主，私信自己的邮箱，博主看到会发送的

目录

1. 概述
2. 系统要求与环境准备
3. 下载 STM32CubeIDE 1.19.0
4. 安装 STM32CubeIDE 1.19.0
5. 首次启动与工作空间配置
6. 安装 STM32H745I 固件包（STM32CubeH7）
7. 新建 STM32H745I 工程验证
8. 常见问题与排错
9. 附录

1. 概述

1.1 什么是 STM32CubeIDE

STM32CubeIDE 是意法半导体（STMicroelectronics）官方推出的一站式集成开发环境，基于 Eclipse / CDT 框架，集成了以下核心功能：

1.2 STM32H745I 简介

STM32H745XI 是一款双核微控制器：

注意：STM32H745 属于 STM32H7 系列，对应的固件包为STM32CubeH7。

1.3 本教程适用版本

• STM32CubeIDE：1.19.0
• STM32CubeH7 固件包：V1.11.x（以实际可用最新版为准）
• 操作系统：Windows 10 / 11（64 位）

2. 系统要求与环境准备

2.1 最低系统要求

2.2 安装前准备清单

在开始安装前，请确认以下事项：

• 关闭杀毒软件实时防护：部分杀毒软件可能拦截驱动安装和组件注册
• 确保网络通畅：下载安装包约 2.8 GB，固件包约 500 MB
• 准备 ST 账号：下载安装包和固件包均需要 myST 账号（可免费注册）
• 关闭 VPN：ST 官网检测到 VPN 会拒绝下载请求
• 检查磁盘空间：确保安装目标盘有足够空间
• 管理员权限：安装过程需要管理员权限

2.3 注册 myST 账号（如已有账号可跳过）

1. 打开 ST 官网：https://www.st.com
2. 点击右上角“Register”或“注册”
3. 填写邮箱、姓名、公司等信息（公司信息可填个人或学校）
4. 提交后到邮箱查收激活邮件，点击激活链接
5. 设置密码，完成注册

3. 下载 STM32CubeIDE 1.19.0

3.1 进入官方下载页面

1. 打开浏览器，访问 STM32CubeIDE 官方页面：

   https://www.st.com/en/development-tools/stm32cubeide.html

2. 页面加载后，滚动到下方“Get Software”/“获取软件”区域。

3.2 选择版本并下载

1. 在软件列表中找到STM32CubeIDE-Win（Windows 版本）
2. 点击“Select version”（选择版本）下拉框
3. 在版本列表中选择1.19.0
4. 点击“Get Latest”或对应版本的下载按钮

3.3 接受许可协议

1. 弹出许可协议窗口后，将协议内容滚动到底部
2. 点击“Accept”（接受）按钮

3.4 登录或游客下载

弹出的下载方式选择窗口有两种方式：

方式一：登录下载（推荐）

1. 输入 myST 账号邮箱和密码
2. 点击“Login”
3. 登录成功后自动开始下载

方式二：游客下载

1. 点击“Download as guest”/“作为访客下载”
2. 输入邮箱地址
3. 点击“Get Download Link”/“获取下载链接”
4. 到邮箱中查收 ST 发送的下载链接邮件
5. 点击邮件中的“Download Now”/“立即下载”按钮

3.5 验证下载文件

下载完成后，检查文件信息：

文件名：st-stm32cubeide_1.19.0_xxxxx_xxxxxxxx_xxxx_x86_64.exe.zip 文件大小：约 2.8 GB

提示：下载的是 ZIP 压缩包，需要先解压再运行安装程序。建议使用 7-Zip 或 Windows 自带解压功能。

4. 安装 STM32CubeIDE 1.19.0

4.1 解压安装包

1. 右键点击下载的 ZIP 文件
2. 选择“解压到当前文件夹”或使用 7-Zip 解压
3. 解压后得到安装程序：

   st-stm32cubeide_1.19.0_xxxxx_xxxxxxxx_xxxx_x86_64.exe

重要：解压路径和安装路径均不能包含中文字符，否则可能导致编译错误或工具链异常。

4.2 启动安装程序

1. 右键点击安装程序.exe文件
2. 选择“以管理员身份运行”
3. 如果弹出 Windows 用户账户控制（UAC）对话框，提示 “Do you want to allow this app to make changes to your device?”，点击“是”

4.3 安装向导步骤

步骤 1：欢迎页面

安装向导启动后显示欢迎界面，点击“Next”继续。

步骤 2：许可协议

阅读 ST 软件许可协议（SLA0048），点击“I Agree”接受协议条款。

步骤 3：选择安装路径

• 默认路径：C:\ST\STM32CubeIDE
• 建议修改为非系统盘，例如：D:\ST\STM32CubeIDE_1.19.0

注意：

• 路径中不要有中文、空格和特殊字符
• 建议使用短路径，避免因路径过长导致 Windows 限制问题
• 所需空间约 1.9 GB

点击“Next”继续。

步骤 4：选择组件

安装程序会显示组件选择界面，默认勾选以下组件：

如果使用 ST-LINK 调试器（最常见），三个选项全部勾选即可。

点击“Install”开始安装。

步骤 5：等待安装

安装过程约 3~10 分钟，取决于磁盘速度。安装进度条会显示当前进度。

步骤 6：驱动安装

安装过程中会弹出多个驱动安装对话框（ST-LINK 驱动、J-Link 驱动等），依次点击“下一步” → “完成”即可。

步骤 7：安装完成

安装完成后显示成功界面：

1. 勾选“Create desktop shortcut”（创建桌面快捷方式）
2. 点击“Finish”完成安装

4.4 安装后验证

1. 检查桌面是否出现STM32CubeIDE快捷方式
2. 打开设备管理器，确认没有未知设备
3. 如果已连接 ST-LINK 调试器，设备管理器中应显示：

   通用串行总线控制器 → STMicroelectronics STLink dongle

5. 首次启动与工作空间配置

5.1 启动 STM32CubeIDE

1. 双击桌面上的STM32CubeIDE快捷方式
2. 首次启动会弹出工作空间选择对话框

5.2 配置工作空间

1. 在 “Workspace” 路径栏中输入或浏览选择工作空间目录：

   D:\STM32\Workspace

   工作空间用于存放工程文件，同样不要包含中文路径。

2. 勾选“Use this as the default and do not ask again”（将此作为默认值并不再询问）

3. 点击“Launch”启动

5.3 防火墙提示

首次启动时 Windows 防火墙可能弹出网络访问提示，依次点击“允许访问”即可。

5.4 等待初始化

首次启动需要初始化 Eclipse 工作台，可能需要 30 秒至 1 分钟。看到主界面后即表示启动成功。

注意：如果弹出mcusDocs.json下载错误提示，请先点击 OK 关闭，然后参考本教程第 8 节的排错方法处理。

6. 安装 STM32H745I 固件包（STM32CubeH7）

STM32H745I 属于 STM32H7 系列，需要安装STM32CubeH7固件包才能进行开发。固件包包含 HAL 库、LL 库、CMSIS 头文件、示例工程和中间件。

6.1 打开固件包管理器

1. 在 STM32CubeIDE 主界面，点击顶部菜单栏的“Help”

2. 在下拉菜单中选择“Manage Embedded Software Packages”

   菜单路径：Help → Manage Embedded Software Packages

6.2 登录 ST 账号（在线安装需要）

如果尚未登录 ST 账号：

1. 在固件包管理器窗口中，点击左下角或右上角的“Login”按钮
2. 输入 myST 账号邮箱和密码
3. 点击“Login”登录

登录成功后，固件包列表中的 “Install” 按钮将变为可点击状态。

6.3 选择并安装 STM32H7 固件包

在线安装（推荐）

1. 在固件包管理器左侧列表中，向下滚动找到“STM32H7”系列

2. 点击左侧三角展开 STM32H7 列表

3. 勾选所需版本（建议选择最新的稳定版本，如V1.11.x）

   版本选择建议：选择最新版本即可。如果遇到兼容性问题，可以回退到倒数第 2~3 个版本。

4. 点击右下角的“Install”按钮

5. 弹出许可协议窗口，将内容滚动到底部，点击“Accept”接受

6. 等待下载安装完成（约 500 MB，取决于网速）

离线安装（无网络环境适用）

如果网络不稳定或处于内网环境：

1. 在可联网的电脑上，从 ST 官网下载 STM32CubeH7 固件包 ZIP 文件：

   https://www.st.com/en/embedded-software/stm32cube-h7.html

2. 将 ZIP 文件拷贝到目标电脑
3. 在固件包管理器中，点击右上角的“From Local”（从本地安装）图标
4. 选择本地的 ZIP 文件进行安装

6.4 验证安装结果

1. 安装完成后，STM32H7 固件包前面的状态图标会变为绿色对勾
2. 展开列表可以看到已安装的版本号
3. 点击“OK”关闭固件包管理器

提示：固件包默认安装位置为：

C:\Users\<用户名>\STM32Cube\Repository\STM32Cube_FW_H7_V1.11.x\

6.5 固件包包含内容

STM32CubeH7 固件包安装后包含以下内容：

7. 新建 STM32H745I 工程验证

安装完成后，通过新建一个工程来验证环境是否配置成功。

7.1 创建新工程

1. 点击菜单栏“File” → “New” → “STM32 Project”

   菜单路径：File → New → STM32 Project

2. 在弹出的 “Target Selection” 窗口中，切换到“MCU/MPU Selector”标签页

7.2 选择 STM32H745I 芯片

1. 在搜索框中输入：STM32H745IIT
2. 在下方列表中选择STM32H745IITx
3. 点击“Next”继续

说明：

• STM32H745IIT：LQFP176 封装，2 MB Flash
• STM32H745BIT：TFBGA208 封装
• 根据实际使用的芯片型号选择对应的 Part Number

7.3 配置工程

1. 在 “Project Name” 中输入工程名称，例如：H745_LED_Blink
2. Project Type选择：STM32Cube（默认）
3. Toolchain / IDE选择：STM32CubeIDE（默认）
4. 点击“Finish”

7.4 CubeMX 配置（可选）

工程创建后会自动打开 STM32CubeMX 配置界面：

1. 选择 Cortex-M7 内核作为主处理器（默认）
2. 在“Pinout & Configuration”中配置外设（如 GPIO、USART 等）
3. 在“Clock Configuration”中配置系统时钟（H745 最高 480 MHz）
4. 在“Project Manager” → “Advanced Settings”中确认固件包版本正确
5. 点击“Generate Code”生成初始化代码

7.5 编译验证

1. 点击工具栏的“Build”按钮（锤子图标），或按Ctrl + B
2. 查看控制台输出，确认编译成功：

   Build Finished. 0 errors, 0 warnings

如果编译成功且无错误，说明 STM32CubeIDE 1.19.0 和 STM32H745I 固件包安装配置完成！

8. 常见问题与排错

8.1 mcusDocs.json 下载失败

现象：启动 IDE 或新建工程时弹出错误：

Problem during Download and/or Unzip of selected... Error downloading the following files: mcusDocs.json._tmp_ (Problem during download)

原因：IDE 尝试从 ST 服务器下载 MCU 文档索引，国内网络访问 ST 文档服务器经常超时。

解决方案：

方案 A：直接忽略（最快）

• 点击 OK 关闭弹窗即可，IDE 功能不受影响，仅缺少内置帮助文档

方案 B：关闭文档自动下载（彻底解决）

1. 点击 OK 关闭弹窗
2. Window→Preferences
3. 搜索框输入help或documentation
4. 找到Help → Help Server或MCU相关文档选项
5. 取消勾选 “Automatically download required documentation”
6. Apply and Close→ 重启 IDE

方案 C：修改 hosts 文件

1. 以管理员身份打开C:\Windows\System32\drivers\etc\hosts
2. 尝试添加 ST CDN 解析（IP 会变动，此方法不一定长期有效）

8.2 固件包下载失败或超慢

现象：在 Manage Embedded Software Packages 中点击 Install 后下载极慢或失败

解决方案：

1. 关闭 VPN，使用直连网络
2. 更换 DNS 为8.8.8.8或223.5.5.5（阿里 DNS）
3. 使用离线安装方式（见 6.3 节）
4. 在可联网的电脑上下载固件包后，拷贝整个 Repository 目录：

   C:\Users\<用户名>\STM32Cube\Repository\

8.3 安装路径包含中文导致错误

现象：安装或编译时出现乱码或路径错误

解决方案：

1. 卸载 STM32CubeIDE
2. 重新安装到纯英文路径，例如D:\ST\STM32CubeIDE_1.19.0
3. 工作空间路径也必须为纯英文，例如D:\STM32\Workspace

8.4 ST-LINK 无法识别

现象：连接 ST-LINK 后设备管理器显示黄色感叹号

解决方案：

1. 拔插 ST-LINK USB 线
2. 重新安装 ST-LINK 驱动：运行安装目录下的驱动安装程序

   <安装路径>\Drivers\ST-LINK_USB_Driver\dpinst_amd64.exe

3. 更换 USB 数据线（部分线只供电不传数据）
4. 尝试更换 USB 接口

8.5 编译错误 “No rule to make target”

现象：编译时报错No rule to make target 'xxx.o'

解决方案：

1. Project→Clean...→ 选择工程 →OK
2. Project→Build
3. 如果仍然失败，删除工程目录下的Debug和Release文件夹后重新编译

8.6 双核工程配置

现象：STM32H745 是双核 MCU，不确定如何配置双核

说明：

• STM32H745 拥有 Cortex-M7 和 Cortex-M4 两个内核
• 在 CubeMX 中创建工程时，可选择“Asymmetric”模式同时配置两个内核
• M7 为主核（Core 1），M4 为副核（Core 2）
• 两个核各自有独立的工程和代码空间
• Flash 分区：M7 使用前 1 MB，M4 使用后 1 MB

9. 附录

9.1 相关链接

9.2 STM32H745 关键参数速查

9.3 推荐的稳定版本组合

9.4 版本历史

免责声明：本教程基于公开资料整理，ST 软件版本和界面可能随更新而变化，请以 ST 官方文档为准。如有疑问请访问 ST 官方社区获取支持。