KDE (简体中文) - ArchWiki

Jump to content

相关文章

- 桌面环境
- 显示管理器
- 窗口管理器
- Qt (简体中文)
- SDDM (简体中文)
- Dolphin
- KDE Wallet (简体中文)
- KDevelop
- Trinity
- Uniform Look for Qt and GTK Applications (简体中文)
- Official repositories (简体中文)#kde-unstable

翻译状态：本文是 KDE 的翻译。上次翻译日期：2022-11-13。如果英文版本有所更改，则您可以帮助同步翻译。

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

## 安装

### Plasma 桌面

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

安装 plasma-meta 元软件包或者 plasma 组。 关于 plasma-meta 和 plasma 两者的不同见元软件包与软件包组。若要使用 Plasma 的最小安装，请安装 plasma-desktop 包。

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

### 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下开启新会话。

### 从控制台启动

- 若要使用 "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]` 部分中。

##### 禁用面板阴影

因为 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。

#### 窗口装饰

可在 系统设置 > 应用程序风格 > 窗口装饰 中设置窗口装饰。

您也可以在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 上都可以使用)，称为夜间模式。它使屏幕上的颜色呈现更暖的色调，以在指定的时间里减少眼睛疲劳。 您可以在 系统设置 -> 显示和屏幕 -> 夜间模式 中启动该功能。

Tip: To have a handy System Tray on/off button for night color you need the kdeplasma-addons and then you can add it.

### 打印

提示： 使用 CUPS 的 Web 接口进行快速配置。这种方式配置的打印机可以被 KDE 应用使用。

您也可以在 系统设置 > 打印机配置 中配置打印机。要使用这种配置方式，必须首先安装 print-manager 和 cups 软件包。请阅CUPS配置

### Samba/Windows 支持

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

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

Tip: Use `*` (asterisk) for both username and password when accessing a Windows share without authentication in Dolphin's prompt.

不像 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 电源管理"的节能服务，它可以调整系统的节能配置、屏幕亮度（如果支持）并提供详细的电源报告。

提示：

- powerdevil-lightAUR 提供了一个没有 NetworkManager 和 Bluez 支持/依赖的替代包。
- 可以选择启用了 DDC/CI 的外接显示器背光控制的 powerdevil-ddcutilAUR 替代它。
- 与 电源配置文件[失效链接 2022-09-19 ⓘ] 集成需要 power-profiles-daemon 可选依赖项。

注意： Powerdevil 可能无法 覆盖 所有的 logind 设置(例如笔记本合盖动作). 如果遇到这样的问题，需要修改logind的设置，请参考 Power management (简体中文)#用 systemd 进行电源管理。 问题也可能是因为 logind 中 `LidSwitchIgnoreInhibited` 的默认值是 `yes`，见 [7]

### 自启动

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 中的视频缩略图）中。

#### 我应该选择哪个后端？

您可以在 GStreamer, VLC, mpv 和 MPlayer 之间做选择–每个后端都有 Qt4 和 Qt5 版本 (phonon-qt4-gstreamerAUR, phonon-qt5-gstreamer – phonon-qt4-vlcAUR, phonon-qt5-vlc, phonon-qt4-mplayer-gitAUR, phonon-qt5-mpvAUR).

KDE-Multimedia 上游建议使用 VLC 后端，但是很多 Linux 发行版 (例如 Kubuntu 和 Fedora-KDE ) 选择 GStreamer，因为它可以更方便的去掉专利 MPEG codecs。它们的 功能有稍许不同。The Gstreame后端有一些可选的编解码器依赖，如下，将它们作为依赖安装：

- gst-libav — Libav 编解码器。
- gst-plugins-good — PulseAudio 支持与额外的编解码器。
- gst-plugins-ugly — 额外的编解码器。
- gst-plugins-bad — 额外的编解码器。

注意：

- 可以同时安装多个后端，并在 系统设置 > 多媒体 > 后端 中进行优先级设定。
- 根据 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 user实例来启动或管理所有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。

##### 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

警告： 不建议使用 SQLite 后端，请避免使用它。[10]

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

    ~/.config/akonadi/akonadiserverrc

    [%General]
    Driver=QSQLITE3

注意：

- 当 Akonadi 启动时，它将创建 `[QSQLITE3]` 部分并在其中设置适当的变量。
- 数据库存储在 `~/.local/share/akonadi/akonadi.db`。

##### 禁用 Akonadi

想要禁用 Akonadi 的用户不需要启动任何依赖它的 KDE 应用程序。有关详细信息，请参阅此 在 KDE 用户库中的部分。

### KDE Telepathy

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-haze, 安装 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 桌面，您也可以使用 KDE Connect。对于使用 AppIndicator的桌面环境（如Unity），还需要安装 indicator-kdeconnectAUR 软件包。对于 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`。

## 提示和技巧

### 使用不同的窗口管理器

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

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

#### 替换KWin服务

自KDE 5.25，Plasma默认使用基于systemd的启动。

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

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

    ~/.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用户群Wiki：Tutorials/Using Other Window Managers with Plasma。

#### KDE/Openbox 会话

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

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

    ~/.xinitrc

    exec openbox-kde-session

#### 重新启用特殊效果

当您用不包含混成器的窗口管理器（例如 Openbox）替换 Kwin 时，任何桌面特殊效果都会失效（例如窗口透明度）。在这种情况下，请安装并运行其他独立的混成器，如 Xcompmgr 或 picom。

### KWin 平铺窗口脚本

Bismuth 和 Kröhnkite 是自动平铺窗口并允许你用键盘控制它们的 Kwin 脚本。Bismuth 相较更先进。

### 配置显示器分辨率 / 多显示器

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

### KWin-lowlatency

注意： KWin-lowlatency 项目已停止支持，并将不能在 Plasma 5.24下工作。

KWin-lowlatency是一种尝试，它试图减少KWin compositor在Wayland中的延迟和中断，可以在这里 KWin-lowlatencyAUR获得。

### 配置 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 [12]。

### 在 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

### 禁用休眠

This article or section is a candidate for merging with Power management.

Notes: 此不限于 KDE。可将本节作为一个存根链接，指向该节。 (Discuss in 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

## 疑难解答

### 字体

#### 字体在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` 变量设置为 `es_ES.UTF-8` 并将 `LC_MESSAGES` 变量设置为 `en_US.UTF-8`：

    ~/.config/plasma-localerc

    [Formats]
    LANG=es_ES.UTF-8

    [Translations]
    LANGUAGE=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` 等)是否设为了只读。

#### 使用旧的屏幕状态截图

在 系统设置 > 显卡与显示器 > 显示特效合成器，更改 保持窗口缩略图，从 只对显示的窗口 到 从不。

### 声音问题

注意： 首先保证您已经安装了 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。

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

     系统设置 > 多媒体 > 后端

If you the settings does not show any, try `phononsettings` in your terminal.

### 电源管理

#### 没有挂起/休眠选项

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

### KMail

#### 清理 akonadi 配置来修复 kmail

详见 [13]。

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

    $ cp -a ~/.local/share/akonadi ~/.local/share/akonadi-old
    $ cp -a ~/.config/akonadi ~/.config/akonadi-old

#### KMail 的 IMAP 收件箱是空的

对于某些 IMAP 账户，kmail将把收件箱当作一个包含此帐户所有其他文件夹的容器显示。Kmail 不会在收件箱容器中显示消息，而是在所有其他子文件夹中显示消息，见 [14]。若要解决此问题，只需在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 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)"

### 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 设置。

## 参见

- KDE 主页
- KDE news
- KDE Blogs
- KDE 论坛
- KDE Wikis
- KDE 缺陷跟踪页
- Martin Graesslin's blog
- KDE Matrix 房间

Category:

- KDE (简体中文)

Hidden categories:

- Pages with dead links
- Pages with broken package links
- Pages or sections flagged with Template:Merge