Ubuntu 18.04 GCC安装与多版本管理全攻略-北京尧图网络

简介这份资源面向需要在 Ubuntu 18.04 环境下离线部署 GCC 编译工具链的开发者和运维人员尤其适合内网服务器、无外网条件的实验环境或批量装机场景。压缩包共 25 个文件以 24 个 deb 安装包和 1 个 sh 脚本为主整体约 20.05MB涵盖 gcc-7、cpp-7、binutils 系列以及 libasan4、libgomp1、libquadmath0 等运行库与开发依赖基本覆盖 GCC 7.3 编译环境所需的组件。资源已获得 3205 人学习下载说明其在离线安装场景中具有较高的参考价值。借助包内脚本读者可快速完成依赖顺序安装与配置避免逐一下载依赖的繁琐过程同时也能借此理解 GCC 工具链各组件之间的依赖关系为后续排查编译环境问题提供思路。整体目录结构清晰适合需要快速搭建本地编译环境或研究 deb 包依赖关系的读者使用。1. 从 ubuntu18.04gcc.zip 说起一个压缩包背后到底藏着什么如果你在搜索引擎里敲下ubuntu18.04gcc.zip大概率不是想研究压缩算法而是遇到了一个很具体的场景手上有一台 Ubuntu 18.04 的机器或者一个基于它的开发环境需要把 GCC 编译器装好、配好、跑通。这个标题看起来像个文件名实际上它指向的是一整套「在 Ubuntu 18.04 上部署 GCC 工具链」的落地需求。Ubuntu 18.04 是个长期支持版本很多工业控制、嵌入式开发、老项目维护的机器至今还跑着它而 GCC 作为 Linux 下最核心的编译器装不上或者装不对后面的代码编译、交叉编译、驱动构建全都无从谈起。这个方向适合三类人一是刚接触 Linux 开发、需要在 Ubuntu 18.04 上把编译环境搭起来的新手二是维护老项目、发现系统自带的 GCC 版本不够用或者被误删的工程师三是做嵌入式开发、需要特定版本 GCC 来编译固件或内核模块的从业者。核心要解决的问题就三个怎么装、装哪个版本、装完怎么验证和切换。别小看这三件事ubuntu安装gcc失败是个高频搜索词说明翻车的人不在少数。接下来我会按「先搞清楚系统里有什么、再决定怎么装、最后处理版本冲突」的顺序把这条路径拆开讲透。2. Ubuntu 18.04 上的 GCC 安装路径从 apt 到源码编译2.1 先摸清系统自带的 GCC 状态在动手装任何东西之前先看系统里现在是什么情况。Ubuntu 18.04 默认的软件源里带的是 GCC 7.5.0这个版本对大多数常规开发够用但如果你要编译较新的内核或者某些依赖 C17 以上特性的项目就可能不够。打开终端依次执行下面几条命令把现状摸清楚。# 查看当前 gcc 版本 gcc --version # 查看 gcc 实际指向哪个可执行文件 which gcc # 列出系统里已经安装的所有 gcc 相关包 dpkg -l | grep gcc # 查看当前系统架构确认是 amd64 还是 arm64 uname -m这几条命令的输出信息很关键。gcc --version告诉你当前默认编译器版本which gcc让你知道它到底指向/usr/bin/gcc还是某个手动装的路径dpkg -l | grep gcc能看出系统里是不是已经装了多个版本的 GCC比如gcc-7、gcc-8同时存在uname -m则决定了你后面下载的包或者源码编译时的目标架构。很多人ubuntu安装gcc失败第一步就错在没确认系统里已经有什么直接上手装结果版本冲突或者依赖断裂。如果gcc --version提示 command not found说明系统里根本没装 GCC或者环境变量 PATH 被改坏了。这时候先别急着重装系统用apt补装就行。如果输出的是 GCC 7.5.0那说明默认版本还在你可以选择升级或者额外装一个新版本共存。2.2 用 apt 安装指定版本的 GCCUbuntu 18.04 的官方源里能直接拿到的 GCC 版本包括 7 和 8再高的版本比如 GCC 9、10、11 就需要加 PPA 或者手动编译。对于大多数场景我建议先用 apt 装一个稳定的版本别一上来就源码编译那是最后的手段。# 更新软件包列表确保源信息是最新的 sudo apt update # 安装 gcc-8 和 g-8同时装上对应的基础依赖 sudo apt install -y gcc-8 g-8 # 如果需要 GCC 7 的完整工具链也可以显式安装 sudo apt install -y gcc-7 g-7 # 安装 make、binutils 等编译辅助工具 sudo apt install -y make binutils build-essential这里有几个参数和选择需要说明。gcc-8和g-8是分开的包只装gcc-8不会有 C 编译器如果你的项目里有.cpp文件必须把g-8一起装上。build-essential是个元包它会自动拉取gcc、g、make、libc6-dev等一整套基础编译环境适合全新系统一次性配好。-y参数是自动确认避免安装过程中卡在交互提示上。装完之后系统里会同时存在多个 GCC 版本但默认的gcc命令仍然指向原来的版本。你需要用update-alternatives来管理默认指向这是 Ubuntu 下切换多版本工具的标准做法。# 把 gcc-8 注册到 alternatives 系统里优先级设为 80 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 80 # 把 gcc-7 也注册进去优先级设为 70 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 70 # 交互式选择默认的 gcc 版本 sudo update-alternatives --config gcc--install后面的四个参数分别是链接组的目标路径、组名、实际可执行文件路径、优先级。优先级数字越大自动模式下的默认选择就越靠前。--config会弹出一个列表让你手动选选完之后/usr/bin/gcc这个软链接就会指向你选的版本。同样的操作也要对g做一遍否则会出现 C 编译器版本和 C 编译器版本不一致的玄学问题。注意update-alternatives只影响通过它注册过的命令。如果你之前手动改过/usr/bin/gcc的软链接或者把某个路径硬编码进了环境变量alternatives 可能不生效。这时候用ls -l /usr/bin/gcc看一下软链接到底指向哪里。2.3 源码编译安装更高版本的 GCC当 apt 源里找不到你需要的版本时比如项目要求 GCC 9 以上就只能源码编译。这条路耗时较长但可控性最强。以下载 GCC 9.5.0 为例整个流程包括下载源码、安装依赖、配置、编译、安装五步。# 安装源码编译所需的依赖库 sudo apt install -y libgmp-dev libmpfr-dev libmpc-dev libisl-dev # 下载 GCC 9.5.0 源码包 wget https://ftp.gnu.org/gnu/gcc/gcc-9.5.0/gcc-9.5.0.tar.gz # 解压到当前目录 tar -xzf gcc-9.5.0.tar.gz # 进入源码目录 cd gcc-9.5.0 # 下载 GCC 依赖的第三方库gmp、mpfr、mpc ./contrib/download_prerequisitesdownload_prerequisites这个脚本会自动下载并解压 GCC 编译所需的三个数学库省去手动处理的麻烦。如果网络环境导致下载失败也可以手动去对应官网下载后放到源码目录里。依赖准备好之后创建一个独立的构建目录不要在源码目录里直接 configure这是避免污染源码树的标准做法。# 回到上级目录创建构建目录 cd .. mkdir gcc-9.5.0-build cd gcc-9.5.0-build # 配置编译选项 ../gcc-9.5.0/configure \ --prefix/usr/local/gcc-9.5.0 \ --enable-languagesc,c \ --disable-multilib \ --disable-bootstrap # 启动编译-j 后面的数字根据 CPU 核心数调整 make -j$(nproc) # 安装到指定前缀目录 sudo make install--prefix决定了安装路径我习惯把第三方编译的 GCC 放到/usr/local/下面和系统自带的/usr/bin/隔离避免覆盖系统编译器导致系统工具链崩溃。--enable-languagesc,c表示只编译 C 和 C 前端如果你需要 Fortran 或者 Go 前端可以加上对应的语言名。--disable-multilib在 64 位系统上只生成 64 位库减少编译时间和磁盘占用。--disable-bootstrap跳过三阶段自举能显著缩短编译时间代价是编译器本身的优化程度略低但对日常使用影响不大。make -j$(nproc)里的$(nproc)会自动读取 CPU 核心数比如 8 核机器就相当于make -j8。编译 GCC 是个重活8 核机器大概需要 20 到 40 分钟内存建议不低于 4GB否则可能在链接阶段被 OOM killer 干掉。编译完成后make install会把可执行文件放到/usr/local/gcc-9.5.0/bin/下面你还需要把这个路径加到 PATH 里或者用 alternatives 注册进去。# 把新编译的 GCC 加入 alternatives 管理 sudo update-alternatives --install /usr/bin/gcc gcc /usr/local/gcc-9.5.0/bin/gcc 90 sudo update-alternatives --install /usr/bin/g g /usr/local/gcc-9.5.0/bin/g 90 # 验证版本切换是否生效 gcc --version到这里Ubuntu 18.04 上安装 GCC 的三条主要路径就讲完了apt 装现成包、alternatives 管多版本、源码编译装新版。选哪条路取决于你的项目对 GCC 版本的要求和你能接受的折腾程度。3. 装完 GCC 之后环境变量、多版本共存与交叉编译配置3.1 环境变量配置的常见翻车点GCC 装好了但gcc --version显示的版本不对或者编译时报找不到头文件这类问题多半出在环境变量上。ubuntu环境变量配置错误是个高频搜索词说明很多人在这上面栽过跟头。Linux 下和 GCC 相关的环境变量主要有三个PATH、LIBRARY_PATH、C_INCLUDE_PATH。PATH决定 shell 去哪些目录找可执行文件。如果你把新 GCC 的bin目录加到了PATH最前面那gcc命令就会优先找到新版本。但要注意PATH的顺序很关键加在末尾等于没加。检查方法很简单# 查看当前 PATH 的完整内容注意冒号分隔的顺序 echo $PATH # 确认 gcc 实际被解析到哪个路径 type -a gcctype -a gcc会列出所有能匹配到gcc的路径按PATH顺序排列第一个就是实际执行的。如果第一个不是你期望的版本要么调整PATH顺序要么用 alternatives 统一管理。LIBRARY_PATH和LD_LIBRARY_PATH容易混淆。LIBRARY_PATH是编译链接阶段用的告诉链接器去哪里找.a和.so文件LD_LIBRARY_PATH是运行阶段用的告诉动态加载器去哪里找共享库。编译时找不到-lstdc通常是LIBRARY_PATH的问题运行时提示error while loading shared libraries则是LD_LIBRARY_PATH的问题。我一般会在~/.bashrc里显式设置这两个变量但只针对当前用户不动系统级配置。# 在 ~/.bashrc 末尾追加以下内容 export PATH/usr/local/gcc-9.5.0/bin:$PATH export LIBRARY_PATH/usr/local/gcc-9.5.0/lib64:/usr/local/gcc-9.5.0/lib:$LIBRARY_PATH export LD_LIBRARY_PATH/usr/local/gcc-9.5.0/lib64:/usr/local/gcc-9.5.0/lib:$LD_LIBRARY_PATH改完~/.bashrc后记得source ~/.bashrc让它生效。这里有个血泪经验不要把新路径直接覆盖掉原来的PATH一定要用$PATH把旧值拼在后面否则系统命令可能全部失效连ls都跑不了。3.2 多版本 GCC 共存的目录规划一台机器上同时存在 GCC 7、8、9 甚至更高版本是常态关键是怎么让它们互不干扰。我的做法是按版本号分目录存放每个版本有独立的bin、lib、include然后通过 alternatives 或者环境变量来切换。版本安装路径管理方式适用场景GCC 7.5.0/usr/bin/gcc-7apt alternatives系统默认基础编译GCC 8.4.0/usr/bin/gcc-8apt alternatives较新 C 特性GCC 9.5.0/usr/local/gcc-9.5.0源码编译 PATH新标准项目GCC 11.2.0/usr/local/gcc-11.2.0源码编译 PATH内核/驱动编译这张表是我在一台开发机上实际维护的版本布局。系统自带的 GCC 7 不动它因为很多系统工具依赖它GCC 8 用 apt 装方便快速切换GCC 9 和 11 用源码编译放在/usr/local/下需要时通过PATH或者 alternatives 切过去。这样做的代价是磁盘占用多一些但换来的是版本隔离不会出现「升级 GCC 后系统命令全挂」的惨剧。切换版本时除了gcc和g别忘了cc、c、cpp这些命令也可能需要同步。cc通常是gcc的软链接c是g的软链接但有些构建脚本会直接调用cc如果它指向旧版本编译结果可能不符合预期。用ls -l /usr/bin/cc确认一下指向必要时也用 alternatives 注册。3.3 交叉编译场景下的 GCC 配置嵌入式开发里经常需要在 Ubuntu 18.04 上编译目标平台是 ARM 或 RISC-V 的代码这时候用的不是本机 GCC而是交叉编译工具链。ch32v在gcc编译器下定义中断函数这个搜索词就反映了 RISC-V 或 ARM 平台下用 GCC 的典型场景。交叉编译工具链通常以arm-linux-gnueabihf-gcc或riscv64-unknown-elf-gcc这样的名字出现安装方式有两种apt 装现成的或者从芯片厂商官网下载。# 安装 ARM 交叉编译工具链 sudo apt install -y gcc-arm-linux-gnueabihf g-arm-linux-gnueabihf # 安装 RISC-V 交叉编译工具链如果源里有的话 sudo apt install -y gcc-riscv64-unknown-elf # 验证交叉编译器是否可用 arm-linux-gnueabihf-gcc --version交叉编译时--sysroot参数指定目标平台的根文件系统路径-march和-mabi指定目标架构和 ABI。比如编译 RISC-V 代码时# 编译一个简单的 RISC-V 程序 riscv64-unknown-elf-gcc -marchrv32imac -mabiilp32 -o test.elf test.c-marchrv32imac表示目标架构是 32 位 RISC-V支持整数、乘除、原子和压缩指令集-mabiilp32表示 ABI 是 32 位整数、长整型和指针。这两个参数必须和目标硬件匹配写错了编译能过但运行会出问题。中断函数的定义在 RISC-V GCC 下通常用__attribute__((interrupt))来标记具体写法取决于芯片厂商的头文件封装但底层机制是 GCC 的属性扩展。提示交叉编译工具链的版本要和目标平台的内核版本、C 库版本匹配。用高版本 GCC 编译的二进制放到低版本 C 库的系统上跑可能出现GLIBC_2.xx not found的错误。遇到这种情况要么降低编译时的 C 库依赖要么在目标平台上更新 C 库。4. GCC 安装与使用的避坑清单从依赖断裂到版本回退4.1 坑一apt 安装时报依赖错误现象执行sudo apt install gcc-8时提示The following packages have unmet dependencies或者卡在Unable to correct problems, you have held broken packages。原因Ubuntu 18.04 的软件源可能被改过或者之前装过第三方 PPA 导致依赖关系混乱。常见的情况是libc6-dev版本和gcc-8要求的版本不匹配或者binutils被手动升级过。解决先用sudo apt --fix-broken install尝试自动修复然后sudo apt update刷新源。如果还不行用apt-cache policy gcc-8查看候选版本和依赖要求手动把冲突的包降级或升级到匹配版本。实在搞不定就sudo apt install -f强制修复但要注意这可能会卸载一些包操作前先看清楚提示。4.2 坑二源码编译 GCC 时内存不足被 kill现象make -j8跑到一半突然报gcc: internal compiler error: Killed (program cc1plus)或者直接提示virtual memory exhausted。原因GCC 编译过程中cc1plus这个进程非常吃内存尤其是编译 C 前端时单个进程可能占用 1GB 以上。如果-j的并行数太高多个cc1plus同时跑物理内存加交换分区都不够用就会被系统的 OOM killer 干掉。解决降低并行数比如从-j8改成-j2或-j1牺牲时间换稳定。同时检查交换分区大小free -h看一下 swap 是不是太小必要时临时增加 swap 文件。另外--disable-bootstrap也能减少编译过程中的内存峰值。4.3 坑三升级 GCC 后系统命令异常现象把/usr/bin/gcc的软链接直接指向新版本后apt、dpkg甚至ls开始报错提示找不到某些共享库。原因Ubuntu 系统里很多工具是用系统自带的 GCC 编译的依赖特定版本的libstdc。如果你把默认gcc换成了高版本但libstdc没有同步更新或者新版本的库路径没有加到LD_LIBRARY_PATH就会导致动态链接失败。解决永远不要直接覆盖/usr/bin/gcc的软链接。用update-alternatives管理或者把新 GCC 放到/usr/local/下通过PATH切换。如果已经搞坏了用sudo update-alternatives --config gcc切回旧版本或者手动把软链接恢复成/usr/bin/gcc-7。4.4 坑四gcc 升级后版本号没变现象明明装好了 GCC 9gcc --version还是显示 7.5.0或者which gcc指向的路径不对。原因PATH里旧版本的路径排在前面或者 shell 缓存了旧的命令位置。gcc升级后为啥还是旧版本这个搜索词说的就是这种情况。解决先hash -r清除 shell 的命令哈希缓存然后type -a gcc看所有匹配路径。如果新版本路径在PATH里但排在后面调整~/.bashrc里的顺序把新路径放到$PATH前面。如果是 alternatives 管理的用sudo update-alternatives --config gcc确认选中的是哪个版本。4.5 坑五编译时找不到头文件或库文件现象编译时报fatal error: stdio.h: No such file or directory或者链接时提示cannot find -lstdc。原因新装的 GCC 没有正确配置头文件搜索路径或者LIBRARY_PATH没有包含新版本的库目录。源码编译 GCC 时如果--prefix指定的路径和实际安装路径不一致也会导致这个问题。解决用gcc -v -E -x c /dev/null查看 GCC 实际搜索的头文件路径确认/usr/local/gcc-9.5.0/include在列表里。如果不在检查--prefix是否正确或者手动设置C_INCLUDE_PATH和LIBRARY_PATH。对于-lstdc找不到的情况确认g是否和gcc版本一致以及libstdc.so是否在库搜索路径下。5. 验证 GCC 安装是否真正可用编译测试与版本回退技巧装完 GCC 只是第一步真正要确认的是它能不能正常工作。我习惯用三个层次的测试来验证最小编译测试、多版本切换测试、回退测试。这三个测试跑完基本能覆盖 90% 的安装问题。最小编译测试用一个包含 C 和 C 的混合项目确认gcc和g都能正常调用头文件和库文件都能找到。# 创建一个测试目录 mkdir -p ~/gcc-test cd ~/gcc-test # 写一个简单的 C 程序 cat test.c EOF #include stdio.h int main() { printf(C compile OK, GCC version: %d.%d.%d\n, __GNUC__, __GNUC_MINOR__, __GNUC_PATCHLEVEL__); return 0; } EOF # 写一个简单的 C 程序用到 C17 特性 cat test.cpp EOF #include iostream #include optional int main() { std::optionalint val 42; std::cout C compile OK, value: *val std::endl; return 0; } EOF # 编译 C 程序 gcc -o test_c test.c ./test_c # 编译 C 程序指定 C17 标准 g -stdc17 -o test_cpp test.cpp ./test_cpp__GNUC__、__GNUC_MINOR__、__GNUC_PATCHLEVEL__是 GCC 预定义宏分别对应主版本号、次版本号和补丁号。运行test_c会打印出当前编译器的实际版本这比gcc --version更可靠因为它反映的是编译时真正生效的版本。C 测试里用了std::optional这是 C17 的特性如果编译器版本不够或者标准没指定对编译会直接报错能快速暴露问题。多版本切换测试的目的是确认 alternatives 或者 PATH 切换是否生效。写一个脚本依次切换版本并记录gcc --version的输出。# 记录当前版本 echo 当前默认版本 gcc --version | head -1 # 切换到 GCC 8 sudo update-alternatives --set gcc /usr/bin/gcc-8 echo 切换到 GCC 8 gcc --version | head -1 # 切换到源码编译的 GCC 9 sudo update-alternatives --set gcc /usr/local/gcc-9.5.0/bin/gcc echo 切换到 GCC 9 gcc --version | head -1 # 切回默认版本 sudo update-alternatives --auto gcc echo 恢复自动模式 gcc --version | head -1--set是强制指定某个版本--auto是恢复自动选择模式按优先级决定默认版本。这个脚本跑一遍如果每个版本的输出都符合预期说明 alternatives 配置正确。如果某个版本切换后gcc --version没变检查该版本是否已经注册到 alternatives 里用update-alternatives --list gcc查看已注册的版本列表。回退测试是最容易被忽略但最关键的一步。很多人在升级 GCC 之后发现项目编译不过想切回旧版本结果发现旧版本的软链接已经被覆盖了。所以我在每次升级之前都会先记录当前默认版本的路径并确认旧版本的可执行文件还在。# 升级前记录当前 gcc 路径 readlink -f $(which gcc) ~/gcc-backup.txt cat ~/gcc-backup.txt # 如果升级后需要回退直接用记录的路径恢复 # 假设备份文件里是 /usr/bin/gcc-7 sudo update-alternatives --set gcc /usr/bin/gcc-7 sudo update-alternatives --set g /usr/bin/g-7readlink -f会解析软链接的最终目标路径把它存到文件里相当于给自己留了一颗后悔药。回退时用--set切回去就行不需要重新安装。如果连 alternatives 都乱了还可以直接用绝对路径调用旧版本编译器比如/usr/bin/gcc-7 -o test test.c临时绕过默认版本的问题。最后一个技巧是关于vscode gcc一键编译运行的配置。如果你在 Ubuntu 18.04 上用 VS Code 写 C/Ctasks.json里的command字段默认是gcc它走的是系统默认版本。如果你想固定用某个版本把command改成绝对路径比如/usr/local/gcc-9.5.0/bin/gcc这样无论系统默认版本怎么切VS Code 里编译用的始终是你指定的那个。c_cpp_properties.json里的compilerPath也要同步改否则 IntelliSense 的提示和实际编译行为可能不一致。这套验证流程我用了好几年从 Ubuntu 16.04 到 18.04 再到 20.04基本没翻过车。核心习惯就一条每次动编译器之前先备份当前路径装完先跑最小编译测试确认没问题再切默认版本。GCC 这东西不像应用软件它和系统底层绑得太深一旦搞坏修复成本很高。希望帮到你。本文还有配套的精品资源点击获取

Ubuntu 18.04 GCC安装与多版本管理全攻略

相关推荐

半导体标签管理系统架构设计与追溯体系落地指南

光模块四大核心组件详解：TOSA、ROSA、Driver与MCU

OpenClaw爆火背后：开源智能体项目如何避免被大厂收编？

更多资讯

Hugging Face与魔搭：开源大模型落地的双操作系统

决策模型新选择：NeoHorse-Jev-4B本地部署实战

从RAG到Agent：联网搜索与工具调用式搜索的工程实践

多模态情感分析大作业实战：从Jupyter到可复现模型全流程

基于机器学习的Web日志异常检测工具：配置、实战与避坑指南

LangGraph.js+Next.js构建可解释AI求职智能体

今日更新

Agent Skills 完全指南：原理、写法、安装与实战避坑

Agent Skills 实战：从 Genkit 定义到 GKE 部署与排查

Agent Skills 实战：从设计到调试的完整指南

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？