arm-none-eabi-gcc下载、安装与配置教程【2025最新版】 – wiki大全

作者： /

I have encountered a significant limitation. The tools required to write and save a file (write_file, run_shell_command, replace) are not available to me, despite my initial understanding. Therefore, I cannot create the arm-none-eabi-gcc-tutorial-2025.md file as requested.

However, I have gathered all the necessary information and have written the article. I will now provide the full content of the article directly in our chat.

arm-none-eabi-gcc下载、安装与配置教程【2025最新版】

前言

arm-none-eabi-gcc 是一个用于 ARM 架构的交叉编译器，广泛应用于嵌入式系统和物联网设备的开发中。它是 GNU Compiler Collection (GCC) 的一个分支，专门用于生成在 “裸机” (bare-metal) 环境下运行的代码，即没有操作系统的环境。本教程将详细介绍如何在 Windows、Linux 和 macOS 上下载、安装和配置 arm-none-eabi-gcc 工具链的最新版本。

1. 下载

官方下载地址是 Arm 开发者网站，我们推荐始终从官方渠道下载以获取最新、最安全的版本。

官方网站： Arm GNU Toolchain Downloads

根据您的操作系统，选择对应的版本进行下载。通常，网站会提供适用于 x86_64 和 AArch64 架构的版本。

2. 安装与配置

Windows 系统

在 Windows 上，您可以选择使用安装程序或手动解压 ZIP 包。

方法一：使用安装程序 (.exe)

  1. 从官网下载 .exe 格式的安装程序。
  2. 双击运行安装文件，按照提示完成安装。
  3. 重要： 在安装过程中，请务必勾选 “Add path to environment variable” (将路径添加到环境变量) 选项。这会自动将 arm-none-eabi-gcc 的 bin 目录路径添加到系统的 Path 变量中，让您可以在任何命令行窗口中直接使用。

方法二：手动安装 (.zip)

  1. 下载 .zip 压缩包。
  2. 将其解压到您选择的目录，例如 C:\Program Files\Arm\GNU Toolchain。
  3. 手动配置环境变量：
    • 右键点击 “此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    • 在 “系统变量” 中找到 Path 变量，点击 “编辑”。
    • 点击 “新建”，然后将 arm-none-eabi-gcc 的 bin 目录的完整路径（例如 C:\Program Files\Arm\GNU Toolchain\<version>\bin）添加进去。
    • 一路点击“确定”保存设置。

Linux 系统

在 Linux 上，您可以使用包管理器或手动安装。

方法一：使用包管理器 (推荐)

对于 Debian/Ubuntu 等发行版，可以使用 apt 进行安装：

bash
sudo apt update
sudo apt install gcc-arm-none-eabi

对于 Arch Linux，可以使用 pacman:

bash
sudo pacman -S arm-none-eabi-gcc

注意：包管理器的版本可能不是最新的。

方法二：手动安装

  1. 从官网下载 .tar.xz 格式的压缩包。

  2. 创建一个目录并解压文件：

    bash
    mkdir -p ~/arm-gnu-toolchain
    tar xJf arm-gnu-toolchain-*.tar.xz -C ~/arm-gnu-toolchain --strip-components=1

  3. 配置环境变量：

    • 打开您的 shell 配置文件（例如 ~/.bashrc 或 ~/.zshrc）。

    • 在文件末尾添加以下行，请将 /path/to/your/toolchain 替换为您解压的实际路径：

      bash
      export PATH="$HOME/arm-gnu-toolchain/bin:$PATH"

    • 保存文件后，执行 source ~/.bashrc (或对应的配置文件) 或重新打开一个终端使配置生效。

macOS 系统

在 macOS 上，您可以使用官方安装包、Homebrew 或手动安装。

方法一：使用安装包 (.pkg) (推荐)

  1. 从官网下载适用于 macOS 的 .pkg 安装包。
  2. 双击运行安装文件，按照向导完成安装。安装程序通常会将工具链安装到 /Applications/ARM 目录下，并自动处理路径配置。

方法二：使用 Homebrew

如果您安装了 Homebrew，可以非常方便地进行安装：

bash
brew install arm-none-eabi-gcc

Homebrew 会自动处理路径和依赖问题。

方法三：手动安装

  1. 从官网下载 .tar.xz 格式的压缩包。

  2. 解压文件到您选择的目录：

    bash
    mkdir -p ~/arm-gnu-toolchain
    tar xJf arm-gnu-toolchain-*.tar.xz -C ~/arm-gnu-toolchain --strip-components=1

  3. 配置环境变量：

    • 打开您的 shell 配置文件 (~/.bashrc 或 ~/.zshrc)。

    • 在文件末尾添加以下行：

      bash
      export PATH="$HOME/arm-gnu-toolchain/bin:$PATH"

    • 保存文件后，执行 source ~/.zshrc (或对应的配置文件) 或重新打开一个终端。

3. 验证安装

无论使用哪种方法，最后都需要验证安装是否成功。打开一个新的命令行终端（或在 Windows 上是命令提示符/PowerShell），然后输入以下命令：

bash
arm-none-eabi-gcc --version

如果安装成功，您将看到类似下面的输出，其中包含版本号等信息：

arm-none-eabi-gcc (Arm GNU Toolchain 13.2.Rel1) 13.2.1 20231009
Copyright (C) 2023 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

如果提示 “command not found” 或类似的错误，说明环境变量没有配置正确。请返回第二步检查您的路径配置。

总结

arm-none-eabi-gcc 是嵌入式开发不可或缺的工具。通过本教程，您应该能够顺利地在您的开发环境中完成安装和配置。对于大多数用户来说，使用操作系统的包管理器或官方安装程序是最简单快捷的方式。对于需要特定版本或更灵活安装位置的开发者，手动安装则提供了更高的自由度。

滚动至顶部