Dolphin

Dolphin 是 KDE 的默认文件管理器。关于游戏机模拟器，请参见 Dolphin emulator。

安装

安装 dolphin 包。

扩展

ark：添加归档和压缩支持
audiocd-kio：添加音频 CD 支持
baloo：扩展标记支持（参见 #文件标记）
dolphin-plugins：添加 Git、Bazaar、Mercurial 和 Dropbox 支持以及一些挂载操作
kio-admin：允许以管理员身份管理文件
kio-gdrive：添加 Google Drive 支持（参见 #KIO slave）
kompare：添加“比较文件”对话框（或者，选择两个文件：*右键单击* > 打开方式 > *您的 diff 工具*）。
konsole：集成终端面板

注意某些扩展需要在“设置 > 配置 Dolphin... > 上下文菜单”或“菜单图标 > 配置 > 配置 Dolphin... > 上下文菜单”中启用。

文件预览

ffmpegthumbs：视频文件（基于 ffmpeg）
icoutils ：*.\*.ico*、*.\*.cur* 文件以及嵌入的 *.\*.exe* 图标
kde-thumbnailer-apk^AUR：Android 包文件
kdegraphics-thumbnailers：图像文件、PDF 和 Blender *.\*.blend* 文件
kdesdk-thumbnailers：缩略图系统的插件
kimageformats：Gimp *.\*.xcf* 文件、*.\*.heic* 文件（配合 libheif）
libappimage ：嵌入式 *.\*.AppImage* 图标
qt6-imageformats：*.\*.webp*、*.\*.tiff*、*.\*.tga*、*.\*.jp2* 文件
raw-thumbnailer^AUR：*.\*.raw* 文件
resvg：快速准确的 SVG 图像缩略图
taglib ：音频文件

注

特定文件类型的预览必须在“菜单图标 > 配置 > 配置 Dolphin... > 界面 > 预览”中启用。
预览可能无法在基于 fuse 的文件系统（例如 iOS）上工作。一种解决方法是将文件复制到普通文件系统，然后在该位置进行预览。
要启用 resvg 而不是内置的 SVG 缩略图生成器，请关闭“SVG 图像”。

配置

单击打开文件夹/文件

要配置单击打开项目，您需要从终端安装并运行 qt6ct，它将为您提供从“界面”选项卡启用单击（并更改主题等）的选项。

如果您使用 Kvantum 主题引擎 - 请使用 *kvantum manager > 配置活动主题 > 杂项 > 单击行为*。

更改默认终端模拟器

Dolphin 和其他 KDE 应用程序默认使用 konsole。要更改默认终端模拟器，请运行 kcmshell6 componentchooser 并选择您的终端模拟器，或在“其他...”弹出窗口中的选择字段中写入启动命令。（第二个选项将为此命令创建一个新的本地桌面条目。）

例如，要在 Dolphin 中启动 Alacritty 中的 tmux，在选择“其他...”后输入 alacritty -e tmux。

也可以通过修改配置文件 ~/.config/kdeglobals 直接更改此设置。例如，要使用 Alacritty，请在 [General] 部分添加

TerminalApplication=alacritty
TerminalService=Alacritty.desktop

其中 TerminalApplication 接受一个命令，TerminalService 接受一个桌面条目（TerminalService 似乎是可选的）。请注意，这不会影响 Dolphin 窗口内的终端（按 F4 打开）。

本文或本章节的准确性存在争议。

原因： 这（仅）在 KDE 中有效，可能与 Dolphin 无关，并且在许多其他 WM 中可能无效。（在 Talk:Dolphin 中讨论）

要更改 Dolphin 的内部终端窗口，请转到“键盘 > 快捷键”，选择您偏好的终端，并将“启动”快捷键设置为 Ctrl+Alt+T，这将覆盖 Konsole 的快捷键。请注意，这样打开的终端可能不会遵循终端配置文件中指定的背景颜色，但否则应与窗口中启动的实例相同。

KIO slave

Dolphin 使用 KIO slave 进行网络访问、回收站和其他功能，而 GTK 文件管理器则使用 GVFS。可用协议显示在地址栏（可编辑模式）中 [1]。要快速将其添加为书签，请在工作区右键单击，然后选择“添加到位置”。

您可以手动安装 KIO slave。例如，要在 Dolphin 中浏览您的 Google Drive，请安装 kio-gdrive。

技巧与窍门

文件标记

Dolphin 为文件标记提供了广泛的支持。通过右键单击文件并选择“分配标签”来为文件添加标签。文件的标签可以在“属性”菜单或“信息面板”中查看。要在“详细信息”视图模式的列中显示标签，请右键单击任何标题并从菜单中选择“标签”。

Dolphin 使用 user.xdg.tags 扩展属性将标签直接与每个文件一起存储。 Baloo 将这些标签索引到其自己的数据库中，以便更快地搜索，并维护一个所有已知标签的列表。
激活 Baloo 以在“位置”面板中显示所有索引标签的列表，并允许按标签搜索文件。

隐藏自定义文件/目录

可以通过创建一个 .hidden 文件（在同一目录中）来隐藏文件/目录，该文件包含应被隐藏的文件/目录的名称（每行一个）。

创建自定义服务菜单

可以通过在以下任一路径下创建特殊的 *.desktop 文件，向 Dolphin 添加自定义服务菜单项（参见 [2]）

~/.local/share/kio/servicemenus/
/usr/share/kio/servicemenus/

注意桌面条目必须是可执行的才能在 Dolphin 中显示！

gamemode.desktop

[Desktop Entry]
Type=Service
MimeType=application/*;
Actions=runWithGamemode

[Desktop Action runWithGamemode]
Name=Run with Gamemode
Name[de]=Mit Gamemode ausführen
Icon=input-gaming
Exec=gamemoderun %u

这会在所有 *应用程序* MIME 类型上添加一个 使用 Gamemode 运行 菜单项。

提示要为所有文件类型创建服务菜单，请使用 application/octet-stream MIME 类型。

故障排除

设备名称显示为“X GiB 硬盘”

创建文件系统标签或分区标签，Dolphin 将在该设备列表而不是大小中显示此标签。请参见 Persistent block device naming#by-label。

将文件移入回收站对外置驱动器耗时过长

为了将文件移入回收站，用户必须对回收站拥有独占的访问权限。其原因是您不希望他人看到您删除的内容。为此，在外置驱动器上创建了一个名为 .Trash-1000/ 的文件夹，权限模式为 700。

如果无法设置正确的访问权限，Dolphin 将（与 GNOME 不同）将文件移至主目录的回收站，这会花费一些时间。

要挂载 USB 棒/外置硬盘，Dolphin 使用 Udisks。FAT32 / EXFAT / NTFS 不支持 UNIX 文件权限，udisks 默认以 755 模式挂载它们。要配置 udisks 以 700 模式挂载这些驱动器，请查看文件 /etc/udisks2/mount_options.conf.example。复制该文件（名称应以 .conf 结尾），取消注释相关部分，并为这三个文件系统在带有 xyz_defaults 的行中添加选项 fmask=177,dmask=077。

(背景信息：[3]，[4])

透明字体

当使用 GTK Qt 样式时，选框中的字体可能会变得透明。原生 Qt 样式（如 Cleanlooks 和 Oxygen）不受影响。

挂载的 SMB 共享崩溃

参见 Samba#无法覆盖文件，权限错误。

图标未显示

如果图标未在 Dolphin 中显示，请安装并运行 qt6ct，在“图标主题”选项卡中选择一个图标主题，然后“应用”。

如果图标仍在 Dolphin 中未显示，请在您的 xprofile 中将 QT_QPA_PLATFORMTHEME 变量设置为 qt6ct。或者，使用平台主题标志启动 Dolphin

$ dolphin --platformtheme qt6ct

另外，请确保在您使用不常见、不完整的图标主题时安装并继承一个备用图标主题，如 hicolor 或 Adwaita。

图标过大

如果图标在 KDE 环境之外的 Dolphin 中过大，请使用以下命令启动它：

XDG_CURRENT_DESKTOP=KDE KDE_SESSION_VERSION=6 QT_AUTO_SCREEN_SCALE_FACTOR=0 dolphin

文件夹视图背景颜色不匹配

在 Plasma 以外的环境下运行 Dolphin 时，文件夹视图窗格的背景颜色可能与系统 Qt 主题不匹配。这是因为 Dolphin 从 ~/.config/kdeglobals 的 [Colors:View] 部分读取文件夹视图的背景颜色。将以下行更改为您偏好的 RGB 值（可以是 #RRGGBB 或 R,G,B 格式）

~/.config/kdeglobals

...
[Colors:View]
BackgroundNormal=#2E2E2E
...

如果您在文件夹视图窗格周围看到蓝色边框（如果您处于拆分视图，它只会出现在聚焦的窗格周围），您可以通过 qt6ct 应用程序应用 fusion-fixes.qss 样式表来消除它。此回答描述了如何在 GNOME 下为 Dolphin 使 Adwaita 暗色主题生效。

或者，使用 kvantum 来管理您的 Qt6 主题。有关使用说明，请参见 Kvantum 项目主页。

Zsh 配置文件未在集成终端中加载

本文或本章节的准确性存在争议。

原因：此问题不仅限于 Zsh；konsole（及其关联的 konsolepart）默认不启动登录 shell。zprofile 应在启动会话时由显示管理器加载（例如 SDDM 所做的[5][6]），而不是由终端模拟器加载。（在 Talk:Dolphin 中讨论）

如果您的 zsh 配置文件未加载，请尝试编辑当前配置文件。右键单击集成终端，然后选择“编辑当前配置文件...”，并将启动命令编辑为 /bin/zsh --login。

GTK 应用程序未使用 Dolphin

参见 Uniform look for Qt and GTK applications#在 KDE Plasma 下一致的文件对话框。

无法安装任何上下文菜单插件

当您转到 Dolphin 菜单“设置 > 配置 Dolphin > 上下文菜单 > 下载新服务”并尝试安装任何服务时，您会收到此错误消息：

/usr/bin/servicemenuinstaller: error while loading shared libraries: libpackagekitqt6.so.1: cannot open shared object file: No such file or directory

通过安装 packagekit-qt6 可以解决此问题。然后重新启动 Dolphin。

Dolphin 找不到应用程序（在其他窗口管理器下运行时）

通过安装 archlinux-xdg-menu 包并运行

$ XDG_MENU_PREFIX=arch- kbuildsycoca6 --noincremental

这会更新 KService 桌面文件系统配置缓存（参见 kbuildsycoca6(8)），许多 KDE 应用程序依赖此缓存来选择桌面条目。--noincremental 参数是可选的。需要 XDG_MENU_PREFIX，因为 archlinux-xdg-menu 创建了一个带有 arch- 前缀的 XDG 桌面菜单（参见 xdg-menu）。

XDG 桌面菜单文件可在 /etc/xdg/menus/*-applications.menu 中找到。

通常，kbuildsycoca6 不需要手动安装，因为它属于 kservice 包，而 kservice 包是 dolphin 的依赖项。

注意此解决方案仅重建缓存，并不保持更新。（pacman hooks 提供部分自动化。参见此处）

参见