Ubuntu on Breaking Dawn

OpenCode 在 Linux 终端显示已复制但剪贴板为空：Wayland 与 X11 修复

Tue, 21 Jul 2026 10:40:00 +0800

适用环境：Ubuntu 22.04 LTS，使用 OpenCode 时选中文字后显示 Copied to clipboard，但在其他应用中无法粘贴。本文针对 OpenCode 的剪贴板依赖缺失，不是普通终端快捷键设置问题。

问题原因

OpenCode 需要调用桌面会话对应的剪贴板工具。Wayland 会话通常使用 wl-clipboard 提供的 wl-copy / wl-paste；X11 会话常使用 xclip。若系统缺少对应工具，OpenCode 可能显示复制成功，但实际没有可供其他程序读取的剪贴板内容。

1. 确认当前图形会话

1

echo "$XDG_SESSION_TYPE"

常见输出为 wayland 或 x11。不要根据桌面名称猜测；同一台 Ubuntu 机器可能在登录时切换 Wayland 与 “Ubuntu on Xorg”。

2. 按会话类型安装剪贴板工具

若输出为 wayland：

1
2


sudo apt update
sudo apt install wl-clipboard

若输出为 x11：

1
2


sudo apt update
sudo apt install xclip

安装完成后退出并重新启动 OpenCode，再测试复制。通常不需要重启系统。

3. 可选：直接验证系统剪贴板

Wayland：

1
2


printf 'clipboard test' | wl-copy
wl-paste

X11：

1
2


printf 'clipboard test' | xclip -selection clipboard
xclip -o -selection clipboard

两条命令能输出相同文本时，说明系统剪贴板工具已经可用；若 OpenCode 仍失败，再检查 OpenCode 的版本与上游 issue。普通终端中的 Ctrl+C 仍是中断前台程序，文本复制一般使用 Ctrl+Shift+C。

出处

原始参考：opencode 在 Linux 终端中无法复制文字的解决方法（技术栈）
上游问题：anomalyco/opencode #7048
工具参考：wl-clipboard、xclip

本文已依据补充提供的原始 HTML 重制，保留其 Wayland / X11 分流方案，并增加了工具验证与 OpenCode 重启步骤。

Ubuntu 忘记密码后的恢复：优先重设用户密码，不启用 root

Tue, 21 Jul 2026 10:15:00 +0800

仅限授权设备：以下步骤适用于自己拥有或明确获授权维护的电脑。能够接触设备和 GRUB 菜单的人可能获得本地管理员权限；请同时保护好物理设备和磁盘加密密钥。

Ubuntu 默认把 root 账户锁定，日常管理通过普通用户加 sudo 完成。忘记登录密码时，通常只需要重设自己的用户密码，没有必要长期启用 root。

通过恢复模式重设密码

开机时进入 GRUB；如菜单被隐藏，可在开机阶段按住 Shift（传统 BIOS）或反复按 Esc（常见 UEFI）尝试显示菜单。
选择 Advanced options for Ubuntu，再选择带有 (recovery mode) 的内核。
在恢复菜单中选择 root – Drop to root shell prompt。
将根文件系统重新挂载为可写，然后为目标用户设置新密码：

1
2
3
4


mount -o remount,rw /
passwd 用户名
sync
reboot

把 用户名 替换为实际 Linux 用户名；它通常不是 Windows 账户邮箱。若不确定，可在恢复 shell 中查看 /home 下的目录名。

BitLocker 与磁盘加密提醒

此操作不应修改 Windows 分区。若 Ubuntu 使用全盘加密，系统会先要求解锁磁盘；如果忘记的是磁盘解锁口令而非登录密码，恢复路径不同，不能通过简单的 passwd 解决。

完成恢复后，请检查是否仍有不需要的管理员账户，并为重要数据保留离线备份。

出处

原始参考：如何在 Ubuntu 上重置 Root 密码（系统极客）
官方参考：Ubuntu Community Help Wiki：LostPassword

本文将“重置 root”调整为 Ubuntu 更推荐的普通用户密码恢复方式。

Ubuntu 内核更新与固定版本：先保留回退，再考虑 hold

Tue, 21 Jul 2026 10:05:00 +0800

安全提示：内核更新也包含安全修复。除非某个已确认的驱动 / 硬件回归正在影响使用，不建议长期冻结内核；应记录原因与恢复日期。

Ubuntu 通常会保留一个或多个旧内核，这正是遇到新内核与 NVIDIA、VirtualBox 等 DKMS 模块不兼容时最好的回退手段。第一选择应是从 GRUB 的“Advanced options for Ubuntu”启动上一个可用内核，而不是马上阻止所有升级。

先确认当前状态

1
2
3


uname -r
dpkg -l 'linux-image*' | grep '^ii'
apt-cache policy linux-generic linux-image-generic linux-headers-generic

记录可正常使用的内核版本、显卡驱动版本和故障表现。待问题解决并在新内核上验证后，再清理旧内核；不要删除当前正在运行的版本。

需要短期暂停更新时

Ubuntu 的内核通常由元包推进。下面只是在问题排查期间暂停元包更新；包名需以本机 apt-cache policy 输出为准：

1
2


sudo apt-mark hold linux-generic linux-image-generic linux-headers-generic
apt-mark showhold

恢复更新：

1
2
3


sudo apt-mark unhold linux-generic linux-image-generic linux-headers-generic
sudo apt update
sudo apt upgrade

固定单个、已安装的版本包，往往不能阻止元包引入新版本；反过来，冻结元包又会连带停止内核安全更新。因此应该把 hold 当作短期隔离措施，而不是永久配置。

出处

原始参考：Ubuntu 锁定内核不让它升级（RayChiu，CSDN）
原始参考：Ubuntu 固定内核版本（checknet，CSDN）
命令参考：APT apt-mark 手册

本文合并两篇原始资料，并补充了 Ubuntu 22.04 的内核元包和安全更新风险。

ROG / 华硕笔记本在 Ubuntu 22.04 上使用 asusctl 与显卡模式工具

Tue, 21 Jul 2026 09:50:00 +0800

适用环境：Ubuntu 22.04 LTS，且硬件为受支持的华硕 / ROG 机型。asusctl 是社区项目，不是华硕官方 Windows 驱动的等价替代品。

asusctl 可为部分机型提供键盘灯效、充电限制、性能档位等控制；不同机型支持度差异很大。显卡模式切换牵涉 NVIDIA 驱动、内核和 Secure Boot，风险高于普通桌面设置，应单独验证。

先确认机型与支持能力

1
2
3
4


cat /sys/class/dmi/id/product_name
cat /sys/class/dmi/id/board_name
asusctl --help
asusctl -s

asusctl -s 列出的功能才是当前机器和驱动实际报告可用的能力。不要把其他机型的 Aura 灯效配置、风扇曲线或 /etc/asusd/ 文件直接复制过来。

安装原则

优先使用 asus-linux 项目针对 Ubuntu 的当前安装文档和软件源。旧教程中“下载源码、手动 make install”的办法容易绕开包管理器，后续内核更新或卸载时会留下难以追踪的文件。安装前先确认项目仍支持 Ubuntu 22.04 与你的型号，并记录原本的电源/显卡模式。

完成安装后，只做无破坏检查：

1
2


systemctl status asusd
asusctl -s

确认服务正常后，再逐项调整充电阈值、灯光或性能模式。每次只改一项并测试睡眠、重启和电源状态。

关于 supergfxctl

收藏中的 supergfxctl GitLab 仓库已标记为归档。显卡模式工具的归属、安装方式和支持机型可能已经变化，因此不应使用归档仓库中的旧命令直接安装。请从 asus-linux 的当前主页进入维护中的项目文档；不支持的机型应使用 Ubuntu “附加驱动”和 NVIDIA 的标准 PRIME 流程。

出处

原始参考：在 Ubuntu 中为 ROG 笔记本安装 asusctl（MAVER1CK，CSDN）
原始参考：asus-linux / supergfxctl GitLab 仓库（已归档）
项目主页：asus-linux.org

本文将两条资料合并，并明确标注了归档项目与机型差异的限制。

Ubuntu 22.04 配置 Fcitx5 中文拼音输入法

Tue, 21 Jul 2026 09:45:00 +0800

适用环境：Ubuntu 22.04 LTS。若系统已经稳定使用 IBus，不必为了“更强功能”强行更换；不要让两个输入法框架同时接管环境变量。

Fcitx5 是输入法框架，本身不等于拼音引擎。Ubuntu 上常用组合是 fcitx5 加 fcitx5-chinese-addons，再用图形配置工具添加“拼音”。

安装

1
2
3


sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-config-qt
im-config -n fcitx5

执行完后注销再登录；若仍不生效，重启一次会更彻底。随后打开应用菜单中的 Fcitx 5 Configuration，点击“添加输入法”，取消“仅显示当前语言”，搜索并添加“拼音”。

使用与检查

默认可用 Ctrl + Space 切换输入法。若快捷键无反应，先在 Fcitx5 配置中检查“全局选项”而不是直接修改配置文件。

1

fcitx5-diagnose | less

诊断报告会显示当前桌面会话、环境变量、已安装组件和冲突配置。特别注意：旧教程常要求手工写入 GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS；Ubuntu 22.04 配合 im-config 时通常不需要重复写入，重复配置反而可能导致应用无法调出候选框。

Wayland 提示

Ubuntu 22.04 的 GNOME 可能运行在 Wayland 会话。多数 GTK/Qt 程序可正常使用 Fcitx5；个别 Electron、Java 或旧版应用若不能输入中文，应先更新应用，或仅为该应用参考其官方 Wayland/Fcitx5 支持说明，不要全局退回到旧框架。

出处

原始参考：Fcitx5 输入法设置优化（深度科技论坛）
原始参考：Debian 12 安装 Fcitx5 中文拼音输入法（知乎）
项目参考：Fcitx 5 Wiki

两篇原始参考分别面向 Deepin 与 Debian；本文已按 Ubuntu 22.04 的软件包名称和桌面流程重新整理。

Ubuntu 功能键变成多媒体键：先确认硬件，再做可回退配置

Tue, 21 Jul 2026 09:20:00 +0800

适用环境：Ubuntu 22.04 LTS。功能键由 BIOS/UEFI、键盘固件和 Linux 驱动共同决定；不同品牌的解决方案不能互相照搬。

当按下 F11 却调节音量时，先确认这是不是键盘设计的“多媒体优先”模式。多数笔记本可在 BIOS/UEFI 中切换 Hotkey Mode、Action Keys Mode 或 Function Key Behavior；部分键盘支持 Fn + Esc 切换。优先使用这两种方式，因为它们不会引入系统级驱动副作用。

在 Ubuntu 中确认按键事件

1

sudo libinput debug-events

运行后按一次目标键，观察系统收到的是 KEY_F11 还是音量等媒体键。按 Ctrl+C 结束。若系统已经收到媒体键事件，桌面环境只是按硬件报告的键码处理，修改应用快捷键通常无效。

关于 `hid_apple` 参数

网络上常见的 hid_apple 与 fnmode 方案是给Apple USB / 蓝牙键盘使用的，并不适用于普通 Windows 笔记本内置键盘。只有在 lsmod | grep hid_apple 有结果，且确实使用 Apple 键盘时，才应研究该模块的参数。

1

lsmod | grep hid_apple

对华硕、联想、戴尔等笔记本，若 BIOS 中没有选项，应查找该机型的 Linux 支持文档或厂商工具。改内核启动参数、黑名单驱动前，请记录原始内容并准备从 GRUB 进入旧内核。

出处

原始参考：Ubuntu 如何关闭 Fn 功能键 / F11 只能控制音量（Drailife，CSDN）
输入事件工具参考：libinput debug-events 文档

原始参考中的模块参数具有设备针对性；本文特别补充了适用边界与回退原则。

Linux 磁盘空间排查：正确使用 df、du 与大文件定位

Tue, 21 Jul 2026 09:15:00 +0800

适用环境：Ubuntu 22.04 LTS。执行清理操作前，请先确认路径和数据归属；不要因空间不足而直接删除不认识的系统目录。

df 看的是文件系统剩余空间，du 看的是目录内容占用。两者结合，能快速判断是哪个分区满了、又是哪个目录导致的。

第一步：确认哪个分区满了

1

df -hT

关注挂载点为 /、/home、/boot 的行。Use% 接近 100% 时，先不要升级系统或安装大型软件包；这可能让包管理操作中断。

第二步：从大目录逐层缩小

1
2


sudo du -xhd1 / | sort -h
du -xhd1 "$HOME" | sort -h

-x 让 du 不跨越到其他挂载点，避免把 Windows NTFS 分区、移动硬盘等内容混在统计里。通常先检查 /var、/home、/usr；在 /var 下，日志、软件包缓存和容器数据经常占用较多空间。

继续深入某个目录时，替换路径即可：

1

sudo du -xhd1 /var | sort -h

第三步：定位异常大文件

1

sudo find /var -xdev -type f -size +1G -printf '%10s %p\n' | sort -n

看到大文件后，先判断它是否为日志、下载缓存、虚拟机磁盘或数据库文件。对日志可使用 journalctl --disk-usage 查看 systemd 日志占用；不要直接删除正在写入的日志文件。

一个容易忽略的差异

若 df 显示空间已满而 du 找不到对应内容，可能是进程仍打开着一个“已删除文件”。可用下面命令排查：

1

sudo lsof +L1

确认对应服务后，以正常方式重启服务或系统，才会释放这部分空间。

出处

原始参考：Linux 查看磁盘空间命令（df、du）（jadeandplum，CSDN）
手册参考：GNU Coreutils: df invocation

本文将原始命令按“整体—目录—文件—异常占用”的排查顺序重新组织。

Ubuntu 22.04 为应用创建开始菜单与桌面启动器

Tue, 21 Jul 2026 09:05:00 +0800

适用环境：Ubuntu 22.04 LTS 默认 GNOME 桌面。适合 AppImage、解压后运行的程序，或没有自动添加菜单项的软件。

Linux 的“快捷方式”是符合 Desktop Entry 规范的 .desktop 文件。对当前用户，文件应放在 ~/.local/share/applications/；只有需要所有用户都能看到时，才使用 /usr/share/applications/。

创建一个当前用户可用的启动器

假设程序实际路径为 /opt/example/example、图标为 /opt/example/example.png：

1
2


mkdir -p ~/.local/share/applications
nano ~/.local/share/applications/example.desktop

写入下面的最小配置，并将路径替换成自己的真实路径：

1
2
3
4
5
6
7
8


[Desktop Entry]
Type=Application
Name=Example
Comment=示例应用
Exec=/opt/example/example
Icon=/opt/example/example.png
Terminal=false
Categories=Utility;

保存后执行：

1
2


chmod +x ~/.local/share/applications/example.desktop
update-desktop-database ~/.local/share/applications 2>/dev/null || true

在“显示应用程序”中搜索 Example；若没有立刻出现，注销再登录或重启 GNOME Shell 会刷新菜单缓存。

常见问题

Exec= 必须是实际可执行文件的绝对路径。程序本身没有执行权限时，可先执行 chmod +x /实际/程序路径。需要在终端内运行的命令行程序，才把 Terminal 设为 true。

不要把不明来源的脚本直接写进 Exec=。启动器与双击可执行文件一样，会以当前用户权限运行其中的命令。

桌面图标

Ubuntu 的 GNOME 桌面默认对桌面文件有额外的“允许启动”限制。建议优先把启动器留在应用菜单；确有需要时，将同一个 .desktop 文件复制到桌面，再在文件管理器中选择“允许启动”。

出处

原始参考：在 Linux 下为软件程序添加快捷方式和开始菜单（McwoLF，CSDN）
规范参考：Desktop Entry Specification

本文未复制原文，示例已按 Ubuntu 22.04 的当前用户目录重新整理。

Ubuntu 中 dpkg 返回错误代码 1：从检查到修复

Tue, 21 Jul 2026 09:00:00 +0800

适用环境：Ubuntu 22.04 LTS。本文只处理 apt / dpkg 的软件包状态问题，不适用于磁盘损坏或系统无法启动的情形。

E: Sub-process /usr/bin/dpkg returned an error code (1) 不是一个单独的故障原因，而是安装流程最后给出的概括性结果。真正的线索通常出现在它之前：可能是某个包的配置脚本失败、依赖缺失、磁盘空间耗尽，或安装被中断。

先找到真正报错的包

先重新执行一次，并保留完整输出；重点看最后一个出现 error processing package 或 post-installation script 的包名。

1
2
3


sudo apt update
sudo apt install -f
sudo dpkg --configure -a

这三个命令依次更新软件包索引、修复可满足的依赖、继续完成尚未配置的包。大多数“错误代码 1”到这里就能恢复。

仍失败时的排查顺序

查看可用空间：df -h；/ 或 /var 写满会导致配置脚本失败。
查看最近的包管理日志：sudo tail -n 120 /var/log/dpkg.log。
用前面找到的包名重新安装：sudo apt install --reinstall 包名。
只有确认该包可以移除且没有关键依赖时，才考虑 sudo apt remove 包名 后再安装。

不要把删除 /var/lib/dpkg/info 当作常规修复方式。该目录保存已安装软件包的维护脚本与元数据；直接改动前必须有备份，并应先确认是元数据损坏而非某个具体包的配置错误。

修复后的确认

1
2
3


sudo apt -f install
sudo dpkg --audit
sudo apt upgrade

若 dpkg --audit 没有输出未完成的软件包，说明包管理状态已恢复。对驱动、内核、引导加载器等重要组件，建议在重启前确认没有待处理的错误。

出处

原始参考：解决 apt-get 安装中的 dpkg error code (1)（焦距，博客园）

本文为基于原始参考重新编排的排障笔记；命令应以当前终端输出为准。