apt-cache policy 怎么看软件包候选版本和 Pin 优先级

在 Debian 或 Ubuntu 上，同一个软件包可能同时出现在多个发行版、仓库或本地索引里。此时“哪个版本会被选中”不能只看版本号，应该先读 APT 的候选版本和优先级：

# 只查询包缓存，不改变已安装的软件状态
apt-cache policy nginx

官方资料：https://manpages.debian.org/bookworm/apt/apt-cache.8.en.html

先看 Candidate，再在下方的版本表里找到同一个版本号。它旁边的优先级和来源记录，才是解释“为什么选它”的关键。本文只讲读取和判断，不展开修改软件源配置。

先用 policy 读出候选选择的四个字段

apt-cache policy 包名 带包名时会输出这个包的详细优先级选择信息。实际阅读时，可以把它压缩成四个问题：现在装了什么、默认准备选什么、有哪些版本记录、每条记录的优先级是多少。

nginx:
  Installed: 1.24.0-2
  Candidate: 1.24.0-3
  Version table:
 *** 1.24.0-2 100
        100 /var/lib/dpkg/status
     1.24.0-3 500
        500 http://deb.debian.org/debian bookworm/main amd64 Packages

这是字段关系示意，不是某台机器的真实输出。Installed 表示已经安装的版本，未安装时可能是 (none)；Candidate 表示没有显式指定版本时 APT 当前优先考虑的版本。版本表中的数字是优先级，下面的路径或仓库记录说明这条版本信息来自哪里。

Candidate 要和同版本的记录配对

判断候选来源时，不要只盯着 Candidate 一行。比如候选是 1.24.0-3，就向下寻找版本表中完全相同的 1.24.0-3，再读取它下面的仓库地址、发行版标签、架构和优先级。

同一个软件包可能列出多个版本。仓库地址出现过，只能说明本地索引里有这条记录，不能单独证明它就是候选。真正的判断链是：Candidate 的版本号 → 同版本记录 → 该记录的优先级与来源。

# 查询指定包的候选版本和全部版本记录
apt-cache policy nginx

# 先刷新本地索引，再重新读取同一个包的候选信息
sudo apt-get update
apt-cache policy nginx

APT 手册说明，包元数据由 apt update 等命令获取；索引过久未更新时，apt-cache 看到的候选可能已经过期。刷新索引属于环境维护动作，policy 本身仍然只是查询。

Pin-Priority 为什么会改变候选版本

APT preferences 文件可以给包版本分配优先级。没有显式 pin 时，已安装版本通常是 100，未安装版本通常是 500；指定 target release 时，目标发行版版本的默认优先级可以是 990。这些数值不是“版本新旧分数”，而是参与选择的策略值。

在候选版本选择上，APT 先比较优先级；优先级相同，再比较版本号。高于 1000 的设置尤其要谨慎，因为它可能让较旧的版本压过已安装版本。

Package: nginx
Pin: version 1.24.*
Pin-Priority: 900

上面只是 preferences 记录的结构示意，不是建议直接复制的生产配置。用 apt-cache policy nginx 观察优先级，才能确认某条规则是否真正匹配到目标版本。

候选版本不符合预期时的最小排查顺序

看到 Candidate 不是预期版本时，按下面的顺序读输出即可：

1. 先确认包名、架构和 Installed，避免把不同架构或已安装状态混在一起。
2. 把 Candidate 与版本表中的同版本记录配对，确认它对应哪条索引。
3. 比较各版本的优先级，再检查是否指定了 target release 或存在 preferences 规则。
4. 如果版本表明显过旧，先更新索引，再重新读取；不要把“没看到新版本”直接当成仓库没有。

这个顺序能把“索引没有更新”“优先级更低”“版本被策略排除”和“当前包已安装”区分开。它也符合标题的边界：我们只读取 APT 已经形成的选择模型，不通过盲目改源来掩盖原因。

小结：用 Candidate 和优先级解释选择结果

apt-cache policy 的核心读法可以缩成一句话：Installed 说明当前状态，Candidate 说明默认目标，版本表说明有哪些来源，Pin-Priority 说明候选为什么胜出。优先级相同才继续比较版本号；超过 1000 时还要额外警惕降级。

相关问题

apt-cache policy 会安装软件吗？

不会。它查询 APT 本地缓存；真正改变系统状态的是显式执行的安装、升级或索引更新命令。

为什么仓库里有更高版本，却没有成为 Candidate？

先对比该版本的优先级、目标发行版、架构和本地索引更新时间。版本号更高不等于策略优先级更高。