# 安装常见问题

URL: https://caijiao.org/gentoo/faq-install
Source: docs/gentoo/faq-install.md
Description: 本章整理 Gentoo 系统安装过程中的常见问题及解决方法，包括下载、分区、网络、编译和启动等方面。

在掌握 Gentoo Prefix 与非 root 环境后，下一步是 **了解 Gentoo 安装常见问题及解决方案**，帮助新手快速排查与解决安装中的问题。

## 一、下载与镜像问题

1. **下载速度慢或失败**  
   - 使用国内镜像（如清华、阿里云）加快同步速度  
   - 使用 `rsync` 或 `axel` 下载 ISO 镜像

2. **校验失败**  
   - 检查 SHA256 或 GPG 签名，确保镜像完整

## 二、LiveCD 启动与网络问题

1. **无法启动 LiveCD**  
   - 检查 ISO 是否正确烧录  
   - 关闭不必要的外设，尝试兼容模式启动

2. **网络无法连接**  
   - 使用 `ifconfig` 或 `ip addr` 查看网络接口  
   - 配置 DHCP 或静态 IP，确保网关和 DNS 正确

## 三、分区与文件系统问题

1. **分区不识别或格式化失败**  
   - 使用 `fdisk -l` 或 `parted` 检查磁盘  
   - 确认分区类型（GPT/MBR）与文件系统支持

2. **挂载失败**  
   - 检查分区 UUID 与 `/etc/fstab` 配置  
   - 确保挂载点存在并权限正确

## 四、Stage3 与 Portage 问题

1. **Stage3 解压失败**  
   - 确认下载完整且文件无损  
   - 使用 `tar xpvf stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner`

2. **Portage 同步失败**  
   - 更换镜像源，检查网络连接  
   - 使用 `emerge --sync` 或 `rsync` 同步

## 五、内核编译与启动问题

1. **内核编译失败**  
   - 检查 CFLAGS 与 makeopts 是否正确  
   - 确认必要驱动已启用

2. **系统无法启动**  
   - 保留旧内核启动选项  
   - 使用 LiveCD 挂载修复 `/boot` 或 GRUB 配置

## 六、系统维护问题

1. **依赖或 USE 标志冲突**  
   - 使用 `emerge --update --deep --newuse @world` 修复  
   - 检查 `/etc/portage/package.use` 和全局 USE 标志

2. **编译过慢或失败**  
   - 调整 `MAKEOPTS` 并启用 `ccache`  
   - 适当降低优化等级以保证稳定

## 七、建议操作

- 遇到问题先查看 Gentoo Handbook 或 Wiki  
- 养成备份和快照习惯，降低安装风险  
- 遇到网络或编译问题，多尝试镜像源和清理缓存