工具链 安装 Win

本文将介绍 Windows 环境下工具链的配置，主要包含以下组建的安装及配置：

• CLion
• MinGW
• ARM-NONE-EABI
• OpenOCD
• Git for Windows
• ST-Link 驱动

前置阅读资料：工具链 概念介绍

请注意，工具时常更新，本文不一定及时更新。安装遇到问题时，建议仔细阅读提示，配合 Google 尝试理解问题原因，并顺便更新本文档（文档编辑方法参见 Wiki Home），你的贡献能为后续的人提供帮助！

• CLion 的安装及配置
• MinGW 的安装及配置
  • 下载并安装 MinGW
  • 使用 MinGW Installation Manager 安装必要的工具
  • 应用更改
  • 配置环境变量
• GCC-ARM-NONE-EABI 的安装及配置
  • 下载并安装 GCC-ARM-NONE-EABI
  • 增加环境变量
• OpenOCD 的安装及配置
  • 下载 OpenOCD for Windows
  • 解压，并将文件夹放置至系统盘某个位置
  • 设置环境变量
• 确认环境变量
• Git for Windows 的安装及配置
• ST-Link 驱动程序安装
• 下一步
• 更新历史

CLion 的安装及配置

下载 CLion for Mac：CLion: A Cross-Platform IDE for C and C++ by JetBrains

同时，在 JetBrain 官网上使用学校邮箱注册一个账号，以获得免费使用期限。建议使用 ZJU 邮箱。

下载完成后，安装 CLion。首次打开，CLion会要求激活，填入使用学校邮箱注册的账号：

选择安装插件，请注意，如果对这些插件不了解，请不要随意安装，尤其是第一个 Vim 插件：

安装完成后，CLion打开，请确保使用 2019.1 或以后的版本：

MinGW 的安装及配置

MinGW，是 Minimalist GNU for Windows 的缩写，是适用于 Windows 平台的 GNU 工具集。

下载并安装 MinGW

Download File List - MinGW - Minimalist GNU for Windows - OSDN

使用 MinGW Installation Manager (mingw-get) 版本

使用默认选项安装。

使用 MinGW Installation Manager 安装必要的工具

MinGW Installation Manager 如图：

另外，也可以从开始菜单打开 MinGW Installation Manager

右键选择安装以下的包：

• mingw32-base-bin
• mingw32-gcc-g++-bin
• mingw32-make-bin

（这几个包中包含了许多其他包，不要手动取消）

应用更改

之后 MinGW Installation Manager 会自动进行下载与安装，这一过程可能耗时较长，建议在网络条件较好的环境下进行，或使用代理。

配置环境变量

增加：

• C:\MinGW\bin

GCC-ARM-NONE-EABI 的安装及配置

下载并安装 GCC-ARM-NONE-EABI

GNU Arm Embedded Toolchain | Downloads – Arm Developer

（2023.01.09 更新：此页面已停止更新，最新版本发布在 Arm GNU Toolchain Downloads – Arm Developer，不过新版本可能没有经过测试，请根据实际情况选择可用版本。）

根据操作系统选择对应的版本：

注意，最新版本工具链可能不稳定！请小心！以下图片显示的是测试时使用的版本

下载完成后，进行安装

增加环境变量

找到安装目录，将 bin 文件夹增加到环境变量，我的安装目录：

• C:\Program Files (x86)\GNU Tools Arm Embedded\7 2018-q2-update\bin

OpenOCD 的安装及配置

OpenOCD 全称是 Open On-Chip Debugger，是一个开源的单片机工具，配合仿真器（adapter）使用，提供烧录程序、 reset 单片机、远程调试等功能。

下载 OpenOCD for Windows

Download OpenOCD for Windows

解压，并将文件夹放置至系统盘某个位置

以下以 C:\Utilities\OpenOCD-20180728 为例。

设置环境变量

将 bin 文件夹增加到环境变量：

• C:\Utilities\OpenOCD-20180728\bin

确认环境变量

到目前为止，环境变量应与下图类似：

注意环境变量的顺序可能影响编译，如果出现编译出现问题请尝试更改环境变量的顺序。

Git for Windows 的安装及配置

下载 Git for Windows：Git for Windows，并安装。

ST-Link 驱动程序安装

下载 ST-Link V2 驱动程序（在 Meta-Team/Datasheets 中有），根据系统（64位或32位）安装驱动。

下一步

• 工具链 工程配置

更新历史

• 2018.11.10 初次发布. liuzikai
• 2018.11.20 修改工程配置部分. liuzikai
• 2019.01.11 细微修改. liuzikai
• 2019.01.30 适配新的 CMake 构建系统。 liuzikai
  • 适用于使用新 CMakeLists.txt 和 ch.make 的工程/分支
  • 需要关注的更改：
    • 配置工具链部分的第二部分，CMake 配置有所修改
    • 工程配置 - 配置 Run/Debug Configuration 有更改。由于 CLion 的工程配置存在于本地，没有被纳入版本控制，故每次克隆、复制工程都可能需要重新配置。
    • 编译时的显示不一样了（变绿喷雾～（不是
• 2019.02.13 适配完善后的的 CMake 构建系统。 liuzikai
• 2019.02.15 增加 ST-Link 驱动安装相关内容
• 2019.08.21 分离工程配置。 liuzikai
• 2021.07.07 更新工具链系列文档顺序。liuzikai