KDE桌面系统

KDE 是一套由 Plasma 桌面环境、一系列的库、框架（KDE Frameworks）和一些应用组成的软件项目。KDE 上游有一份维护良好的 UserBase Wiki，在此可以找到大多数 KDE 应用的详细信息。

安装
Plasma 桌面
在安装 Plasma 之前，请确保 Xorg 已经被安装到您的系统中并可以正常工作。

安装 plasma-meta包 元软件包或者 plasma包组 组。 关于 plasma-meta包 和 plasma包组 两者的不同见元软件包与软件包组。若要使用 Plasma 的最小安装，请安装 plasma-desktop包 包。上游 KDE 有 软件包和安装推荐以获得功能齐全的 Plasma 会话。

欲启用 Wayland 支持，请安装 plasma-wayland-session包 软件包。NVIDIA显卡用户若使用私有的nvidia包驱动无法启动会话，请另行启用DRM内核级显示模式设置。如果还是无法正常运行，请查看 KDE wiki 中的操作指南。

提示：最小安装可能缺少部分使桌面体验更完整的软件包。若最小安装导致部分功能不按您的预期工作，请考虑更完整的安装。
Plasma Mobile
安装 plasma-mobileAUR。

KDE 应用
若要安装 KDE 的全套应用，请安装 kde-applications包组 组或 kde-applications-meta包 元软件包。若只需要安装特定类别的 KDE 应用（如游戏或教育），请只安装 kde-applications-meta包 中与此相关的依赖。请注意，此操作只安装应用，不会安装 Plasma 桌面。

不稳定版
见 Official repositories#kde-unstable。

启动 Plasma
注意： 虽然可以使用 Wayland 启动 Plasma，但 Plasma 仍存在一些缺失的功能和已知问题。问题清单见 Wayland Showstoppers，当前开发状况见 Plasma on Wayland workboard。使用 Xorg 以获得最完整和稳定的体验。
Plasma 可以通过显示管理器启动,也可以从控制台手动启动。

使用显示管理器
提示：推荐使用 SDDM 显示管理器。
选择 Plasma (X11) 以在Xorg下开启新会话。
选择 Plasma (Wayland) 以在Wayland下开启新会话。
选择 Plasma mobile (Wayland) 以在Wayland下开启新的Plasma mobile会话。
从控制台启动
若要使用 "xinit/startx" 启动 Plasma 桌面，请在 .xinitrc 文件中添加 export DESKTOP_SESSION=plasma 和 exec startplasma-x11。
若要在登录时开启 Xorg，见登录时启动 X。

要从控制台启动 Plasma on Wayland 会话，请运行 startplasma-wayland[1]。不需要通过 dbus-run-session 手动启动 dbus-session [2]。
配置
KDE应用的大部分配置存储于 ~/.config 目录下。KDE 主要使用"系统设置"调整配置，也可以在终端执行 systemsettings 启动它。

个性化
Plasma 桌面
主题
有不同类型的 KDE 主题，根据它们修改的范围而有所不同：

全局主题，全面的包，可以包括 Plasma 主题、应用程序样式、颜色、字体、图标、光标、启动屏幕、SDDM 主题和 Konsole 配色方案。
Plasma 视觉风格， 修改 Plasma 面板和小部件的外观。这些通常有一个推荐的 Kvantum 或 Aurorae 主题来完成外观。
应用程序风格，修改程序的外观。
使用主题引擎的应用程序样式，例如 Kvantum、QtCurve [3]、QSvgStyle [4] 以及 Aurorae。
#图标主题，为应用程序、文件和操作提供图标。
为了便于系统范围内的安装和更新，一些主题在 官方仓库 和 AUR 都可用。

全局主题亦可通过 系统设置 > 外观 > 全局主题 > 获取新的全局主题... 安装。

GTK 应用的外观
提示：若要使 Qt 和 GTK 应用程序主题一致，请阅读统一 Qt 和 GTK 应用程序的外观。
在 GTK 中推荐使用 breeze-gtk包 主题，这款 GTK 主题模仿了 Plasma 的 Breeze 主题。 安装 kde-gtk-config包（该软件是plasma包组 的一部分），在系统设置 > 外观 > 应用风格 > 配置 GNOME/GTK 应用风格中选择 Breeze 即可。

头像
Plasma和SDDM都会使用存在/var/lib/AccountsService/icons/的图像作为用户头像。要使用图形界面配置，你可以使用 系统设置 > 用户，这可能需要先进行安装（见plasma-desktop包包）。移除与用户名对应的文件可以恢复默认头像。

小部件
Plasmoids 是 Plasma 桌面 Shell 的小部件，旨在增强桌面功能，可查看 AUR。

Plasmoid 脚本也可以通过在面板或桌面上点击右键，选择添加小部件 > 获取新挂件… >下载新 Plasma 挂件 来安装。这将呈现一个 https://store.kde.org/ 的前端，您只需点击就可以安装、卸载或更新第三方 Plasmoid 脚本。

系统托盘中的声音小程序
安装 plasma-pa包 或 kmix包 (从程序启动器启动 Kmix)。前者已自动安装，无需另外设置。

注意： 若要调整 音量单次增减的长度，请将例如 VolumePercentageStep=1 （后面的数字代表长度）的一行文字添加到 ~/.kde4/share/config/kmixrc 的 [Global] 部分中。
系统托盘中的网络管理器
如果您使用 networkmanager包，那么请安装 plasma-nm包。

禁用面板阴影
因为 Plasma 的面板在其他窗口之上，所以其阴影也会渲染在其他窗口之上。[5] 若要在不影响其他阴影的情况下禁用此行为，安装 xorg-xprop包 并运行:

$ xprop -remove _KDE_NET_WM_SHADOW
然后用增大的光标选择面板。[6] 若要自动化此操作，请安装 xorg-xwininfo包 并创建以下脚本：

/usr/local/bin/kde-no-shadow
#!/bin/bash
for WID in $(xwininfo -root -tree | sed '/"Plasma": ("plasmashell" "plasmashell")/!d; s/^  *\([^ ]*\) .*/\1/g'); do
   xprop -id $WID -remove _KDE_NET_WM_SHADOW
done
并添加此脚本的可执行权限。

在自动启动的添加脚本中添加此脚本，可以使其在登录时启动：

$ kcmshell5 autostart
显示缩放/高DPI显示
见 HiDPI#KDE。

Plasma Mobile
要在小屏幕上使用Plasma Mobile，可以全局设置(/etc/xdg)或分别设置用户目录中的~/.config文件，plasma-phone-settings有部分设置选项。

应用黑名单
/etc/xdg/applications-blacklistrc （或 ~/.config/applications-blacklistrc） 文件将应用从菜单/启动器中移除以便清理界面。

KDE 全局
/etc/xdg/kdeglobals （或 ~/.config/kdeglobals）控制以下设置：

设置网络浏览器为 Angelfish。
设置界面外观 (org.kde.plasma.phone)。例如窗口最大化后不显示标题栏。
锁屏
/etc/xdg/kscreenlockerrc （或 ~/.config/kscreenlockerrc） 可配置登录后立即锁屏。这在使用SDDM#自动登录功能时会很有用。

KWin
/etc/xdg/kwinrc （或 ~/.config/kwinrc）控制以下设置：

关闭模糊以提升性能
启用Maliit虚拟键盘
窗口装饰
可在 系统设置 > 应用程序风格 > 窗口装饰 中设置窗口装饰。

您也可以在AUR上中直接下载并安装更多主题。

图标主题
可在 系统设置 > 图标 中安装或改变图标主题。

注意： 虽然所有现代的Linux发行版都共享统一的图标主题格式，但像 GNOME这样的桌面使用更少的图标（特别是在工具栏和菜单中）。为这些桌面开发的主题一般都缺少 Plasma 和 KDE 应用需要的图标。建议安装与 Plasma 兼容的主题。
提示：部分图标主题不从默认图标主题中引入图标，这将导致部分图标缺失。要想从默认图标主题中导入缺失图标，把breeze添加到 /usr/share/icon/theme-name/index.theme的Inherits= 中，比如Inherits=breeze,hicolor。每次更新图标主题时都需要重新使用这个补丁，尝试使用Pacman hooks来自动完成这项任务。
空间效率
Plasma Netbool shell （上网本交互界面）已从 Plasma 5 中移除，请阅此KDE论坛帖子。但您仍然可以通过编辑 ~/.config/kwinrc，在 [Windows] 部分加上 BorderlessMaximizedWindows=true 来实现类似的操作。

缩略图生成
若要在桌面和 Dolphin 内为媒体或文档文件生成缩略图，安装 kdegraphics-thumbnailers包 和 ffmpegthumbs包。

然后在 桌面背景 > 配置桌面 > 图标 > 更多预览选项... 内通过 右键单击 启用桌面的缩略图类别。

在 Dolphin 中，进入 控制 > 通用 > 预览。

夜间模式
Plasma提供了一种类似 Redshift 的特性(在 Xorg 和Wayland 上都可以使用)，称为夜间模式。它使屏幕上的颜色呈现更暖的色调，以在指定的时间里减少眼睛疲劳。 您可以在 系统设置 -> 显示和屏幕 -> 夜间模式 中启动该功能。

提示：要获得便捷的系统托盘夜间模式开关，您需要 kdeplasma-addons包 以添加。
打印
提示：使用 CUPS 的 Web 接口进行快速配置。这种方式配置的打印机可以被 KDE 应用使用。
您也可以在 系统设置 > 打印机配置 中配置打印机。要使用这种配置方式，必须首先安装 print-manager包 和 cups包 软件包。请阅CUPS配置

Samba/Windows 支持
若要使用 Windows 服务，安装 Samba (samba包 软件包)。

Dophin 的共享服务需要 kdenetwork-filesharing包 软件包以及 usershares。关于如何配置usershares（在不启动 smb.conf 的情况下），见建立 Usershare 路径。重新启动Samba后，应无需进一步配置Dolphin的共享。

提示：在 Dolphin 命令行中，无授权认证访问 Windows 共享时，用户名以及密码将使用 * （星号）表示。
不像 GTK 文件浏览器利用 GVfs 启动程序，如果在 Dolphin 中通过 KIO 打开 Samba 共享的文件，大多数程序中 Plasma 会先把整个文件复制到本地系统（除了 VLC）。 使用基于GTK的文件浏览器可以解决此问题，如 thunar包 和 gvfs-smb包 可以更有效地访问SMB共享（同时要安装 gnome-keyring包以保存登录凭证）。

另一种方法则是使用 cifs-utils包 挂载 Samba 共享从而让 Plasma 把 SMB 共享当成一个普通的本地文件夹从而正常访问。见手动挂载和自动挂载。

另一种简单的GUI解决方法则是使用 samba-mounter-gitAUR。它在 系统设置 > 网络驱动 中提供了基本相同的功能。要注意，在新版 KDE Plasma 中此应用可能会崩溃。

KDE 桌面活动
KDE 桌面活动是一种类似于"虚拟桌面"的 Plasma 组件，您可以独立设置特定的活动。 只有在您正在使用这个活动时，这些设定才会生效。

电源管理
安装 powerdevil包 以使用 KDE 内置的 "PowerDevil 电源管理"的节能服务，它可以调整系统的节能配置、屏幕亮度（如果支持）并提供详细的电源报告。

提示：电源配置文件 的集成需要 power-profiles-daemon 可选依赖。
本文或本章节的事实准确性存在争议。

原因： 根据下面的注意内容，问题也可能是因为 logind 中 LidSwitchIgnoreInhibited 的默认值是 yes，见 [7]（在 Talk:KDE 中讨论）

注意： Powerdevil 可能无法 覆盖 所有的 logind 设置(例如笔记本合盖动作). 如果遇到这样的问题，需要修改logind的设置，请参考 电源管理。
自启动
Plasma 可以在启动和关闭时自动启动应用程序并运行shell脚本。若要自动启动应用程序，请进入 系统设置 > 开关机 > 自启动 并添加您想要的程序或shell脚本。若选择程序，则会创建一个 .desktop 文件；选择脚本，则会创建一个用来启动脚本的 .desktop 文件。

注意：
程序只能在登录时自启动，而shell脚本也可以在关机和 Plasma 启动前启动。
Shell脚本需要可执行权限才能运行。
之前位于 ~/.config/autostart-scripts/ 的 Shell 脚本会被自动迁移到 .desktop 文件。
将桌面配置项（即 .desktop 文件）放入适当的 XDG Autostart 目录。
在以下目录之一放置 shell 脚本或其符号链接：
~/.config/plasma-workspace/env: 在 Plasma 启动前启动脚本。
~/.config/plasma-workspace/shutdown: 在关机时启动脚本。
见官方文档。

Phonon
摘自维基百科：

Phonon 是 KDE 的多媒体 API, 提供了多个多媒体框架的抽象，为 KDE 和一些 QT 程序提供多媒体流处理功能。
Phonon 最初的目的，是让 KDE 和 Qt 软件独立于其他多媒体框架（例如GStreamer或xine），并为其提供一个稳定的 API。
KDE 广泛地将 Phonon 用于音频（例如系统通知或者 KDE 声音应用）和视频（例如 Dolphin 中的视频缩略图）中。它可以使用以下后端：

VLC: phonon-qt5-vlc包
GStreamer: phonon-qt5-gstreamer包, see GStreamer#Installation for additional codec support
mpv: phonon-qt5-mpvAUR, phonon-qt5-mpv-gitAUR
KDE 仅推荐VLC后端。GStreamer不再维护，但知名Linux发行版（Kubuntu和Fedora-KDE等）使用GStreamer作为默认后端，因为这样可以在默认安装时避免引入专有MPEG代码。

注意：
可以同时安装多个后端，并在 系统设置 > 多媒体 > 后端 中进行优先级设定。
根据 KDE 这个帖子, VLC 后端不支持 ReplayGain。
如果使用 VLC 后端，可能会遇到崩溃问题，如在每次 Plasma 发送语音警告时崩溃等等，详见 [8]。重建VLC插件缓存也许能解决问题：
# /usr/lib/vlc/vlc-cache-gen -f /usr/lib/vlc/plugins
备份与恢复
KDE Plasma 5 将个性化配置以配置文件的形式储存在 XDG_CONFIG_HOME 中。参照 KDE 的配置文件 并选择 恰当的备份恢复方案。

systemd启动
自Plasam5.25起，默认启动方式更改为使用systemd 用户服务实例来启动或管理所有Plasma服务。可以关闭该方法并使用基于脚本的启动，使用下列命令（此方法在未来版本中可能会停用）：

$ kwriteconfig5 --file startkderc --group General --key systemdBoot false
更多关于该方法的实现细节可以参考 "Edmundson's blog: plasma and the systemd startup"。

拼写检查
KDE 使用 sonnet包 提供拼写检查功能。查看它的可选依赖以获取支持的拼写检查。

可在 系统设置->区域设置->拼写检查 配置拼写检查。

使用NVIDIA显卡运行kwin wayland
见 https://community.kde.org/Plasma/Wayland/Nvidia 。

应用程序
KDE项目提供了一套与Plasma桌面集成的应用程序。有关可用应用程序的完整列表，详见 kde-applications包组 软件包。另见 KDE 相关应用页面。

除了 KDE 应用程序包提供的程序之外，还有许多其他可用于补充 Plasma 的应用程序。其中一些将在下面讨论。

系统管理
KDE 系统设置中配置终止 Xorg-server
浏览到子菜单：

   系统设置 > 硬件 > 输入设备 > 键盘 > 高级（标签） > "Key Sequence to kill the X server" 
然后选中复选框。

KCM
KCM 意为 KDE 配置模块（KConfig Module）。这些模块在系统设置中提供了界面从而帮助您配置系统，或通过命令行（kcmshell5）。

sddm-kcm — SDDM 的 KDE 配置模块
https://invent.kde.org/plasma/sddm-kcm || sddm-kcm包
kde-gtk-config — GTK2 和 GTK3 的 KDE 配置器。
https://invent.kde.org/plasma/kde-gtk-config || kde-gtk-config包
System policies — 允许管理员改变 PolicyKit 设置的配置模块集。
https://invent.kde.org/system/polkit-kde-kcmodules-1 || kcm-polkit-kde-gitAUR
wacom tablet — KDE Wacom 驱动的图形界面。
https://www.linux-apps.com/p/1127862/ || kcm-wacomtablet包
Kcmsystemd — KDE 系统控制模块。
https://github.com/rthomsen/kcmsystemd || systemd-kcmAUR
可在 linux-apps.com 找到更多的 KCM 。

桌面搜索
KDE 使用 Baloo 索引与查找文件。

Web 浏览器
下列浏览器可以与 Plasma 集成：

Konqueror — KDE项目的一部分, 支持两种渲染引擎 – KHTML 和基于Chromium的 Qt Web引擎。
https://konqueror.org/ || konqueror包
QupZilla — 包含 Plasma 集成特性的 Qt web 浏览器。其使用 Qt Web引擎。
https://github.com/QupZilla/qupzilla || qupzilla包[损坏的链接：package not found]
Chromium — Chromium 及它的专有版本 Google Chrome 具有有限的 Plasma 集成。 它们可以使用 KWallet 以及 KDE 窗口 打开/保存。
https://www.chromium.org/ || chromium包
Firefox — Firefox 可以通过配置以和 Plasma 更好地集成。参考 Firefox KDE整合。
https://mozilla.org/firefox || firefox包
个人信息管理（PIM）
KDE 提供了自有的个人信息管理（PIM）存储，包括电子邮件，联系人，日历等。可以使用 kde-pim包组 安装包组或 kde-pim-meta包 元软件包安装所有 PIM 软件包。

Akonadi
Akonadi 是系统中本地缓存各种来源的 PIM 数据的一种方法，接着这些数据可以被其它的应用使用。这包含了用户的邮件、联系人、日历、事件、刊物、闹钟、笔记等。Akonadi 自身并不存储任何数据：存储格式依赖于数据的性质（例如，联系人可能以 vcard 格式存储）。

安装 akonadi包. 若需其他插件，安装 kdepim-addons包。

注意：
若要使用除 MariaDB/MySQL 以外的数据库引擎，请在安装 akonadi包 包时使用以下命令从而跳过 mariadb包 依赖项的安装:
# pacman -S akonadi --assume-installed mariadb
另见 FS#32878。
如果Akonadi第一次启动找不到/usr/bin/mysqld，它会尝试使用SQLite作为后备。
MySQL
默认情况下Akonadi将使用/usr/bin/mysqld (MariaDB 默认, 参考 MySQL 来寻找替代方案) 去运行一个被管理的 MySQL 实例并且将数据存储在 ~/.local/share/akonadi/db_data/.

系统级 MySQL 实例
Akonadi 支持将系统范围的 MySQL 用于其数据库。[9]

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QMYSQL

[QMYSQL]
Host=
Name=akonadi_username
Options="UNIX_SOCKET=/run/mysqld/mysqld.sock"
StartServer=false
PostgreSQL
Akonadi 支持使用现有的系统范围 PostgreSQL 实例，即 postgresql.service，或运行具有用户权限的 PostgreSQL 实例和 ~/.local/share/ 中的数据库akonadi/db_data/。

每用户 PostgreSQL 实例
安装 postgresql包 和 postgresql-old-upgrade包。

编辑 Akonadi 配置文件，使其具有以下内容：

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QPSQL
注意：
当 Akonadi 启动时，它将创建 [QPSQL] 部分并在其中设置适当的变量。
数据库将被存储在 ~/.local/share/akonadi/db_data/。
使用 akonadictl start 启动 Akonadi，然后使用 akonadictl status 检查其状态。

注意：
从 akonadi包 19.08.0-1 开始，当检测到主要的 PostgreSQL 版本升级时，~/.local/share/akonadi/db_data/ 中的 PostgreSQL 数据库集群将自动升级。
对于以前的 akonadi包 版本，主要的 PostgreSQL 版本升级将需要手动数据库升级。遵循 KDE UserBase Wiki 上的更新说明。确保将 PostgreSQL 二进制文件的路径调整为 postgresql包 和 postgresql-old-upgrade包 使用的路径，请参阅 PostgreSQL#Upgrading PostgreSQL。
系统范围的 PostgreSQL 实例
这需要一个已经配置并正在运行的 PostgreSQL。

为您的用户创建一个 PostgreSQL 用户帐户：

[postgres]$ createuser username
为 Akonadi 创建一个数据库：

[postgres]$ createdb -O username -E UTF8 --locale=C -T template0 akonadi-username
配置 Akonadi 以使用系统范围的 PostgreSQL：

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QPSQL

[QPSQL]
Host=/run/postgresql
Name=akonadi-username
StartServer=false
注意： 可以使用 [QPSQL] 部分中的选项 Port=、User=、Password= 指定自定义端口、用户名和密码。
使用 akonadictl start 启动 Akonadi，并检查其状态：akonadictl status。

SQLite
编辑Akonadi配置文件以匹配以下配置：

~/.config/akonadi/akonadiserverrc
[%General]
Driver=QSQLITE
注意：
当 Akonadi 启动时，它将创建 [QSQLITE] 部分并在其中设置适当的变量。
数据库存储在 ~/.local/share/akonadi/akonadi.db。
禁用 Akonadi
想要禁用 Akonadi 的用户不需要启动任何依赖它的 KDE 应用程序。有关详细信息，请参阅此 在 KDE 用户库中的部分。

KDE Telepathy
本文内容或本节内容已经过期。

原因： telepathy-kde-meta包[损坏的链接：package not found]和telepathy-kde包组[损坏的链接：package not found]已被从Arch extra仓库中移除。部分在AUR中的Telepathy组件看起来仍然可用。 (在Talk:KDE讨论)
KDE Telepathy 是一个把即时信息功能紧密整合到 KDE 桌面中的项目。它使用 Telepathy 框架作为后端，意在替代 Kopete。

若要安装所有 Telepathy 协议，安装 telepathy包组 组。 若要使用 KDE Telepathy 客户端，安装 telepathy-kde-meta包 元软件包，它包含了所有在 telepathy-kde包组 组中的软件包。

在 KDE Telepathy 中使用 Telegram
注意： telegram-purple 已被放弃。另见Diff/704779。As mentioned in the previous links, telegram-tdlib-purple-gitAUR is its successor package.
Telegram 协议需要使用 telepathy-hazeAUR, 安装 telegram-purpleAUR 或 telegram-purple-gitAUR 和 telepathy-morse-gitAUR。用户名是 Telegram 账户电话号码 (加国家前缀 +xx，例如德国是 +49).

通过图形界面进行配置可能会很棘手：如果在KDE Telepathy客户端中配置新帐户时不接受电话号码（出现一个错误信息表明参数无效并阻止创建账户），请把其添加在单引号中，并在帐号创建好后从配置文件（~/.local/share/telepathy/mission-control/accounts.cfg）中手动移除引号（如果引号未被移除，会发生认证错误）。

注意： 配置文件应当在 KDE Telepathy 未运行时手动编辑，例如当 KDE 桌面未激活时，否则手动更改可能会被软件覆盖。
KDE Connect
KDE Connect 提供了一些功能以将 Android 或 iOS 手机与Linux桌面连接：

从任何应用向 KDE 共享文件和 URL 或从 KDE 向任何应用共享，无需连线。
触摸板模拟：将手机屏幕用作计算机的触摸板。
通知同步（4.3+）：从桌面读取您的安卓通知。
共享剪贴板：在手机和电脑之间复制粘贴。
多媒体远程控制：将手机用作 Linux 媒体播放器的遥控器。
WiFi 连接：不需要 usb 和蓝牙。
RSA加密：保证您的信息安全。
您需要同时在电脑和安卓上安装 KDE Connect。PC端上安装 kdeconnect包 软件包，而安卓端可以在 Google Play 或 F-Droid 上安装 KDE Connect。如果你想浏览手机上的文件系统，你需要去 安装 sshfs包 同时在手机app上设置文件系统可被访问。对于 iOS，从 App Store 安装 KDE Connect。并非 Android 版本的所有功能都可用于 iOS 版本。

要在Plasma Wayland会话上使用远程输入功能，需要安装xdg-desktop-portal包。

即使不使用 Plasma 桌面，您也可以使用 KDE Connect。对于使用 AppIndicator的桌面环境（如Unity），还需要安装 indicator-kdeconnectAUR[损坏的链接：package not found]软件包。对于 GNOME 用户，可以通过安装 gnome-shell-extension-gsconnectAUR 获得更好地集成，而不是安装 kdeconnect包。如果要手动启动 KDE Connect 进程, 运行 /usr/lib/kdeconnectd。

如果你使用 firewall, 你需要打开 UDP 和 TCP 端口 1714 和 1764。

有些时候, KDE Connect 不会检测到你的手机。 你可以通过杀死KDE Connect进程 killall kdeconnectd 之后在系统设置里打开 kdeconnect 或者运行 kdeconnect-cli --refresh 后运行 kdeconnect-cli -l。您亦可在 KDE Connect for Android 上使用 配对新设备 > 以 IP 添加设备 （仅大意）。

提示和技巧
使用不同的窗口管理器
可以使用其它窗口管理器替换Plasma自带的KWin窗口管理器。这使你能够将KDE桌面的功能与平铺窗口管理器（tiling window manager）的特性结合起来，这样做可能会比KWin的平铺脚本的效果更丰富。

Plasma中的组件选择设置不再允许更改窗口管理器，但仍然可以通过其它方法替换KWin服务。

注意： 当您用不包含混成器的窗口管理器（例如 Openbox）替换 Kwin 时，任何桌面特殊效果都会失效（例如窗口透明度）。在这种情况下，请安装并运行其他独立的混成器，如 Xcompmgr 或 picom 。
替换KWin服务
自KDE 5.25，Plasma默认使用基于systemd的启动。

要在此启动方式中替换KWin，首先为当前用户禁用（mask）plasma-kwin_x11.service服务避免KWin启动。

接下来创建（create）一个新的systemd用户单元（user unit）来启动你选择的窗口管理器[10]：

~/.config/systemd/user/plasma-custom-wm.service
[Install]
WantedBy=plasma-workspace.target
 
[Unit]
Description=Plasma Custom Window Manager
Before=plasma-workspace.target
 
[Service]
ExecStart=/path/to/other/wm
Slice=session.slice
Restart=on-failure
最后重新扫描（daemon-reload）用户单元（user unit），确保Kwin服务plasma-kwin_x11.service已经禁用（mask），然后启用（enable）新的plasma-custom-wm.service窗口管理器服务。

提示：当使用i3窗口管理器时，需要手动设置对话窗以浮动模式打开以确保显示正确。更多信息见i3#Correct handling of floating dialogs。
使用基于脚本的启动和KDEWM环境变量
关闭#systemd启动使Plasma以基于脚本的方式启动。如果是这种情况你可以在Plasma启动前设置KDEWM 环境变量（ environment variable ）来切换窗口管理器。

KDE/Openbox 会话
软件包 openbox包 为在plasma下使用 Openbox 提供了会话. 要使用这个会话，请在 display manager 菜单中选择 KDE/Openbox .

若要手动启动会话，请将下面这行添加到您的 xinit 配置中：

~/.xinitrc
exec openbox-kde-session
KWin 平铺窗口脚本
本文或本章节的语言、语法或风格需要改进。参考：Help:Style

原因：Use Template:App.（在Talk:KDE讨论）
Bismuth，Polonium 和 Kröhnkite 是自动平铺窗口并允许你用键盘控制它们的 Kwin 扩展组件。

KZones 是一个模仿 PowerToys 的 "Fancy Zones" 功能的 KWin 脚本。

配置显示器分辨率 / 多显示器
若要在 Plasma 中启用分辨率和多显示器管理, 请安装 kscreen包. 它在 系统设置 > 显示 中添加了更多选项.

配置 ICC 色彩矫正
若要在Plasma中启用 ICC 配置文件，请先安装colord-kde包，它会在系统设置中添加色彩校正选项。

使用"添加配置文件"可以导入ICC配置文件。

禁用使用 Super 键（Windows 键）打开应用程序启动器
若要禁用此功能，请运行以下命令：

$ kwriteconfig5 --file kwinrc --group ModifierOnlyShortcuts --key Meta ""
在应用程序菜单中禁用书签
安装了Plasma Browser集成后，KDE将在应用程序启动器中显示书签。

要禁用此功能，您可以运行以下命令：

$ mkdir ~/.local/share/kservices5
$ sed 's/EnabledByDefault=true$/EnabledByDefault=false/' /usr/share/kservices5/plasma-runner-bookmarks.desktop > ~/.local/share/kservices5/plasma-runner-bookmarks.desktop
IBus 集成
IBus是一个输入法框架，可以集成到KDE中。有关详细信息，请参阅 IBus#Integration。

在 Wayland 上使用 KDE 以提供重音字符和死键支持时，可能需要使用 IBus [11]。

在 plasma-nm 中启用热点
参见 NetworkManager#通过Wi-Fi共享网络连接。

恢复以前保存的会话
如果您选择了系统设置 > 启动和关闭 > 桌面会话 > 登录时：恢复以前保存的会话（默认），ksmserver（KDE 的会话管理器）将在注销时自动将所有打开的应用程序保存/加载到/从 ~/.config/ksmserverrc 注销/登录。

注意： 目前，无法恢复原生 Wayland 窗口。有关当前开发状态​​，请参阅 Wayland Showstoppers。
在 KMail 中接收本地邮件
如果您使用 Maildir 格式的 mail server 设置了本地邮件传递，您可能希望在 KMail 中接收此邮件。为此，您可以重新使用 KMail 的默认接收帐户“本地文件夹”，该帐户将邮件存储在 ~/.local/share/local-mail/ 中。

将 ~/Maildir 目录（通常发送 Maildir 格式邮件的地方）符号链接到本地文件夹的收件箱：

$ ln -s .local/share/local-mail/inbox ~/Maildir
或者，添加一个类型为“Maildir”的新接收帐户并将 ~/Maildir 设置为其目录。

为所有用户配置 Plasma
编辑 /usr/share/plasma 中的 config/main.xml 文件。例如，要为所有用户配置应用程序启动器，请编辑 /usr/share/plasma/plasmoids/org.kde.plasma.kickoff/contents/config/main.xml。要防止文件被包更新覆盖，请将文件添加到 Pacman's NoUpgrade

禁用休眠
本文或本章节可能需要合并到Power management。

附注： 此不限于 KDE。可将本节作为一个存根链接，指向该节。（在 Talk:KDE 中讨论）
使用 Polkit 策略规则正确禁用休眠功能并将其从菜单中隐藏。

/etc/polkit-1/rules.d/99-disable-hibernate.rules
// Disable hibernate for all users
polkit.addRule(function(action, subject) {
   if ((action.id == "org.freedesktop.login1.hibernate")) {
      return polkit.Result.NO;
   }
});
polkit.addRule(function(action, subject) {
   if ((action.id == "org.freedesktop.login1.hibernate-multiple-sessions")) {
      return polkit.Result.NO;
   }
});
或者，添加以下行到在 /etc/systemd/sleep.conf.d/ 中的一个文件：

/etc/systemd/sleep.conf.d/00-disable-hibernation.conf
[Sleep]

AllowHibernation=no

AllowSuspendThenHibernate=no

AllowHybridSleep=no
窗口规则
Kwin 能够为特定的窗口/应用程序指定规则。例如，即使应用程序开发人员没有启用窗口标题栏，您也可以强制启用。 您可以设置特定的位置，大小，最小化状态，保持最前/后以及其他规则。

要创建规则，您可以在特定窗口处于焦点时按 Alt+F3。 然后，在"更多操作>配置特殊应用程序设置/窗口设置"中，您可以设置所需的属性。 创建的规则列表可从"系统设置>窗口管理>窗口规则"中获取。

虚拟键盘
没有默认的虚拟键盘，可从 List of applications/Utilities#On-screen keyboards 中选取合适的，例如 Maliit，然后在系统设置里启用。

疑难解答
字体
字体在Plasma会话中看起来发虚
尝试安装 ttf-dejavu包 和 ttf-liberation包 包。

安装后，请确保登出并重新登录。无需修改 系统设置 > 字体 中的任何选项。如果您正在使用 qt5ct包，Qt5 配置工具中的设置可能会覆盖系统设置中的字体设置。

如果您设置了字体的渲染方式，请注意系统设置可能会改变它们的外观。当您进入 系统设置 > 字体 时，系统设置可能会改变您的字体配置文件(Fonts.conf)。

这是无法避免的，但是，如果您设置的字体与fonts.conf 文件匹配，则将返回预期的字体渲染效果（这将要求您重新启动应用程序或在重新登录您的桌面）。请注意，Gnome 的"字体首选项"也可以执行此操作。

字体很大或看起来不成比例
尝试在 系统设置 > 字体 中强制字体DPI为 96 。

如果不起作用，请尝试按照 Xorg#手动设置DPI 中的说明直接在Xorg配置文件中设置DPI。

有关配置的问题
KDE 中许多问题都跟配置相关。

Plasma 桌面行为异常
Plasma 故障通常是由不稳定的 plasma 小部件（plasmoids）或者 plasma 主题引起的。首先寻找最近安装的 plasmoid 或者 plasma 主题并禁用或者卸载它。

因此，如果您的桌面突然被"锁定"了，很可能是由于安装了有问题的组件造成的。如果您不记得故障发生前您安装了什么小部件（有时它可能是一个不寻常的问题），请通过逐个移除小部件直到问题不再出现。然后您可以卸载这个小部件并提交一份缺陷报告，若是官方小部件时到KDE 缺陷跟踪页提交一份缺陷报告。如果它不是，您可以在 https://store.kde.org/ 上寻找它的条目并告知小部件的开发者您所碰到的问题（以及再现它的详细步骤等）。

如果您找不到问题，也不想丢失所有设置，浏览到~/.config：

$ for j in plasma*; do mv -- "$j" "${j%}.bak"; done
这个命令会将所有用户中跟 Plasma 有关的设置重命名为 *.bak （例如 plasmarc.bak），并且当重新登录 Plasma 时，将会恢复默认设置。若要撤销该操作，请删除.bak文件扩展名。若已有 *.bak 文件，请先重命名，移动或删除它们。强烈建议您经常备份。 有关可能的方案列表，见同步和备份程序（英文）。

清理缓存以解决升级故障
此故障可能由旧的缓存导致。有时，升级后旧缓存可能会产生奇怪的、难以调试的行为，例如关不掉的 shell、改变设置时失去响应、以及像 ark 不能解压 rar/zip 文件又或者 amarok 不能识别音乐等各种其它问题。这个办法也能解决 KDE 和 Qt 程序在升级后变得难看的问题。

用以下命令来重建缓存：

$ rm ~/.config/Trolltech.conf
$ kbuildsycoca5 --noincremental
或者，清空 ~/.cache/ 文件夹内容，但是，这也会清除其他应用程序的缓存：

$ rm -rf ~/.cache/*
Plasma 桌面不尊重区域设置/语言设置
Plasma 桌面可能使用与您在 KDE 系统设置面板或 locale.conf 中设置的设置不同的设置（根据 Locale#Variables）。首先要做的是注销并在删除 ~/.config/plasma-localerc 后登录，如果这不能解决问题，请尝试手动编辑文件。例如，将 LANG 变量设置为 zh_CN.UTF-8 并将 LC_MESSAGES 变量设置为 en_US.UTF-8：

~/.config/plasma-localerc
[Formats]
LANG=zh_CN.UTF-8

[Translations]
LANGUAGE=zh_CN:en_US
不能在系统设置中更改主题、图标、字体、颜色;大多数图标不显示
确保 QT_QPA_PLATFORMTHEME 在 环境变量 未设置，命令 printenv QT_QPA_PLATFORMTHEME 输出应该为空。否则，如果您设置了环境（很可能是 qt5ct），该变量将在 Qt 应用程序上强制设置 qt5ct，命令 export QT_QPA_PLATFORMTHEME= 应该取消设置环境。

一个更简单（更可靠）的解决方案是完全卸载 qt5ct。

音量控制、通知或多媒体键不起作用
隐藏系统托盘设置中的某些项(如音频音量、媒体播放器或通知)也会禁用相关功能。隐藏“音频音量”会禁用音量控制键，“媒体播放器”会禁用多媒体键（倒带、停止、暂停），隐藏“通知”会禁用显示通知。

登录界面不会将光标设置同步到SDDM
登录界面从~/.config/kcminputrc读取您的光标设置，如果没有此文件，则不会同步任何设置。生成此文件的最简单方法是在 系统设置 > 光标 中更改光标主题，然后将其更改回首选的光标主题。

缺少面板/小部件
崩溃或硬件更改可以修改屏幕编号，即使在单个显示器设置上也是如此。此类事件后面板/小部件可能会丢失，这可以通过在 ~/.config/plasma-org.kde.plasma.desktop-appletsrc 文件中修复 lastScreen 值解决。

图形问题
请先确保您已安装了适合您 GPU 的驱动程序。详见 Xorg#Driver installation。如果您的显卡较旧，您可以尝试 #禁用桌面特效 或 #禁用混成。

获取KWin的当前状态以用于获得帮助和调试
该命令打印出KWin当前状态的摘要，包括使用的选项，使用的合成后端以及相关的OpenGL驱动程序功能。详见Martin's blog。

$ qdbus org.kde.KWin /KWin org.kde.KWin.supportInformation
禁用桌面特效
Plasma 默认启用了桌面特效，并且不是所有的游戏都会自动禁用它们。您可以通过系统设置 > 桌面特效 禁用桌面特效。您也可以使用 Alt+Shift+F12 切换桌面效果。

另外，您也可以在 系统设置 > 窗口管理 > 窗口规则 下创建自定义KWin规则，以在某个应用程序/窗口启动时自动禁用/启用混合项。

启用透明功能
如果使用透明背景而不启用合成器，则会收到以下消息：

配色方案使用的透明背景在您的桌面上似乎不受支持
在 系统设置 > 显示和监视 > 合成器 中，选中 启动时开启混成 并重新启动Plasma。

禁用混成
在 系统设置 > 显示中取消选中启动时激活混成器并重启 Plasma。

启用混成时全屏状态会闪烁
在 系统设置 > 显示中取消选中允许应用程序阻止混成。这可能会影响性能。

Nvidia 显卡屏幕撕裂
提示：翻译人员使用，请无视本提示。英文页面将本章搬到了 NVIDIA/Troubleshooting ，但中文没有此界面，故保留此章
默认情况下，KWin 混合项在与 Nvidia 闭源驱动一起使用时会遭受屏幕撕裂。要解决此问题，运行 kwin_x11 --replace 并在其之前陈述环境变量 export __GL_YIELD="USLEEP"：

export __GL_YIELD="USLEEP" && kwin_x11 --replace
与使用全局环境变量不同，这只会影响 KWin，并不会降低其他 3D 应用程序的 CPU 性能。也可以通过在 Plasma 的 ~/.config/autostart-scripts 文件夹中创建一个简单的脚本，使其在登录时自动执行。

~/.config/autostart-scripts/restartkwinusleep.sh
(sleep 2s &&
export __GL_YIELD="USLEEP" && kwin_x11 --replace
)

sleep 参数有助于防止 KWin 在登录后过早重新启动时出现问题，可以根据需要调整时间。 不要忘记将脚本标记为可执行文件。

Plasma 光标有时显示不正确
创建 ~/.icons/default 目录并在其内创建一个包含以下内容的 index.theme 的文件：

/home/archie/.icons/default/index.theme
[Icon Theme]
Inherits=breeze_cursors
执行以下命令：

$ ln -s /usr/share/icons/breeze_cursors/cursors ~/.icons/default/cursors
更改角色时（例如，将鼠标悬停在超链接上时）光标抖动/闪烁
尝试为系统和窗口管理器安装适当的2D加速驱动程序。

屏幕分辨率设置不可用
您的kscreen本地配置设置可以覆盖xorg.conf中设置的配置。在~/.local/share/kscreen/中查找kscreen配置文件，并检查分辨率是否设置为显示器不支持的分辨率。

系统托盘上的图标模糊
为了在托盘中添加图标，应用程序经常使用 appindicator库。如果图标模糊，请检查已安装的libappindicator版本。如果您只安装了libappindicator-gtk2包，那么您可以安装libappindicator-gtk3包，以尝试获得清晰的图标。

在虚拟机中无法更改屏幕分辨率
当在VMware、VirtualBox或QEMU虚拟机上运行Plasma时，kscreen可能不允许将Guest的屏幕分辨率更改为高于800x600的分辨率。

解决方法是在 xorg.conf.d(5) 中设置 PreferredMode 选项，或者尝试在VM中使用其他图形适配器。例如，对于VirtualBox，使用VBoxSVGA代替VMSVGA；对于QEMU，用Virtio代替QXL。 有关详细信息，请参见KDE Bug 407058。

Dolphin、Kate等软件启动时卡住很长时间
检查您的用户文件夹(Documents 和 Downloads 等)是否设为了只读。

Spectacle使用旧的屏幕状态截图
在 系统设置 > 显卡与显示器 > 显示特效合成器，更改 保持窗口缩略图，从 只对显示的窗口 到 从不。如果使用Intel显卡， 请确认xf86-video-intel包没有安装。

声音问题
注意： 首先保证您已经安装了 alsa-utils包。
挂起后没有声音
如果挂起后没有声音并且 Kmix 没有显示应该显示的音频设备，可以尝试重新启动 plasmeshell 和 pulseaudio：

$ killall plasmashell
$ systemctl --user restart pulseaudio.service
$ plasmashell
某些应用程序也可能需要重新启动才能再次播放声音。

使用 GStreamer Phonon 后端时不能播放 MP3 文件
安装 GStreamer libav 插件（软件包gst-libav包）可以解决问题。如果仍然碰到，您可以尝试换一个软件包，例如 phonon-qt4-vlcAUR 或 phonon-qt5-vlc包。

然后，请在以下位置检查它是否已是首选的后端：

 系统设置 > 多媒体 > 后端
若您的设置没有显示，尝试在您的终端里运行 phononsettings 。

系统托盘没有音量控制图标并且无法使用快捷键控制音量
检查是否安装plasma-pa包

短时间后声音消失
如果journalctl -p4 -t pulseaudio包含Failed to create sink input: sink is suspended的信息，尝试注释/etc/pulse/default.pa内的行：

#load-module module-suspend-on-idle
如果问题仍然存在，plasma-meta包 或 plasma包组可能同时安装了pulseaudio包 和 wireplumber包 。要修复这个问题，将pulseaudio包 替换为 pipewire-pulse包 。 如果想使用 pulseaudio包 ，将 wireplumber包 替换为 pipewire-media-session包 。参考PipeWire#PulseAudio_客户端 和 这个贴子。

电源管理
没有挂起/休眠选项
如果您的系统可以使用 systemd 挂起/休眠，但 KDE 中没有这些选项，请确保 powerdevil包 已被安装。

没有电源配置方案选项
确保安装了powerdevil包 和 power-profiles-daemon包。 运行powerprofilesctl并检查驱动。如果是intel_pstate 或 amd_pstate，那问题应该已经解决，否则参考CPU_调频#调频驱动以启用相关驱动。

KMail
清理 akonadi 配置来修复 kmail
详见 [12]。

若要备份配置文件，请复制以下文件夹：

$ cp -a ~/.local/share/akonadi ~/.local/share/akonadi-old
$ cp -a ~/.config/akonadi ~/.config/akonadi-old
KMail 的 IMAP 收件箱是空的
对于某些 IMAP 账户，kmail将把收件箱当作一个包含此帐户所有其他文件夹的容器显示。Kmail 不会在收件箱容器中显示消息，而是在所有其他子文件夹中显示消息，见 [13]。若要解决此问题，只需在kmail帐户设置中禁用服务器端订阅即可。

KMail中EWS帐户的授权错误
在KMail中设置EWS帐户时，您可能会不断收到关于授权失败的错误，即使是使用有效的凭证。这可能是由于KWallet和KMail之间的通讯中断造成的。要解决此问题，请通过qdbus设置密码：

$ qdbus org.freedesktop.Akonadi.Resource.akonadi_ews_resource_0 /Settings org.kde.Akonadi.Ews.Wallet.setPassword "XXX"
Aggressive QXcbConnection / kscreen.xcb.helper journal logging
见 Qt#Disable/Change Qt journal logging behaviour。

KF5/Qt 5应用程序在i3/FVWM/awesome中不显示图标
见 Qt#Configuration of Qt 5 applications under environments other than KDE Plasma。

保存凭据和持续显示 KWallet 对话框的问题
不建议在用户设置中关闭 KWallet 密码保存系统，因为需要它为每个用户保存加密凭证（如WiFi密码）。关闭它可能会导致 KWallet 对话框持续出现。

如果您嫌每当应用程序想要访问 Kwallet 时需要解锁烦，您可以让登录管理器 SDDM 和 LightDM 在登录时自动解锁 KWallet，见 KDE Wallet。第一个钱包需要由 KWallet 生成（而不是"用户生成"），以便用于系统程序凭据。

如果您不希望让钱包凭据在内存内为每个应用打开，可以通过 kwalletmanager包 在KWallet设置中限制应用程序访问它。

如果您不关心凭证加密，您可以在创建钱包，KWallet 要求输入密码时，将密码留空。这样，应用程序将可以在不解锁钱包的情况下访问密码。

Discover不显示任何程序
请安装 packagekit-qt5包 以解决问题。

Discover无法从Arch仓库获取更新
Discover有时不能释放PackageKit alpm锁，手动删除/var/lib/PackageKit/alpm/db.lck文件后更新Discover可解决问题。

NVIDIA驱动程序的kscreenlocker_greet的CPU使用率很高
如 KDE 错误 347772 中所述，NVIDIA OpenGL 驱动程序和 QML 可能无法与 Qt 5 很好地配合使用。这可能导致 kscreenlocker_greet解锁会话后 CPU 使用率高。要解决此问题，请将 QSG_RENDERER_LOOP 环境变量 设置为 basic。

然后用 killall kscreenlocker_greet 杀死之前的 greeter 实例。

在 ZFS 上运行 Akonadi 时出现操作系统错误 22
如果您的主目录位于 ZFS 池中，请创建一个 ~/.config/akonadi/mysql-local.conf 文件，其内容如下：

[mysqld]
innodb_use_native_aio = 0
请参阅 MariaDB#OS error 22 when running on ZFS.

某些程序的窗口处于非活动状态时无法滚动
这是由GTK3处理鼠标滚动事件处理有问题造成的。一个解决方法是设置environment variable GDK_CORE_DEVICE_EVENTS=1。但是，这种方法也会破坏触摸板的平滑滚动和触摸屏滚动。

TeamViewer 很卡
在使用TeamViewer时，如果您使用平滑动画(比如最小化窗口)，它可能会运行得很慢。参见 #禁用混成 作为一种解决方案。

Kmail、Kontact 和 Wayland
Kmail可能会失去响应，显示一个黑色的消息视图或者类似的，通常是在最小化和恢复之后。一个解决方案可能是设置 environment variable QT_QPA_PLATFORM="xcb;wayland"。

解锁小部件 (Plasma ≥ 5.18)
如果您之前锁定了小部件，您可能会发现自己无法再次解锁它们。 您只需运行此命令即可：

$ qdbus org.kde.plasmashell /PlasmaShell evaluateScript "lockCorona(false)"
新的 Customize Layout 不需要将它们锁定，但如果想这样做：

$ qdbus org.kde.plasmashell /PlasmaShell evaluateScript "lockCorona(true)"
小部件无法运行或出现bug
可安装plasmoidviewer包查看输出信息，做出相应处理：

yay -S plasmoidviewer-debug

plasmoidviewer --applet <小部件名称>
KIO以错误的程序打开URL连接
检查HTML, PHP等的文件关联，将其设置为浏览器。KIO缓存文件位于$HOME/.cache/kioexec。另参见xdg-utils#URL scheme handlers。

系统设置中的快捷方式下缺少自定义快捷方式选项卡
这是因为缺少 khotkeys包 包。安装后，可能需要重新启动系统设置应用程序以应用更改。

在暂停和休眠之前锁定屏幕
在系统设置应用程序中，KDE 提供了从睡眠中醒来后自动锁定屏幕的设置。恢复后，some users报告说屏幕在锁定前短暂显示。要防止这种行为并让 KDE 在挂起之前锁定屏幕，请在 systemd(1) 中以 root 用户创建以下文件来创建挂钩：

/usr/lib/systemd/system-sleep/lock_before_suspend.sh
#!/bin/bash

case $1/$2 in
    pre/*)
        case $2 in
            suspend|hibernate)
                loginctl lock-session
                sleep 1 
                ;;
            esac
        ;;
esac
为了在设备挂起之前完成锁定会话，必须使用“睡眠”。较低的值不允许完成。

创建文件后，将其设为 可执行的。

最后，通过转到系统设置 > 工作区行为 > 屏幕锁定并选中从睡眠中唤醒后复选框，确保启用了 KDE 设置。

X11快捷键在Wayland上冲突
自KDE 5.27起，一些X11软件例如freerdp包会捕获键盘输入，其它软件像VMware无法正确捕获。 [14]

在Xserver或在混成器强制捕获快捷键并不合适。[15] 下面的方法解决问题更优雅一些：

右键窗口标题栏（例如VMware或Citrix）；
More Actions > Configure Special Window Settings...
单击 Add Property...并选择Ignore global shortcuts。
选择 force 和 yes，应用设置。