首页 on Breaking Dawn

说明：本组双系统笔记由 AI 整理，后续将逐篇重制

Wed, 22 Jul 2026 09:00:00 +0800

这组内容来自个人在配置 Ubuntu 22.04 LTS 与 Windows 11 双系统 过程中收藏的资料与踩坑记录。为了便于回顾和检索，现阶段先由 AI 协助完成主题归类、文字整理、风险提示与排版。

阅读前请注意

每篇文末均保留了原始参考链接；正文是重新组织后的摘要和操作建议，并非对原文的复制。
电脑型号、固件版本、磁盘布局、驱动版本和 Secure Boot 状态都会影响结果。EFI、GRUB、内核、显卡驱动等文章尤其需要先备份、确认分区和准备恢复介质。
文中命令以 Ubuntu 22.04 LTS 与 Windows 11 为背景；软件包版本和上游项目可能已经更新，请优先查看文末官方文档。
原收藏中涉及非授权软件破解的内容没有转载，已替换为正版安装与开源替代方案说明。

后续计划

目前这些文章的目的，是把当时分散的资料变成可检索、带出处、有边界的临时知识库。后续有时间时，我会结合自己的实际设备、截图、命令输出和验证结果，逐篇重制为更完整的原创实践记录。

本文性质：站点说明与维护承诺

update-alternatives：在 Linux 中管理同一命令的多个实现

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

适用环境：Ubuntu 22.04 LTS / Debian 系。update-alternatives 管理的是系统级符号链接，不等同于语言版本管理器或 PATH 顺序。

同一个命令名可能有多种实现，例如 editor、java、cc。Debian 系统用 alternatives 链接组决定默认目标，避免用户直接手改 /usr/bin 下的链接。

查看与交互选择

1
2


update-alternatives --display editor
sudo update-alternatives --config editor

第一条会显示当前链接、可选项和优先级；第二条提供编号选择。切换前先确认候选程序来自可信软件包，并在切换后核对版本：

1
2


command -v editor
readlink -f "$(command -v editor)"

创建自定义链接组时要非常具体

只有当软件本身没有注册 alternatives 且确有系统级需求时，才使用 --install。下面是占位示例，路径、名称、优先级都必须换成实际值：

1
2


sudo update-alternatives --install /usr/local/bin/example-tool example-tool /opt/example-v2/bin/example-tool 20
sudo update-alternatives --config example-tool

不要用 alternatives 直接管理 python、pip、Node.js、CMake 等开发工具的全部生态。它们通常还牵涉虚拟环境、包管理器、IDE 与项目级版本要求；更适合使用 venv、nvm、容器或项目工具链。

取消手工加入的候选项

1

sudo update-alternatives --remove example-tool /opt/example-v2/bin/example-tool

移除前先切换到另一个有效候选项。由 APT 安装的软件包应优先通过 APT 卸载，让软件包维护脚本处理对应 alternatives。

出处

原始参考：update-alternatives 命令使用方法与软件多版本管理（阿里云开发者社区）
手册参考：Ubuntu Jammy：update-alternatives(1)

本文将原始资料整理为“查看—切换—谨慎注册—移除”的可回退流程。

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 22.04 调整 GRUB 默认启动项与等待时间

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

风险提示：修改前先备份配置。不要手工编辑 /boot/grub/grub.cfg，该文件由 update-grub 自动生成，更新后会被覆盖。

安装 Ubuntu 后，GRUB 往往成为默认引导菜单。常见需求是缩短等待时间、默认进入 Windows 11，或固定进入一个已验证可用的旧内核。

先备份并查看菜单项

1
2
3


sudo cp /etc/default/grub /etc/default/grub.bak
grep -E '^(GRUB_DEFAULT|GRUB_TIMEOUT)' /etc/default/grub
grep -E "^menuentry |^submenu " /boot/grub/grub.cfg

最后一条只用于查看当前生成的菜单标题；配置应始终修改 /etc/default/grub。

调整等待时间

编辑配置：

1

sudoedit /etc/default/grub

例如将等待时间设为 5 秒：

1

GRUB_TIMEOUT=5

设定默认启动项

最稳妥的是用菜单中显示的完整标题，而不是猜数字序号。例如：

1

GRUB_DEFAULT="Windows Boot Manager (on /dev/nvme0n1p1)"

标题必须与本机 /boot/grub/grub.cfg 中的菜单项完全一致；磁盘名、分区号会因机器不同而不同。若只是想在下次重启临时选择某项，保留默认设置，在 GRUB 菜单中手动选择更安全。

保存后生成配置：

1

sudo update-grub

重启前请确认输出中同时发现了 Ubuntu 与 Windows Boot Manager。若配置误改，可用备份恢复：

1
2


sudo cp /etc/default/grub.bak /etc/default/grub
sudo update-grub

固定旧内核的建议

内核出现驱动回归时，优先在 Advanced options for Ubuntu 中手动选择旧内核验证。需要长期固定时，应在 /etc/default/grub 设置确定的菜单标题，并同时评估内核安全更新；详见本站的《Ubuntu 内核更新与固定版本》一文。

出处

原始参考：Ubuntu 修改启动项等待时间、启动项顺序、更改启动内核（perfect886，CSDN）
官方参考：GNU GRUB Manual

本文不采用直接编辑 grub.cfg 的方法，改为可由 update-grub 持续维护的配置方式。

Ubuntu 22.04 安装 NVIDIA 驱动与 Secure Boot：优先使用发行版流程

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

风险提示：显卡驱动、内核、Secure Boot 和混合显卡模式相互影响。操作前请确保能从 GRUB 启动旧内核，或准备好 Ubuntu Live USB；不要在正常桌面环境里随意手工删除 NVIDIA、Nouveau 或 EFI 文件。

在 Ubuntu 22.04 中，最稳妥的起点是发行版的“附加驱动”或 ubuntu-drivers。它会根据硬件选择受支持的驱动包，并把内核模块、更新和卸载纳入 APT 管理。

标准安装流程

1
2
3
4


sudo apt update
ubuntu-drivers devices
sudo ubuntu-drivers install
sudo reboot

重启后验证：

1

nvidia-smi

如果能显示驱动版本与 GPU 信息，基本安装已完成。笔记本混合显卡还应测试外接显示器、睡眠唤醒和电池模式，而不只是运行一次 nvidia-smi。

Secure Boot 开启时会发生什么

驱动若通过 DKMS 构建，Ubuntu 可能要求创建 MOK（Machine Owner Key）密码。重启时会进入蓝色的 MOK 管理界面：选择 Enroll MOK，按提示确认密钥并输入刚才设置的密码。只有完成注册，Secure Boot 才会信任该本机生成的内核模块。

若不想注册 MOK，也可以在固件中关闭 Secure Boot，但这会降低启动链的验证范围。两种策略应二选一、保持一致；不要先安装模块再随意切换 Secure Boot 状态。

不要把手工签名当作第一方案

手动生成密钥、签名 .ko 文件和直接导入主板 db 适合自编译内核模块或特殊固件问题，但步骤与主板实现强相关，内核更新后还需要维护。对 Ubuntu 仓库 NVIDIA 驱动，应优先完成发行版提供的 MOK 流程；只有在标准流程失败且明确需要自定义模块时，才根据硬件和上游文档单独处理。

出处

原始参考：UEFI 安全启动模式下安装 Ubuntu NVIDIA 驱动（知乎）
原始参考：Ubuntu 22.04 LTS 安装 NVIDIA 显卡驱动（cyMessi，博客园）
原始参考：华硕主板上的 Ubuntu 驱动签名方案（Kevin从心开始，CSDN）
官方参考：Ubuntu Community Help Wiki：NVIDIA drivers

本文合并三条原始资料，并将重点放在 Ubuntu 的推荐驱动与 MOK 注册流程，避免把主板专用手工签名步骤当作通用方案。

Linux 上使用数据库客户端：正版 Navicat 与开源替代方案

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

合规说明：本文不提供破解、补丁、许可证绕过或受限软件下载的内容。商业软件请使用有效许可证、试用版或教育授权。

在 Ubuntu 上管理 MySQL、PostgreSQL、SQLite 等数据库时，先按团队规范决定客户端；数据库连接配置、SSH 密钥和生产凭据比“装什么软件”更需要谨慎保管。

商业软件：从官方渠道获取

若团队使用 Navicat，请从 Navicat 官方下载页获取适用于 Linux 的安装包，并使用组织或个人的有效授权。安装前确认发行版支持范围、CPU 架构与更新渠道；不要从第三方网盘或来历不明的二次打包版本安装。

开源替代：DBeaver Community

DBeaver Community 是常见的开源跨平台数据库客户端。它适合同时连接多种数据库；驱动和插件会随版本变化，建议从项目官方页面选择适合 Ubuntu 的安装包或仓库方式。

连接生产库前的最小检查

使用只读或最小权限账号，避免日常使用超级管理员账号。
通过密码管理器或 SSH Agent 管理凭据，不把密码写入连接截图、脚本或 Git 仓库。
首次连接先确认主机名、端口、环境标签与证书；生产库与测试库应使用明显不同的连接颜色或名称。
导出 / 导入数据前确认文件包含范围和目标库，特别是 Windows 11 与 Ubuntu 共享目录中的备份文件。

出处

官方来源：Navicat Premium for Linux 下载
替代方案来源：DBeaver Community 下载

原始收藏中有一条涉及非授权破解的教程；整理时已删除该类内容并改为合法安装与替代方案说明。

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 22.04 使用 nvm 管理多个 Node.js 版本

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

适用环境：Ubuntu 22.04 LTS 的 Bash / Zsh 用户。nvm 是“按用户、按 shell”工作的工具，不会成为系统范围的 apt 软件包。

nvm 适合同时维护多个 Node.js 项目：一个老项目使用旧 LTS，另一个项目使用新版本，而不需要反复卸载系统 Node。

从官方发布页安装

从 nvm 官方仓库的安装说明复制当前发布版本的安装命令。执行 curl | bash 类命令前，建议先打开脚本链接审阅，或采用官方 README 提供的 Git 安装方式。

安装器通常会把下面这一类加载代码写入 ~/.bashrc 或其他 shell 配置文件：

1
2


export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

重新打开终端，或执行：

1
2


source ~/.bashrc
command -v nvm

注意要用 command -v nvm，而不是 which nvm：nvm 是 shell 函数，不是普通可执行文件。

常用工作流

1
2
3
4
5


nvm install --lts
nvm use --lts
nvm alias default 'lts/*'
node --version
npm --version

项目根目录可以放置 .nvmrc，例如写入 22 或具体版本号；进入项目后执行 nvm use，使每个项目都用其要求的运行时。不要对 nvm 管理的全局 npm 包使用 sudo。

双系统边界

Ubuntu 上的 nvm 与 Windows 11 中安装的 Node.js / nvm-windows 相互独立。不要试图让两边共享 ~/.nvm、node_modules 或全局 npm 目录；文件权限、原生模块和路径格式都不同。

出处

原始参考：nvm-sh/nvm 官方仓库
文档参考：nvm README：安装、验证与使用

本文基于项目官方文档整理，避免固化会过期的安装脚本版本号。

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 的内核元包和安全更新风险。

Linux 的 .profile、.bashrc、.bash_profile：该把配置写到哪里

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

适用环境：Ubuntu 22.04 LTS 默认 Bash。先用 echo "$SHELL" 确认自己使用的是 Bash；Zsh、Fish 有不同的加载规则。

最简原则：交互式终端行为放 .bashrc，登录后只需执行一次的环境设置放 .profile。不要把同一段初始化同时复制到多个文件，否则每打开一个终端都可能重复追加 PATH 或启动工具。

Ubuntu 22.04 中三个文件的角色

文件	通常何时读取	合适内容
`~/.bashrc`	每个交互式 Bash 终端	别名、提示符、补全、交互工具初始化
`~/.profile`	图形登录，或 Bash 没有前两个登录配置时的登录 shell	PATH、登录环境变量；Ubuntu 默认模板通常让它加载 `.bashrc`
`~/.bash_profile`	Bash 登录 shell；优先级高于 `.profile`	仅在自己明确需要 Bash 专用登录配置时创建

系统级配置应单独看待：/etc/profile 负责登录 shell 的全局环境设置，并可能加载 /etc/profile.d/ 下的脚本；Ubuntu 的交互式 Bash 全局配置通常是 /etc/bash.bashrc，不是一些教程中写的 /etc/bashrc。

Bash 登录时的优先顺序

Bash 作为登录 shell 时，依次尝试读取：

~/.bash_profile
不存在时读取 ~/.bash_login
前两者都不存在时读取 ~/.profile

三者只会命中其中一个。Ubuntu 的默认 ~/.profile 通常会在交互式 Bash 环境中加载 ~/.bashrc；一旦自行新建 .bash_profile，Bash 就不再自动读取 .profile。如果确实要创建它，通常应显式加载 .profile，避免丢失系统默认的 PATH 设置：

1
2
3


if [ -f ~/.profile ]; then
 . ~/.profile
fi

修改后的即时验证

1
2
3


source ~/.bashrc
printf '%s\n' "$PATH"
command -v 需要检查的命令

source 只影响当前终端。对图形登录环境变量、输入法或桌面程序，应该注销再登录，不要仅凭当前终端的结果判断成功。

常见误区

不要把需要用户交互的命令、会输出大量文字的命令或启动 GUI 程序写进 .profile。它们可能在登录管理器、远程会话或脚本中被调用，造成登录变慢或环境异常。

另一个常见误解是“每个 shell 脚本都会读取 .bashrc”。默认的非交互式 Bash 不会读取 ~/.bashrc；只有显式 source，或设置了 BASH_ENV 时才可能读取额外配置。因此，脚本所需的环境变量应在脚本、systemd 单元或项目环境中明确声明。对于 nvm、conda 等工具，优先复制其官方安装器给出的单一初始化片段，并放到对应 shell 的推荐文件。

出处

原始参考：Linux 文件 profile、bashrc、bash_profile 区别（linux技术栈，知乎）
手册参考：GNU Bash Manual：Bash Startup Files

本文已依据补充提供的原始 HTML 核对其登录配置顺序，并修正了 /etc/bashrc 路径和“.bashrc 会被所有脚本读取”等不适用于 Ubuntu 22.04 的表述。

Ubuntu 22.04 安装 CMake：稳定版、项目版与版本核对

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

适用环境：Ubuntu 22.04 LTS。先阅读项目的 CMakeLists.txt、README 或 CI 配置，确认最低版本；“越新越好”并不总是正确。

优先选择：Ubuntu 系统仓库

对于没有明确版本要求的项目，系统仓库的 CMake 最易维护：

1
2
3
4


sudo apt update
sudo apt install cmake
cmake --version
command -v cmake

它会随着 Ubuntu 的安全更新维护，卸载、升级和依赖关系也由 APT 管理。

项目要求更高版本时

若项目明确要求比仓库更新的 CMake，优先使用 CMake 官方下载页提供的发行包，或采用项目自己的容器 / 工具链配置。安装后务必核对实际生效版本：

1
2


cmake --version
type -a cmake

如果同时存在 /usr/bin/cmake 与 /usr/local/bin/cmake，后者通常会优先执行。记录该差异，避免同一台机器上不同终端、CI 或 IDE 使用了不同版本。

不建议直接沿用旧教程的做法

许多旧教程使用 apt-key、针对旧版 Ubuntu 代号的第三方源，或在 /usr/local 源码编译安装。这些方式会造成密钥管理过时、软件源不匹配或覆盖系统版本。只有在必须补丁 CMake 本身时，才考虑从源码编译，并把版本、安装位置和卸载方法写入项目文档。

出处

原始参考：Ubuntu 安装 CMake 的三种方法（Man_1man，CSDN）
官方参考：CMake Download

本文保留“按需求选择安装方式”的思路，并移除了过时发行版软件源示例。

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 安装或修复时出现 grub-install 错误：UEFI 排查与恢复

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

风险提示：分区名会因磁盘、NVMe、加密和 LVM 配置而不同。下面的 /dev/nvme0n1pX 仅是占位示例，绝不能原样套用。

grub-install 失败最常见的原因不是 GRUB 文件本身，而是启动模式或 EFI 挂载点不对：安装 U 盘以 Legacy/CSM 模式启动、系统磁盘是 GPT/UEFI 方案却没有挂载 EFI 系统分区，或目标分区识别错误。

安装前的三项确认

在固件中使用 UEFI 模式启动 Ubuntu 安装 U 盘；安装器终端中可用 test -d /sys/firmware/efi && echo UEFI 验证。
Windows 11 的双系统通常应共享已有的 FAT32 EFI 系统分区，挂载为 /boot/efi，不要格式化。
若设备有 NVIDIA 显卡，黑屏时可仅在本次启动的 GRUB 菜单临时添加 nomodeset；进入系统并安装合适驱动后应移除该临时参数。

用 Live USB 修复已安装的 Ubuntu

从 Live USB 以 UEFI 模式启动，先通过“试用 Ubuntu”进入桌面，使用 lsblk -f 确认 Linux 根分区与 EFI 分区。以下示例假设根分区是 /dev/nvme0n1p6、EFI 分区是 /dev/nvme0n1p1：

1
2
3
4


sudo mount /dev/nvme0n1p6 /mnt
sudo mount /dev/nvme0n1p1 /mnt/boot/efi
for dir in /dev /dev/pts /proc /sys /run; do sudo mount --bind "$dir" "/mnt$dir"; done
sudo chroot /mnt

进入 chroot 后再安装引导项：

1
2
3


grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=ubuntu --recheck
update-grub
exit

卸载并重启前先退出 chroot：

1
2
3
4


for dir in /run /sys /proc /dev/pts /dev; do sudo umount "/mnt$dir"; done
sudo umount /mnt/boot/efi
sudo umount /mnt
sudo reboot

如果 grub-install 仍失败，保留完整错误信息，并再次检查 Live USB 是否确实以 UEFI 启动、EFI 分区是否为 FAT32、是否已挂载到正确位置。不要编辑生成文件 /boot/grub/grub.cfg 来“永久修复”问题。

出处

原始参考：安装系统时遇到 grub-install Error 的解决（不食花生的猫，博客园）
官方参考：Ubuntu Community Help Wiki：GRUB 2

本文保留原始问题出处，但采用 UEFI/Live USB 的通用恢复流程，避免修改自动生成的 GRUB 配置文件。

误格式化 Windows EFI 分区后：以 bcdboot 重建 UEFI 引导

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

风险提示：EFI 分区通常只有 100–300 MB，却可能同时保存 Windows 和 Ubuntu 的启动文件。本文只重建 Windows 启动文件；操作前请拍照记录分区列表，并准备 Windows 11 安装 / 恢复 U 盘。

如果 Windows 11 无法从 UEFI 启动，而系统分区和数据分区仍在，最稳妥的途径是进入 Windows 恢复环境，用 bcdboot 从现有 Windows 系统目录重新生成启动文件。

1. 进入 Windows 恢复命令提示符

从 Windows 11 安装 U 盘启动，选择“修复计算机” → “疑难解答” → “高级选项” → “命令提示符”。不要在 Ubuntu 中创建或格式化 EFI 分区来代替这一步。

2. 确认 EFI 分区和 Windows 分区

1
2


diskpart
list vol

EFI 系统分区通常是 FAT32、约 100–300 MB、没有盘符。Windows 分区在恢复环境中不一定是 C:；先用 dir C:\Windows、dir D:\Windows 等确认真正包含 Windows 目录的盘符。

确认无误后，仅给 EFI 分区临时分配盘符（以下 N 必须替换为 list vol 中的卷号）：

1
2
3


select vol N
assign letter=S
exit

3. 重建 Windows 启动文件

假设 Windows 目录确实位于 C:\Windows：

1

bcdboot C:\Windows /s S: /f UEFI

成功后关机、拔掉安装 U 盘，再在固件启动菜单中选择 Windows Boot Manager。若 Windows 能启动而 Ubuntu 项消失，这是正常现象：随后可用 Ubuntu Live USB 重新安装 GRUB，而不必再次格式化 EFI 分区。

复核与善后

进入 Windows 后，确认磁盘管理中 EFI 分区仍为 FAT32 系统分区；不要为了“清理”而删除它。临时盘符 S: 不应长期保留，可在管理员命令提示符中用 DiskPart 移除盘符。

出处

原始参考：Win10 的 EFI 分区被格式化后如何重建引导（远景论坛）
命令参考：Microsoft：BCDBoot 命令行选项

本文将原始 Windows 10 场景改写为 Windows 11，并补充了双系统 EFI 分区共享时的风险说明。

Linux 中查找命令与文件：which、whereis、locate、find 怎么选

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

适用环境：Ubuntu 22.04 LTS。命令搜索与文件搜索是两件不同的事，先明确目标会少走很多弯路。

想找什么	优先命令	特点
当前 shell 实际会执行哪个命令	`command -v 名称`	能识别 shell 内建命令、别名和函数
PATH 中的可执行文件	`which 名称`	简单，但不适合判断别名或函数
二进制、源码、手册的大致位置	`whereis 名称`	快，搜索范围有限
已建立索引的文件名	`locate 关键词`	非常快，结果可能不是最新
在真实目录树中精确查找	`find 路径条件`	最可靠，但大范围搜索较慢

找“我现在运行的是谁”

1
2


command -v python
type -a python

command -v 最适合脚本与日常判断；type -a 会列出所有同名候选项。若安装了多个 Node、Python 或 CMake，这比单独使用 which 更能说明实际调用顺序。

原始资料用“复制 ls 到家目录”的实验说明了一个关键差异：which 只会返回位于 $PATH 中、且具有可执行权限的候选文件。需要列出全部候选项时可使用：

1

which -a ls

但不要把个人家目录为了测试而长期加入全局 PATH；这会让同名程序覆盖系统命令，增加排障与安全风险。

`whereis`：快速定位软件相关文件

1
2


whereis ls
whereis -b ls

whereis 查找预定义系统目录中的二进制文件、源码和手册页，适合快速了解软件安装位置。-b 只显示二进制文件。它不是“遍历整个硬盘”的工具；找不到结果不代表文件一定不存在。

按文件名找文件

1
2


find "$HOME" -type f -iname '*report*'
find /etc -type f -name '*.conf' 2>/dev/null

-iname 忽略大小写；第二个示例把权限错误重定向掉，避免干扰结果。搜索全盘前先限制目录，例如从 $HOME、/etc 或项目目录开始。

使用 locate 前先理解“索引”

1
2
3


locate ssh_config
locate -r '\bls$'
sudo updatedb

locate 查询的是文件名数据库，并不实时遍历磁盘；刚创建或删除的文件可能还没反映出来。Ubuntu 22.04 常使用 plocate 提供该功能，updatedb 会刷新索引，耗时与磁盘内容有关。原始资料的 locate -r '\bls$' 示例展示了用正则把宽泛的文件名匹配缩小到以 ls 结尾的路径。

`find`：在指定目录中精确搜索

1
2
3


find "$HOME" /bin -type f -name 'ls' 2>/dev/null
find "$HOME" -type f -iname '*report*'
find /etc -type f -name '*.conf' 2>/dev/null

find 直接遍历目录树，是最可靠也最灵活的工具。必须明确写出起始路径：未提供路径时，find 默认从当前目录 . 开始，而不是从根目录 / 开始。搜索全盘前先限制目录，例如从 $HOME、/etc 或项目目录开始。

出处

原始参考：linux 命令 which、whereis、locate、find 的区别（splinzer，知乎）
手册参考：GNU findutils 文档

本文已依据补充提供的原始 HTML 重新核对，并保留其“复制 ls、修改权限、刷新索引”的对比思路；具体行为仍以 Ubuntu 22.04 本机命令输出为准。

Ubuntu 22.04 与 Windows 11 双系统时间不一致

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

适用环境：Ubuntu 22.04 LTS + Windows 11 双系统。以下设置会影响主板 RTC 的解释方式；修改后请分别进入两套系统核对时区与自动校时。

双系统时间相差数小时，通常不是网络校时失败，而是两套系统对主板硬件时钟（RTC）的理解不同：Linux 通常把 RTC 视为 UTC，Windows 默认倾向把 RTC 当本地时间。

更适合双系统的做法：让 Ubuntu 使用本地 RTC

在保留 Windows 默认行为的情况下，可在 Ubuntu 执行：

1
2


sudo timedatectl set-local-rtc 1 --adjust-system-clock
timedatectl

看到 RTC in local TZ: yes 即表示设置生效。--adjust-system-clock 会根据当前 RTC 重新调整系统时钟；执行前确认 Ubuntu 的时区已设为正确的地区，例如：

1

timedatectl set-timezone Asia/Shanghai

另一种策略：让 Windows 使用 UTC

也可以通过 Windows 注册表让 Windows 使用 UTC。不过这会影响 Windows 恢复、休眠、与某些设备工具的兼容性，且变更应由熟悉 Windows 注册表的用户完成。对于普通的 Ubuntu + Windows 双系统，优先选择上面的 Ubuntu 侧设置，改动更集中、回退也更简单：

1

sudo timedatectl set-local-rtc 0 --adjust-system-clock

验证清单

在 Ubuntu 执行 timedatectl，确认时区与 NTP 同步状态。
重启进 Windows 11，确认时区自动设置正确。
再重启回 Ubuntu，核对时间没有偏移。

若时间每次开机都随机跳变，还应检查 BIOS 时间与主板 CMOS 电池，而不是反复修改系统设置。

出处

原始参考：解决 Ubuntu 和 Windows 双系统时间不同步（X_T_S，CSDN）
命令参考：timedatectl 手册

本文将原始 Windows 10 场景更新为 Windows 11，并采用 Ubuntu 22.04 可用的 timedatectl 方式。

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)（焦距，博客园）

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