一、先立一个观念：Linux 装软件是「从仓库取」，不是「下安装包」

「软件仓库（repository）」就是一台官方服务器，里面放着成千上万个软件包。树莓派的仓库主要来自 Debian（本课对应的这代是 Debian 13，代号 Trixie），再加上树莓派基金会自己加的几个包（raspi-config、摄像头工具等）。

这套体系最大的好处：你不用去官网找安装包，也不会装到「野路子」版本——因为仓库里的东西是官方编译、签名过的。

二、四个名词先分清

sudo apt update && sudo apt full-upgrade

upgrade 和 full-upgrade 的区别（后者是老写法 dist-upgrade）：

树莓派上日常建议用 full-upgrade——因为系统组件环环相扣，保守模式常会「跳过一堆」。

三、源从哪来：先看一眼它长什么样

「源文件」就是一张「去哪儿取货」的清单，放在 /etc/apt/ 下。

新版系统（Debian 13／当前树莓派 OS）有个重要变化：

新格式长这样（看懂大意就行，不用背）：

Types: deb
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

先看一眼你自己的机器：

ls -l /etc/apt/sources.list /etc/apt/sources.list.d/
cat /etc/apt/sources.list.d/*.sources

sudo apt modernize-sources

(可选) 换成国内镜像：如果你在树莓派上下载很慢，可以把 URIs 那行改成国内镜像（如清华的 https://mirrors.tuna.tsinghua.edu.cn/debian）。只改这一行，改完必须跑 sudo apt update 验证；报错就立刻改回去。

四、命令总表（这一节最该收藏的一张表）

三条最常用的组合：

# ① 装一个工具（并顺手清掉多余依赖）
sudo apt update && sudo apt install htop && sudo apt autoremove

# ② 彻底卸载（连配置一起）
sudo apt purge 包名 && sudo apt autoremove

# ③ 查「我到底装没装」
apt list --installed 2>/dev/null | grep -i 包名

五、四个工具的辈分：apt、apt-get、aptitude、dpkg

新手看到教程里一会儿 apt 一会儿 apt-get，会以为有区别。 关系是这样的：

一句话：apt 是「柜台」，apt-get 是「老柜台」，dpkg 是「仓库管理员」——你在柜台办事，管理员在后台搬货。

dpkg 有几个查东西的功能很实用（只查不装，很安全）：

dpkg -l | grep htop            # 这个包装了没、什么版本
dpkg -L htop                   # 这个包装了哪些文件（装到哪儿去了）
dpkg -S /usr/bin/htop          # 反查：这个文件属于哪个包（超好用）

六、装「网上下来的 .deb」：优先用 apt，别用 dpkg -i

有时候确实需要装一个官网下载的 .deb 文件（因为不在仓库里）。这时：

cd ~/Downloads
sudo apt install ./xxxx.deb      # ✅ 推荐

七、加第三方源（了解即可，动手前想清楚）

有些软件（如某些新版工具）会给你一个「加源 + 装」的说明。现在正确的方式长这样（关键是用 Signed-By 指定专用公钥，而不是老的 apt-key）：

# 1. 建放钥匙的目录，把对方的公钥转成 keyring（新版推荐位置是 /etc/apt/keyrings）
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://example.com/key.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/example.gpg

# 2. 建一个 .sources 文件（只描述这一个源）
sudo nano /etc/apt/sources.list.d/example.sources
#   Types: deb
#   URIs: https://example.com/debian
#   Suites: stable
#   Components: main
#   Signed-By: /etc/apt/keyrings/example.gpg

# 3. 刷新并安装
sudo apt update && sudo apt install 包名

顺带一个安全常识：第三方源只加你真正需要、而且信任的。 加得越多，系统越脆弱、升级越容易出冲突。

八、报错对照表（你一定会用到）

九、动手 Demo：装、查、卸，外加一次「卡满了」的急救

在树莓派上依次跑这九步（全程可逆，最后会全部清理）：

# 1. 先刷新清单（不装东西，但必须有这一步）
sudo apt update

# 2. 装之前：搜一下有哪些相关的包
apt search "^htop$"                 # 精确找这个包名
apt show htop                       # 看它的版本、大小、依赖

# 3. 记住「装之前」的包数量，待会儿对账
before=$(dpkg -l | grep -c "^ii")

# 4. 装
sudo apt install -y htop

# 5. 验收：命令在哪、能不能跑
command -v htop
htop --version
dpkg -S "$(command -v htop)"        # 反查这个文件属于哪个包

# 6. 对账：是不是真的多装了东西
after=$(dpkg -l | grep -c "^ii")
echo "装之前 $before 个包，装之后 $after 个包"

# 7. 卸掉（先 remove，观察配置是否保留）
sudo apt remove -y htop
command -v htop || echo "已卸掉 ✅"

# 8. 清理不再需要的依赖
sudo apt autoremove -y

# 9. 急救演练：看一眼缓存占了多少、再清掉
du -sh /var/cache/apt/archives 2>/dev/null
sudo apt clean
du -sh /var/cache/apt/archives 2>/dev/null

看到什么算成功：

「读结果」提示：第 5 步的 dpkg -S 是本节的隐藏彩蛋——它把「命令 ↔ 包 ↔ 文件路径」三者连了起来。以后你看到某个陌生的可执行文件，可以用它反查来历；想知道某个包装到哪儿去了，用 dpkg -L。

十、30 秒实验

验证「apt update 不装东西，apt upgrade 才装」——并且看清 upgrade 前会先告诉你「要装几个、占多少」。

# 1. 先看现在有没有可升级的
apt list --upgradable 2>/dev/null | head

# 2. 模拟一次升级：「-s」＝ simulate，只演不练，什么都不改
sudo apt -s upgrade | tail -n 5

# 3. 顺手把索引的最新状态拿回来（这一步本身不装东西）
sudo apt update

你会看到：第 2 步只打印一份计划（形如「X upgraded, Y newly installed, Z to remove」），系统一点变动都没有。

这 30 秒你收获的是：-s（simulate）是 apt 给你的「预演」开关。 以后要动系统级的大操作，先 -s 演一遍——这是「动手前先看清单」这条戒律在命令行里的现成工具。

十一、常见误区

• 「apt update 就是更新软件」：它只更新清单。装新版本要靠 upgrade／full-upgrade。
• 「apt remove 会把软件和配置一起删干净」：remove 保留配置，purge 才连配置一起删。
• 「搜软件要搜程序名」：搜的是包名。程序叫 htop，包名也叫 htop 是运气好；很多程序名和包名不一样（3-3 提过）。
• 「dpkg -i 和 apt install 一样」：dpkg -i 不管依赖，装完经常「依赖未满足」；用 sudo apt install ./xxx.deb。
• 「apt-key 是老方法，能用就行」：它已被废弃而且不安全（全局信任）。新方法是 Signed-By 指定专用 keyring。
• 「改源就直接改 /etc/apt/sources.list」：新系统上它多半是空的。默认源在 /etc/apt/sources.list.d/*.sources（deb822 格式）。
• 「见到 lock 报错就删 /var/lib/dpkg/lock」：千万别。那是「另一个 apt 正在跑」的提示，删锁文件可能损坏包数据库。等它跑完。
• 「装的软件越多越好玩」：SD 卡是有限资源。装完 autoremove 一次、clean 一次是好习惯——树莓派最常见的故障之一就是卡满。

• ☐ 下一节（4-6 安装中文输入法）

相关笔记

• Raspberry Pi OS 应用程序界面 —— 上一章：包名与软件仓库的入门
• Linux 操作系统的目录结构 —— /etc 放配置、/usr/bin 放程序、/var/cache 放缓存
• Linux 的用户与文件权限指令 —— 为什么 apt 要 sudo
• Linux 的常用指令 —— df／du 排查「卡满了」
• 🍓 树莓派 · 索引 —— 全课路线图