Gentoo Linux 安装及使用指南

有线

1. 网络环境带 DHCP 服务的（比如家用路由器连接的），livecd 默认会运行 dhcpcd 服务，不出意外，进入环境后直接可以联网。可通过下述的 ping 测试 判断。

2. 网络环境无 DHCP 服务或 DHCP 无效需要手动配置网络的，需要知道网关 IP，可用的网络地址，然后执行如下命令：

   # 先列出到当前使用的网卡
   ip link
   # 有线网卡的格式一般为 enpXsX, X 是一个数字
   # 假设这里看到了正在使用的网卡为 enp5s0
   ip link set dev enp5s0 up # 确保其开启
   # 这里假设　网关地址为： 10.0.1.1
   # 　　　可用网络地址为： 10.0.1.2
   # 　　　　　子网掩码为： 255.255.255.0 （即 CIDR 符号为 /24）
   ip address add 10.0.1.2/24 dev enp5s0
   ip route add default via 10.0.1.1 dev enp5s0
   # 这样就配置好了网卡的 IP 和默认路由
   # 未假设的内容即为固定参数，无需变动
   

3. 拨号网络，执行 pppoe-setup 根据提示配置好对应的值后，执行 pppoe-start 进行连接。

4. 若仅存在 IPv6 环境，那么默认进入安装环境后，会直接进行路由协商获取可用的 IPv6 地址。如若无效，同样使用 ip 命令自行配置（正常无需配置路由；因环境所限，没有更多 IPv6 环境测试，便不再说明）。

无线

• 确定无线网卡设备，使用 iw dev 进行查询， Interface 后显示的即为无线网卡名，这里以 wlpXsX 代替

• 确保清楚无线网络的 SSID（即无线网络名称），若不知，可以执行如下命令获取当前能检测到的所有 SSID：

  iw dev wlpXsX scan | grep SSID
  # 其它信息可自行尝试
  

• 确保无线网卡设备开启

  ip link set wlpXsX up
  

然后开始连接到无线网络：

1. 无认证的无线网络，执行如下命令连接

   iw dev wlpXsX connect -w 「SSID」
   

2. WEP 认证的无线网络，执行如下命令连接

   # 假设密码为 mypass
   iw dev wlpXsX connect -w 「SSID」 key 0:mypass
   # 若密码是十六进制的，比如为 6162636465，则
   iw dev wlpXsX connect -w 「SSID」 key d:0:6162636465
   

3. WPA/WPA2/WPA3 认证的无线网络（如今常用的认证方式），执行如下命令连接

   wpa_supplicant -i wlpXsX -c <(wpa_passphrase 「SSID」 「密码」)
   

认证通过连接上无线网络后，再采取和有线一样的方式进行联网配置，一般会直接由 DHCP 服务器给本机分配上 IP，如果没有，参考有线配置段落，将有线网卡替换为对应无线网卡即可。

DNS 及测试

执行

cat /etc/resolv.conf

查看 DNS 配置信息，通常使用 DHCP 配置的网络会自动获取到 DNS 地址后配置，如若没有，请执行

echo 'nameserver 223.5.5.5' >/etc/resolv.conf

写入 DNS 配置，这里我选用的阿里云的公共 DNS 地址，也可以改成其它的。

再执行

ping -c3 baidu.com
# IPv6 使用 ping -6 -c3

查看返回信息，输出如下类似信息及联网成功

PING baidu.com (220.181.38.251) 56(84) bytes of data.
64 bytes from 220.181.38.251 (220.181.38.251): icmp_seq=1 ttl=53 time=28.5 ms
64 bytes from 220.181.38.251 (220.181.38.251): icmp_seq=2 ttl=53 time=30.4 ms
64 bytes from 220.181.38.251 (220.181.38.251): icmp_seq=3 ttl=53 time=29.6 ms

--- baidu.com ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2003ms
rtt min/avg/max/mdev = 28.509/29.519/30.413/0.781 ms

如果长时间得不到响应或者直接显示失败，再自查网络配置或寻求帮助。

安装

这里区分为两种情况：

1. BIOS 启动，执行

   grub-install --target=i386-pc /dev/sdX
   

   显示无报错即安装完成。

2. UEFI 启动，执行

   grub-install --target=x86_64-efi --efi-directory=/boot/efi/ --bootloader-id=Gentoo
   

   显示无报错即安装完成。

配置

执行

# （可选）如果之前有分配交换分区，在这里可以执行如下命令以启用其休眠后唤醒的功能
sed -Ei "/GRUB_CMDLINE_LINUX_DEFAULT/s/^#*(GRUB.*DEFAULT=).*$/\1\"resume=UUID=$(blkid -o value /dev/sdX4 | head -1)\"/" /etc/default/grub
# 也可以手动修改，打开 /etc/default/grub 文件
# 　　　找到 GRUB_CMDLINE_LINUX_DEFAULT 变量
# 　　　去掉其注释标记 (#) 后
# 　　　在其双引号内添加上内容：
# 　　　　　　　resume=UUID=<UUID 值>
# 　　　此 <UUID 值> 可由命令 blkid -o value /dev/sdX4 | head -1 显示

# （必要）创建配置
grub-mkconfig -o /boot/grub/grub.cfg

以完成引导的配置，该命令会自动根据 /etc/fstab 以及 /etc/default/grub 的内容来生成所需要的引导配置。

自此，一个基本的可以启动的系统安装完成。但还需要进行一些基本的收尾工作。

配置时区

这里假设设置为国内时区，执行

# 通用操作
# 将时区信息写入指定文件
echo 'Asia/Shanghai' >/etc/timezone
# 删除旧的常规文件以避免警告
rm /etc/localtime
# 更新时区信息
emerge --config sys-libs/timezone-data

# systemd 用户可选的替换操作
#timedatectl set-timezone Asia/Shanghai

如果你需要添加其它的时区，对应的时区名字可以在 /usr/share/zoneinfo/ 目录下找到，将其替换到 Asia/Shanghai 的位置后执行命令即可。

语言环境

准备系统语言环境。对于 root 用户而言，一般使用默认的配置即可。但这里需要添加上自己所需其它语言设置以供普通用户使用。

使用编辑器打开 /etc/locale.gen 文件，在里面添加上你需要的语言环境配置，说明如下：

# 这个配置是默认存在的，不用去修改它
C.UTF8 UTF-8
# 空格前代表该语言环境的名字，后代表选择的编码
# 在这里，C 是一个为计算机适配的语言环境，英文，兼容性强，root 用户下推荐使用它

# 下面是推荐添加的语言环境

# 生活在中国则添加
zh_CN.UTF-8 UTF-8

# 若 生活在其它国家
# 　 或需要其它国家对应的 数字、货币、日期等表示格式，
# 则添加对应国家的语言环境配置
# 配置格式为 <语言>_<国家代码>[@可选的变体].<编码> <编码>
# 其中，
# 　　<语言>_<国家代码>[@可选的变体] 可以在 /usr/share/i18n/locales/ 文件夹下找到
# 　　而支持的 <编码> 可以在 /usr/share/i18n/charmaps/ 文件夹下找到
# 　　编码一般只推荐使用 UTF-8，除非有明确的其它需求

当添加了其它语言环境配置后，执行

locale-gen

该命令会根据 /etc/locale.gen 下配置的内容，生成所需语言环境列表。

时间同步

为保证时间的精准，

1. 启用对网络的时间同步服务。这里我推荐使用 net-misc/chrony 这个同步软件，执行

   # 安装
   emerge -vj net-misc/chrony
   
   # 配置 chrony 以 UTC 对待硬件时钟
   echo $'\n'rtconutc >>/etc/chrony/chrony.conf
   

   安装完成后，执行

   # openrc 用户
   rc-service chronyd start
   rc-update add chronyd default
   
   # systemd 用户
   systemctl --now enable chronyd
   

   启动服务并开机启动。

2. 确保与硬件时钟的同步。即在系统启动时将硬件时钟同步到系统时间，并在关闭系统时（或运行过程中定时）将系统时间同步回硬件时钟。

   （此节略显繁琐，如果你初入 Linux ，对此节略感迷惑，可以跳过，不影响大局）

   （如果你永不断互联网，那忽略这一节也可以）

   在 openrc 下，会有一个默认启用的名为 hwclock 的服务负责此功能。

   在 systemd 下却没有默认的服务用于将系统时间自动同步回硬件时钟。

   而自 3.8 及以上版本的 Linux 内核开始，可以配置交由内核来全权负责此功能。

   判断当前内核是否开启了对应功能，可以通过如下命令进行验证，执行

   zgrep 'CONFIG_RTC_[H|S]' /proc/config.gz
   

   当输出内容存在

   CONFIG_RTC_HCTOSYS=y
   CONFIG_RTC_HCTOSYS_DEVICE="rtc0"
   

   表示开启了在启动或恢复系统时从硬件时钟同步时间的功能。

   当输出内容存在

   CONFIG_RTC_SYSTOHC=y
   CONFIG_RTC_SYSTOHC_DEVICE="rtc0"
   

   表示开启了通过 NTP 同步将系统时间每隔约 11 分钟同步到硬件时钟的功能。没错，这个需要 NTP（即上述的时间同步服务）来辅助，chrony 默认配置已经支持。

   当输出的内容存在被注释的情况（行首有一个 # ）则代表对应功能未开启。

   systemd 用户

   确保以上两个功能均开启即可跳过。

   若未开启，那么此时有两个选择：

   一、 安装测试版内核，执行

   # 添加基于本机架构的测试用关键字以解除测试版软件的安装屏蔽
   echo 'virtual/dist-kernel' >>/etc/portage/package.accept_keywords
   echo 'sys-kernel/gentoo-kernel-bin' >>/etc/portage/package.accept_keywords
   
   # 更新到测试版二进制内核
   emerge -vuj gentoo-kernel-bin
   
   # 更新 Grub 引导信息
   grub-mkconfig -o /boot/grub/grub.cfg
   
   # 重启系统
   reboot
   

   后再次判断功能是否已经完整开启。若依旧未，说明包维护人员再次改动了默认配置，此时只能选择自行配置内核。

   二、 自行配置内核，请参考下文 内核配置 章节，若遇问题建议寻求帮助。

   这里略作说明，可以在内核源码目录下，执行 make menuconfig 进入菜单配置界面，确认开启如下选单下的选项:

   Device Drivers  --->
     [*] Real Time Clock  --->
       [*]   Set system time from RTC on startup and resume
       (rtc0)  RTC used to set the system time
       [*]   Set the RTC time based on NTP synchronization
       (rtc0)  RTC used to synchronize NTP adjustment
       ...
       [*]   /sys/class/rtc/rtcN (sysfs)
       [*]   /proc/driver/rtc (procfs for rtc0)
       [*]   /dev/rtcN (character devices)
       ...
       <*>   PC-style 'CMOS'
       ...

   后保存退出，编译并安装内核，最后更新引导重启。

   openrc 用户

   无论什么内核什么配置，openrc 默认都会有完好的与硬件时钟的同步功能。

   但，当完整地将同步功能交给内核后 （根据上文进行判断），建议关闭其自带的同步服务，执行

   #!!! 以下内容判断后操作
   
   # 删除 hwclock 开机启动
   rc-update delete hwclock boot
   
   # 添加一个空的时钟服务以满足其它服务的要求
   rc-update add osclock boot
   

   到此时，时间同步配置完毕。

Portage 配置

Portage 是 Gentoo Linux 默认的包管理器，用于更新系统，安装各种所需软件。

Gentoo Linux 上绝大部分的软件是自行从源码编译安装而来的，所以编译过程中的一些参数也可以自由调节，这里说明几个基础配置。

# 这是一组推荐的设置
# '#' 后内容代表注释

COMMON_FLAGS="-march=native -O2 -pipe"
# 这不是一个 portage 可以识别的变量，只是方便给其它变量赋值
# 说明：
#   -march=native, -march 用于指定编译目标架构
#                  native 用于自动识别当前的 CPU 架构，它并不是一个最终参数，但方便可用
#             -O2,     -O 用于指定编译优化等级，
#                       2 是当前推荐的优化等级，它隐性地开启了一系列 flags
#                         具体参阅： https://gcc.gnu.org/onlinedocs/gcc/Optimize-Options.html#Optimize-Options
#                         　　以及： https://wiki.gentoo.org/wiki/GCC_optimization#-O
#                         　　以及： https://stackoverflow.com/questions/15548023/clang-optimization-levels
#           -pipe, 这个标记对代码本身不会产生影响，它能加速编译过程但会消耗更多的内存
#                  内存充足情况下建议使用，否则去掉该标记

CFLAGS="${COMMON_FLAGS}"   # 传递给 C 编译器的变量，这里将上面统一设置的值给了 CFLAGS，下同
CXXFLAGS="${COMMON_FLAGS}" # 传递给 C++ 编译器的变量
FCFLAGS="${COMMON_FLAGS}"  # 传递给现代化编译系统下的 FORTRAN 编译器的变量
FFLAGS="${COMMON_FLAGS}"   # 传递给 FORTRAN 77 编译器的变量
# 可以根据实际需要添加/修改，并传递给编译器

#MAKEOPTS="-j16"
# 这是用来告知编译器同时执行任务数的变量（这里演示设置了 16 个并行任务数）
# 通常设置为总线程数（会在编译一些大任务时占满 CPU 时间）
# 当 CPU 线程够多（>=24）的时候，推荐可以小于总线程 1-2 个任务
# 当 CPU 线程够多，但内存不足时，推荐设置为更小值
# 　     　　　　　　　　　　　　Gentoo Wiki 推荐取「内存大小/2G」与「CPU 线程数」中的较小者
# 　     　　　　　　　　　　　　但就我个人使用情况经验来说，要看 CPU 线程数多少，
# 　     　　　　　　　　　　　　　　　　　　　　　　　　　　大于 10 线程我就建议替换上述比较为：
# 　     　　　　　　　　　　　　　　　　　　　　　　　　　　「内存大小/1G」与「CPU 线程数」中的较小者，
# 　     　　　　　　　　　　　　　　　　　　　　　　　　　　然后再根据日常使用情况进行调整。
# 请自行配置后删除注释符
# 如果变量未进行设置
# 那么 portage 会根据当前 CPU 的线程数自动赋予一个值
# 该自动值等于当前 CPU 线程数

X? Wayland?

无论选择安装哪种环境，都需要显示服务器作为依托。而现今 Linux 下主流的显示服务器有两种， X Window System 以及 Wayland。

简单比较（2023 年，十月）：

X Window System

它是最早开发的也是现如今依旧能稳定使用的，至近两年前，基本所有的图形化软件都是针对其开发的，扩展性强，兼容性好；但各窗口间无隔离，安全性较差。

Wayland

它是一个协议，实现该协议的显示服务器（也叫 Wayland 混成）有多种，目前大部分软件对 Wayland 的支持已经较为成熟；它性能比 X 更好，窗口有隔离安全性也更好。

现如今（2023 年，十月）， Wayland 已经可以替代 X 作为日用。

显卡驱动

在之前安装 Gentoo Linux 的过程中，二进制内核本身已自带了大多数显卡的内核驱动部分，该部分负责接收用户空间发送的指令及数据，进行处理后传递给显卡。

对于 X 而言，它还需要配置对应的 2D 驱动，这里以现代化的 A 卡为例，编辑 /etc/portage/make.conf 文件，添加以下内容：

VIDEO_CARDS="amdgpu radeonsi"
# 其中，
# 　　amdgpu radeonsi 用于给 X 开启 2D 驱动（X 下必须）
# 　　radeonsi 用于给 OpenGL 的实现 mesa 开启对内核下 amdgpu 驱动的支持（无论 X 还是 Wayland 均需配置）
# 如果 A 卡比较老，则额外添加 radeon 值，详细查阅： https://wiki.gentoo.org/wiki/AMDGPU
# Intel 的一般设为 intel i965 iris， 详细查阅： https://wiki.gentoo.org/wiki/Intel
# N 卡开源驱动一般设为 nouveau， 详细查阅： https://wiki.gentoo.org/wiki/Nouveau
# 虚拟机下的驱动设置得具体看，比如现在的 VirtualBox 和 VMWare 都用 vmware 驱动，
# 　　　　　　　　　　　　　　那么就设置值为 vmware
# 　　　　　　　　　　　　　　再比如 QEMU 可选使用 virgl 驱动，那么就设置为 virgl
# 　　　　　　　　　　　　　　等等，请自行查阅相关资料

在这里，还需将之前配置的普通用户添加到 video 组下以使用硬件加速功能。执行

groupmod -a video -U 「用户名」

切换 Profile

在安装心仪的 DE/WM 之前，建议切换到的 desktop profile 下，执行

eselect profile list
# 以列出所有的 profiles
# 然后进行选择
# 例如：
# 　　　openrc 下，可以选择 amd64/23.0/desktop
# 　　　       　　　　　　 amd64/23.0/desktop/gnome
# 　　　       　　　　　　 amd64/23.0/desktop/plasma
# 　　　       　　　　　　 等
# 　　　systemd 下，可以选择 amd64/23.0/desktop/systemd
# 　　　        　　　　　　 amd64/23.0/desktop/gnome/systemd
# 　　　        　　　　　　 amd64/23.0/desktop/plasma/systemd
# 　　　        　　　　　　 等

# 如若只想安装轻量级的窗口管理器，那么可以选择类似 amd64/23.0/desktop 一样的纯 desktop profile
#eselect profile set 23

# 根据本文上下文环境，这里我选择 amd64/23.0/desktop/plasma 以准备好 KDE Plasma 的前期环境
# 随着时间的推移，序号可能会不同，请根据需要选择
eselect profile set 27

且，虽然 desktop profile 下已经配置启动了基本的 ALSA 声音接口功能，但一般建议再启用 pulseaudio USE 以获得更多功能（通过 libpulse 库）。只需编辑 /etc/portage/make.conf 文件，设置

USE="pulseaudio"

安装 DE/WM

此处以安装 KDE Plasma 为例，

先更新一下当前的 Portage 数据库，使其为最新，执行

emerge --sync
# 如果你使用的是 rsync 同步方式，那么同步开始时可能会卡在
#   Refershing keys from WKD ...
# 发生这种情况是网络不通畅导致的，请等待， Portage 需要先更新它的校验公钥

在准备完上述的准备工作后，执行以下命令，开始安装过程：

# 如需添加 Wayland 支持，请在 /etc/portage/make.conf 下的 USE 变量中加上 wayland

# 执行此命令将 plasma-meta 这个元包添加到 world set 中，关于 world set 后文使用 Portage 一节有指引
emerge -Ow kde-plasma/plasma-meta

# 处理下桌面环境下的依赖关系
echo "media-libs/freetype harfbuzz" >>/etc/portage/package.use/desktop
# （随着时间的推移，可能后续会有其它依赖关系问题，若出现，可使用本文开头的邮件列表以寻求帮助）

# 先安装一个 rust-bin 以避免待会儿依赖安装需要编译的 rust
# （因为完整编译 rust 会很久，除明确需要外没太大必要）
emerge -vj1 dev-lang/rust-bin

# 再整体更新一下整个系统
emerge -ajvuDN --keep-going @world
# 等待依赖计算完成后按回车以开始更新

此过程会比较漫长，由具体机器的性能而定。万一更新过程中失败，有可能为

1. 偶然问题，尝试对出问题软件包单独安装，使用命令 emerge -vj1 <包名> 进行；成功后再次运行上述更新命令

2. 因为内存太低导致的，尝试去除上述命令选项中的 j 重新更新

3. 其它问题，请查看提醒的相应编译日志，如不能解决，可使用文章开头邮件列表以寻求帮助

上述安装完毕后，可选安装 KDE Plasma 的应用元包，执行

# 这是一个可选命令，它会引入 KDE 应用
# 个人建议没必要使用默认设置来安装 kde-apps/kde-apps-meta 包，
# 因为会引入太多不常用的应用
# 建议根据 USE 来管理（下文 USE 标记一节有说明），选择性安装，即
echo 'kde-apps/kde-apps-meta -*' >/etc/portage/package.use/kdeapps
# 同时取消 kdecore-meta 的 webengine 依赖，以减少当下的编译时间
echo 'kde-apps/kdecore-meta -webengine' >>/etc/portage/package.use/kdeapps
# 以安装最核心的 KDE 应用
emerge -vj kde-apps/kde-apps-meta
# 其它 KDE 应用根据需要安装即可

配置 DM 启动

到此时，用于启动桌面环境的必要组件都安装完毕了，接下来需要配置 DM 的开机启动，并启动它

openrc 下

先编辑 /etc/conf.d/display-manager ，设置

DISPLAYMANAGER="sddm"
# 这样就设置了 sddm 作为默认的 DM，如果你安装了别的 DM，那么根据提示做对应设置

然后执行

rc-update add display-manager default
# 设置其默认开机启动

rc-update add dbus default
# openrc 下请也同时设置 dbus 的开机启动
# 若不设置，虽然 display-manager 也会启动它，但有时候会出现奇怪的问题，原因我还未查明

# 以下步骤等待下次重启后会自动执行
rc-service dbus start
# 先启动 dbus
rc-service display-manager start
# 再启动 DM

systemd 下

则直接执行

systemctl --now enable sddm.service
# 以启用，如果是其它的 DM 也是启用对应的服务即可。

之后，确保 DM 界面选定了所需的 Plasma Session，再选择对应的普通用户，输入密码后登陆。

动画过渡后，就进入了人性化的桌面环境。

必要的桌面应用

以下操作需要在桌面的终端或者 TTY 下，以 root 权限进行。

如果是在桌面终端的话，打开终端后，执行 su - 或其它等同命令进入 root 用户下；如果之前安装并配置了 app-admin/sudo 工具，那么也可以以普通用户在下述的每一条命令前添加上 sudo「空格」 后执行。

emerge -vj media-fonts/noto-cjk

# 这里示例一种尽可能全的方式

# 先配置下 fcitx-gtk:5 开启对 gtk2 的支持以避免有些程序无法使用（gtk3/4 默认开启了）
echo 'app-i18n/fcitx-gtk:5 gtk2' >>/etc/portage/package.use/fcitx

# 然后安装输入法框架主体
emerge -vj app-i18n/fcitx:5 app-i18n/fcitx-configtool:5 app-i18n/fcitx-qt:5 app-i18n/fcitx-gtk:5
# 其中， app-i18n/fcitx:5 是 fcitx 的主程序
# 　　　 app-i18n/fcitx-configtool:5 是它的配置工具
# 　　　 app-i18n/fcitx-qt:5 用于支持在 qt 程序上使用它
# 　　　 app-i18n/fcitx-gtk:5 用于支持在 gtk 程序上使用它

# 最后选择一个你需要的输入法，比如 RIME 或者 其他存在于 Chinese-addons 里面的
# 这里以安装 RIME 为例
emerge -vj app-i18n/fcitx-rime:5
# 之后等待安装完成即可。
# 如果不需要 rime，则可以考虑安装 app-i18n/fcitx-chinese-addons:5 这个包。

export XMODIFIERS="@im=fcitx"
export QT_IM_MODULE=fcitx
export GTK_IM_MODULE=fcitx
export SDL_IM_MODULE=fcitx

# 注意缩进
patch:
  switches:
    - name: ascii_mode
      reset: 0
      states: [ 中文, 西文 ]
    - name: full_shape
      states: [ 半角, 全角 ]
    - name: simplification
      reset: 1
      states: [ 漢字, 汉字 ]

emerge 常用选项

先解释上述基础命令中的选项，其中

• -C, -c, --deselect, --info, -r, -s, --sync 都是执行的对应操作，不属于选项

• -D 表示检查包的整个依赖树

• -N 表示检查 USE 的任何改动

• -a 代表询问以确认执行该操作

• -u 表示升级，略过不升级的包

• -v 表示显示详细信息

其它常用的选项有

• -1/--oneshot 一般用在安装软件包时，不将该包添加到 world 集中

• -O/--nodeps 不计算依赖关系，只操作指定的包（安装时可能会因为依赖不满足而导致安装失败）

• -f/--fetchonly 仅下载指定包及其依赖的 distfiles 而不进行安装

• -j/--jobs 设置 Portage 同时执行的最大任务数，如果未设置数量，那么 Portage 不会限制最大的任务数

• --keep-going 它会在安装出错时，跳过安装失败的包，并重新计算依赖后继续安装剩余包

• -n/--noreplace 不重复安装已经安装的包（默认会忽略掉 USE 的改动以及升级的查询，除非对应加上 -D/-U 和 -u 选项）

• -p/--pretend 假装进行该操作（实际不进行），一般只计算依赖关系，也可用于非特权用户查询信息用

• -t/--tree 显示给定包的安装依赖树

USE 标记

USE 标记是 Portage 系统的一个核心功能，很多包都会有可选的 USE 标记，正如上文有地方会写入到 package.use 文件夹下的内容。Portage 使用它来管理每个包的功能，是一个很重要的特性。

在日常使用过程中，也会发现包与包之间关于对 USE 标记的依赖问题，比如当一个包 A 依赖另一个包 B 的 USE 非默认时，会出现无法安装的问题，此时需要对 B 包配置其 USE 标记。

USE 的配置可以分为全局的和局部的：

全局配置

自定义的全局配置可以编辑 /etc/portage/make.conf 文件下的 USE 变量，这个变量是一个增量型的，它会与默认的 /usr/share/portage/config/make.globals 文件下的 USE 配置，以及选定的 profile 下的 USE 配置组合，可以使用如下命令查看当前应用的全局 USE 标记：

emerge --info | grep '^USE'

全局的 USE 会应用给当前系统下支持该 USE 的所有包，谨慎配置。

局部配置

自定义的局部配置则编辑 /etc/portage/package.use 文件，如果这个路径是一个文件夹，那么编辑该文件夹下的任意文件即可，一般建议使用文件夹来进行管理。

其配置格式为

# 注释
<类>/<名> <USE>

# 亦可指定版本，比如对 21.04.3 及以上版本的 kde-apps-meta 进行配置
>=kde-apps/kde-apps-meta-21.04.3 -* admin
# USE 标记前加 - 代表去掉这个 USE，
# 上述 -* 代表去除该匹配的包的所有已经添加的以及默认的 USE
# 然后再启用 admin 这个 USE 标记

Portage 有一个 USE Expand 功能，即把指定变量的值扩展成 USE，这些指定的变量被设置在 Portage 数据库路径下的 profiles/base/make.defaults 文件的 USE_EXPAND 变量中。这个功能很实用，简化了配置值，还能进行归类，更便于管理。上文有一个 显卡的配置 其实就是一个 USE_EXPAND 值。其它会使用到它的地方不多，但也有，比如：

# 配置全局的本地化配置，就可以在 make.conf 文件下配置
L10N="zh-CN zh-TW zh en-GB-oxendict en"
# 这样，那么以后当有包支持上述的本地化配置时，就会自动添加

# 其它比如可以对 qemu 这个虚拟机添加额外的模拟平台，
# 可以往 /etc/portage/package.use/qemu 文件写
# app-emulation/qemu QEMU_SOFTMMU_TARGETS: aarch x86_64
# 以支持 arm64 及 x86_64 平台。等等

关键字

ACCEPT_KEYWORDS 这个是一个针对 CPU 架构及软件的稳定/测试分支的变量。 在上文我有写到 为何不建议全局 ~amd64 关键字，这里详细说明这个变量。

Portage 会默认启用针对当前 CPU 架构的关键字，即： AMD64(x86_64) 架构，默认启用 amd64 关键字； ARM64(AArch64) 默认启用 arm64 关键字，以此类推。

这个关键字是用于判断软件包稳定性的，软件的维护者会在维护软件（维护 ebuild）时，对该软件设定好对应架构的稳定程度，当该软件设定好的关键字在系统下未被接受时，该软件将无法被安装。

上述默认启用的关键字是一个稳定关键字，这里以 arch 来表示，而还有一个测试关键字 ~arch ，即在稳定关键字前加一个 ~ 符号。

默认情况下，系统都会接受当前架构的稳定关键字，你可以根据需要添加或者删除所需的关键字。

自定义 ACCEPT_KEYWORDS 变量同样分为全局和局部，全局配置依旧在 /etc/portage/make.conf 文件内。

可以按包进行局部配置则是在 /etc/portage/package.accept_keywords 文件，它和 package.use 一样，如果路径为文件夹，那么将配置写入该文件夹下的任意文件内即可。格式如下：

# 注释
<类>/<名> [可选的关键字配置]
# 当只指定了包，却未添加任何关键字时
# 　　　　　　　默认添加当前架构的测试关键字：~arch，
# 　　　　　　　比如 amd64 平台则默认添加 ~amd64
# 这里存在一种情况，当软件未设置任何关键字时，
# 　　　　　　　　　这种情况一般出现在实时（live）包上（版本号通常以 9999 结尾的）
# 　　　　　　　　　那么为了安装此包，需为其设置标记 **
# 　　　　　　　　　代表忽略关键字检查
# 　　　　　　比如欲安装实时的 app-editors/vim 包，则配置
# 　　　　　　　　　app-editors/vim **

# 亦可指定版本，比如对 21.04.3 及以上版本的 kde-apps-meta 进行配置
#>=kde-apps/kde-apps-meta-21.04.3

无论是全局配置还是局部配置，其都是一个增量值，如需去掉所有之前配置的关键字，同样使用 - 符号。

软件的许可

Portage 下的软件包很多，每个包所使用的许可也不尽相同。默认情况下，基础的 profile 配置已经接受了各种自由许可，使得安装自由软件不再需要额外的许可步骤。

而一些私有软件，所使用的许可默认是不接受的，于是安装他们的时候会出现无法安装的情况，这时候有两个方式来解决。

一是全局配置接受所有许可，这个方法一劳永逸，以后再也不会提示因为许可而导致的软件无法安装，方法是在 /etc/portage/make.conf 文件内添加

ACCEPT_LICENSE="*"

另一个则是当每次出现许可问题时，单独添加该软件的许可到 /etc/portage/package.license 文件内，或者该文件夹下的任意文件内（许可名会在出现问题时提醒）。格式为

# 注释
<类>/<名> <许可名称>

# 亦可指定版本，比如对 20210818 及以上版本的 sys-kernel/linux-firmware 进行配置
#>=sys-kernel/linux-firmware-20210818 linux-fw-redistributable no-source-code

请根据自己的喜好，自行选择。

emerge 默认选项

emerge 支持配置一组默认选项，用于在每次运行 emerge 时采用。这个储存默认选项的变量名为 EMERGE_DEFAULT_OPTS ，在 make.conf 文件下设置。

常见设置的默认选项有

-v/--verbose

显示详细信息

--keep-going

上文已交代

-j/--jobs

上文已交代，这里作补充。如果要将该选项添加到默认选项下，那么建议配合 -l/--load-average 使用， -l/--load-average 用于配置 emerge 的负载阈值，当当前负载到达设定值后， emerge 将不再开启新任务，以避免负载过高，这在 CPU 不够强悍或者内存不宽裕的机器上很需要。比如在一个 8 核 16 线程 16G 内存的机器上，可以设置成 -j -l 12 ，这样的设定使 portage 的并行任务数不由硬性规定的数目来限制，而是通过动态负载来进行限制。

--autounmask 类

这是一组在新装软件包时便于解除安装限制的选项。之前有介绍，在 Portage 安装软件的过程中，可能会因为 USE/License/Keywords 等因素导致无法直接安装，需要配置后再进行，而这组选项可以自动化这个过程。个人建议的相关选项组合为 --autounmask --autounmask-keep-masks --autounmask-write=n ，此组合不会完全自动写入配置到系统下，但是提示了如何配置，方便手动写入，既简化了处理限制的流程，又能保证掌握每次安装包时的改动。

那么这里一组比较推荐的默认选项配置为

EMERGE_DEFAULT_OPTS="--autounmask --autounmask-keep-masks --autounmask-write=n -j -l 12 --keep-going -v"
# 其中的 12 请根据实际情况修改
# 如果配置了上文的 binhost ，那么对应选项也添加进入。
# 设置默认 -v 选项会导致 emerge -ac 时输出额外非必要信息，不喜可取消默认 -v 选项

其它的选项请自行发现。

Portage 的内容太多，以上仅列出了几个经常会使用到的配置。更多内容，请通过执行 man portage , man emerge , man make.conf 查询，或者访问 Gentoo Linux 官方维基。

关于配置文件的更新

有时候在更新了某些软件包后你会发现出现了一个类似如下的提示信息：

* IMPORTANT: 2 config files in '/etc' need updating.
* See the CONFIGURATION FILES and CONFIGURATION FILES UPDATE TOOLS
* sections of the emerge man page to learn how to update config files.

正如提示所说，完全可以自行查阅手册获取帮助，这里简单说明一下。

一般出现这种情况的直接原因是你通过归属于一个软件包的文件修改了其默认配置，导致新安装的文件与现存文件不符，于是 Portage 出于保护现存文件的目的，将新文件重命名为了对应目录下的 ._cfgxxxx_<原名> 文件，这是一个很常见的情况。

而每当出现这种情况后，需要做的操作就是人工介入，判断一下保留哪个文件，还是将两个文件合并。而自带用于进行此操作的对应命令有 dispatch-conf 与 etc-update 。

以 dispatch-conf 为例，root 权限下执行后，它会逐个文件列出改动，然后提示你进行操作，比如按 z 保留旧的配置文件，按 u 使用新安装的配置文件替换旧的，等等。

常用工具

单纯 Portage 自带的工具对于日常管理其会显得有些吃力，这里推荐几个比较有用的软件用于辅助管理 Portage。

app-portage/eix

这个可以说是非常有用的软件，主要用于查询 Portage 数据库，其优势在于更快的速度、更人性化的显示格式以及更方便的查询模式。

使用前需执行 eix-update 以更新 eix 数据库，安装它之后，可以使用 eix-sync 命令来更新 Portage 数据库，更新完毕后会自动更新 eix 数据库，并显示更新前后的软件包对比情况。

使用 eix 查询所需软件，最基本的命令为

eix <包名匹配字符串>

# 也可只查询已安装的包
eix -I <包名匹配字符串>

# 也可查询属于一个特定分类下的所有包
eix -C <类名>

等等，执行 man eix 查看更多用法。

app-portage/gentoolkit

包含了 Gentoo 的一些管理脚本，常用的命令有用于查询依赖关系，文件归属，软件包内容的 equery ，以及用于清理 distfile 的 eclean-dist 。比如

equery d vim-core
# 可以查询依赖 vim-core 的软件包（仅根据 ebuild 文件内容查询）

equery g vim
# 可以查询 vim 下属的依赖关系图

equery f vim
# 可以查询 vim 安装了哪些文件到系统下

equery b /usr/bin/vim
# 可以查询这个文件属于哪个包

eclean-dist -d
# 可以清理未安装在系统下的 distfile 文件

等等，请自行发现。

app-portage/portage-utils

包含了 Portage 的帮助工具，与上面 gentoolkit 的功能有重合，他们具有互补性，常用的命令有用于分析 emerge 日志的 qlop 。它是用 C 写的，速度更快。

app-portage/pfl

Portage File List，可用于在线查询文件所归属的包，命令为 e-file <文件名> 。

多版本管理

Gentoo Linux 支持同一软件多版本同时存在于系统上，这归功于 Portage 系统的 slotting 机制。当你执行命令 eix dev-lang/python 会发现它有好多行可用版本，最前圆括号内的内容即对应的 slot 名，不同 slot 下的版本可同时安装到系统上（ slot 名内 / 符号后的内容表示其 sub-slot，同 slot 但不同 sub-slot 的版本无法共存）。比如，sys-devel/gcc , sys-devel/clang , dev-lang/lua 等等都支持多版本共存。

对于一些多版本共存的工具， Gentoo Linux 准备了对应的 eselect 命令以方便用户选择使用。其会在对应的 $PATH 目录下创建一个指向当前选定版本命令的软链接。比如，

eselect lua list
# 列出当前所有已经安装的 lua 版本

eselect lua set {序号}
# 这样就设定了系统下用户交互环境的默认 lua 版本

其它的类似，执行 eselect help 以查看当前所有支持的模块。不是所有的多版本共存的包都会有 eselect 模块，它们并不存在强制的依赖关系。执行 eix -I2 可以显示当前系统下安装的可多版本共存的包。

Proxy

并不是所有的 distfile 都能从镜像站下载，当遇到 distfile 下载不下来（或者 git 仓库克隆不下来）需要使用代理的时候，如何为 Portage 正确地配置 Proxy 呢。关于这个问题，我之前有一篇文章详细谈到了： https://bitbili.net/set-proxy-for-gentoo-portage.html

至此， Gentoo Linux 所特有的用法（除内核外）大致说明完毕。