KDE (简体中文) - ArchWiki

Jump to content

# KDE (简体中文)

From ArchWiki

相关文章

- Desktop environment (简体中文)
- Display manager (简体中文)
- Window manager (简体中文)
- Qt (简体中文)
- SDDM (简体中文)
- Dolphin
- KDE Wallet (简体中文)
- KDevelop
- Trinity
- Uniform Look for Qt and GTK Applications (简体中文)
- Official repositories (简体中文)#kde-unstable

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

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

## 安装

### Plasma 桌面

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

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

若要启用 Plasma 的 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 的 Wayland 会话, 请运行 `dbus-run-session startplasma-wayland`。[1]

## 配置

KDE应用的大部分配置存储于 `~/.config` 目录下。KDE 主要使用“系统设置”调整配置，也可以在终端执行 `systemsettings` 启动它。

### 个性化

#### Plasma 桌面

##### 主题

Plasma 主题定义了面板和 Plasma widget 的样式。为了方便从系统层面安装主题，官方软件仓库和 AUR 中也提供了一些主题。

您也可以通过系统设置来安装主题：

     系统设置 > 工作空间主题 > 桌面主题 > 获取新主题

KDE商店 提供了更多的plasma个性化方案，包括 SDDM 主题和 splash-screens。

###### GTK+ 应用的外观

提示： 若要使 Qt 和 GTK 主题一致，见QT 和 GTK 应用的统一外观。

在 GTK 中推荐使用 breeze-gtk 主题，这款 GTK 主题模仿了 Plasma 的 Breeze 主题。 安装 kde-gtk-config（该软件是plasma 的一部分），在系统设置 > 外观 > 应用风格 > 配置 GNOME/GTK 应用风格中选择 `Breeze` 即可。

##### Faces

Plasma and SDDM will both use images found at `/var/lib/AccountsService/icons/` as users' avatars. To configure with a graphical interface, you can use System Settings > Users, which may first need to be installed (see the plasma-desktop package). The file corresponding to your username can be removed to restore the default avatar.

##### 小部件

Plasmoid 是 Plasma Shell 的小部件，用于增强桌面功能。

若要安装Plasmoid脚本，最方便的方式是右键面板或桌面，然后选择：

    添加部件 > 获得新部件 > 下载新 Plasma 部件

随后将会显示 kde-look.org 的前端界面，并可一键安装/卸载/更新第三方 plasmoid 脚本。

AUR 仓库中可以下载到很多二进制文件版的Plasmoid部件。

##### 系统托盘中的声音小程序

安装 plasma-pa 或 kmix (从程序启动器启动 Kmix)。前者已自动安装，无需另外设置。

注意： 若要调整 音量单次增减的长度，请将例如 `VolumePercentageStep=1` （后面的数字代表长度）的一行文字添加到 `~/.kde4/share/config/kmixrc` 的 `[Global]` 部分中。

##### 禁用面板阴影

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

    $ xprop -remove _KDE_NET_WM_SHADOW

然后用增大的光标选择面板。[3] 若要自动化此操作，请安装 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 电源管理"的节能服务，它可以调整系统的节能配置、屏幕亮度（如果支持）并提供详细的电源报告。

提示：

- 可以选择不需要依赖 NetworkManager 和 Bluez 的 powerdevil-lightAUR 替代它。
- 可以选择启用了 DDC/CI 的外接显示器背光控制的 powerdevil-ddcutilAUR 替代它。
- Integration with power profiles requires the power-profiles-daemon optional dependency.

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

### 自启动

Plasma 可以在启动和关闭时自动启动应用程序并运行shell脚本。若要自动启动应用程序，请进入 系统设置 > 开关机 > 自启动 并添加您想要的程序或shell脚本。若选择程序，则会创建一个 `.desktop` 文件；选择脚本，则会创建一个用来启动脚本的 `.desktop` 文件。

注意：

- 程序只能在登录时自启动，而shell脚本也可以在关机和 Plasma 启动前启动。
- Shell脚本需要可执行权限才能运行。
- Shell scripts previously placed in `~/.config/autostart-scripts/` will get automatically migrated to .desktop files.

- 将桌面配置项（即`.desktop`文件）放入适当的 XDG Autostart 目录：
- 将shell脚本的symlink放入以下目录之一：

  `~/.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 之间做选择–每个后端都有 Qt4 和 Qt5 版本 (phonon-qt4-gstreamerAUR, phonon-qt5-gstreamer – phonon-qt4-vlcAUR, phonon-qt5-vlc).

KDE-Multimedia 上游建议使用 VLC 后端，但是很多 Linux 发行版 (例如 Kubuntu 和 Fedora-KDE ) 选择 GStreamer，因为它可以更方便的去掉专利 MPEG codecs。它们的 功能有稍许不同。The Gstreamer backend has some optional codec dependency, install them as needed:

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

过去还有一些后端，但已经因为缺乏维护而删除了它们的 AUR 软件包。

注意：

- 可以同时安装多个后端，并在 系统设置 > 多媒体 > 后端 中进行优先级设定。
- 根据 KDE 这个帖子, VLC 后端不支持 ReplayGain。
- 如果使用 VLC 后端，可能会遇到崩溃问题，如在每次 Plasma 发送语音警告时崩溃等等，详见 [5]。重建VLC插件缓存也许能解决问题：

    # /usr/lib/vlc/vlc-cache-gen -f /usr/lib/vlc/plugins

### 备份与恢复

KDE Plasma 5 将个性化配置以配置文件的形式储存在 XDG_CONFIG_HOME 中。参照 KDE 的配置文件 并选择 恰当的备份恢复方案。

### systemd startup

Plasma has introduced an optional new startup method which uses a systemd user instance to launch and manage all the Plasma services instead of the boot scripts. This is off by default, but can be enabled with the following command:

    $ kwriteconfig5 --file startkderc --group General --key systemdBoot true

To confirm the boot worked correctly you check the status of the `plasma-plasmashell.service` user unit.

More details about the implementation can be read in 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

By default Akonadi will use `/usr/bin/mysqld` (MariaDB by default, see MySQL for alternative providers) to run a managed MySQL instance with the database stored in `~/.local/share/akonadi/db_data/`.

###### 系统级 MySQL 实例

Akonadi supports using the system-wide MySQL for its database.[6]

    ~/.config/akonadi/akonadiserverrc

    [%General]
    Driver=QMYSQL

    [QMYSQL]
    Host=
    Name=akonadi_username
    Options="UNIX_SOCKET=/run/mysqld/mysqld.sock"
    StartServer=false

##### PostgreSQL

Akonadi supports either using the existing system-wide PostgreSQL instance, i.e. `postgresql.service`, or running a PostgreSQL instance with user privileges and the database in `~/.local/share/akonadi/db_data/`.

###### Per-user PostgreSQL instance

Install postgresql and postgresql-old-upgrade.

Edit Akonadi configuration file so that it has the following contents:

    ~/.config/akonadi/akonadiserverrc

    [%General]
    Driver=QPSQL

Note:

- When Akonadi starts, it will create the `[QPSQL]` section and set the appropriate variables in it.
- The database will be stored in `~/.local/share/akonadi/db_data/`.

Start Akonadi with `akonadictl start`, and check its status: `akonadictl status`.

Note:

- Starting with akonadi 19.08.0-1 the PostgreSQL database cluster in `~/.local/share/akonadi/db_data/` will get automatically upgraded when a major PostgreSQL version upgrade is detected.
- For previous akonadi versions major PostgreSQL version upgrades will require a manual database upgrade. Follow the update instructions on KDE UserBase Wiki. Make sure to adjust the paths to PostgreSQL binaries to those used by postgresql and postgresql-old-upgrade, see PostgreSQL#Upgrading PostgreSQL.

###### System-wide PostgreSQL instance

This requires an already configured and running PostgreSQL.

Create a PostgreSQL user account for your user:

    [postgres]$ createuser username

Create a database for Akonadi:

    [postgres]$ createdb -O username -E UTF8 --locale=C -T template0 akonadi-username

Configure Akonadi to use the system-wide PostgreSQL:

    ~/.config/akonadi/akonadiserverrc

    [%General]
    Driver=QPSQL

    [QPSQL]
    Host=/run/postgresql
    Name=akonadi-username
    StartServer=false

Note: Custom port, username and password can be specified with options `Port=`, `User=`, `Password=` in the `[QPSQL]` section.

Start Akonadi with `akonadictl start`, and check its status: `akonadictl status`.

###### SQLite

Warning: Using the SQLite backend is not recommended and should be avoided.[7]

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

    ~/.config/akonadi/akonadiserverrc

    [%General]
    Driver=QSQLITE3

Note:

- When Akonadi starts, it will create the `[QSQLITE3]` section and set the appropriate variables in it.
- The database will be stored as `~/.local/share/akonadi/akonadi.db`.

##### Disabling Akonadi

见 KDE userbase 的此部分。

### 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 手机与Linux桌面连接：

- 从任何应用向 KDE 共享文件和 URL 或从 KDE 向任何应用共享，无需连线。
- 触摸板模拟：将手机屏幕用作计算机的触摸板。
- 通知同步（4.3+）：从桌面读取您的安卓通知。
- 共享剪贴板：在手机和电脑之间复制粘贴。
- 多媒体远程控制：将手机用作 Linux 媒体播放器的遥控器。
- WiFi 连接：不需要 usb 和蓝牙。
- RSA加密：保证您的信息安全。

您需要同时在电脑和安卓上安装 KDE Connect。PC端上安装 kdeconnect 软件包，而安卓端可以在 Google Play 或 F-Droid 上安装 KDE Connect。If you want to browse your phone's filesystem, you need to install sshfs as well and configure filesystem exposes in your Android app.

即使不使用 Plasma 桌面，您也可以使用 KDE Connect。对于使用 AppIndicator的桌面环境（如Unity），还需要安装 indicator-kdeconnectAUR 软件包。For GNOME users, better integration can be achieved by installing gnome-shell-extension-gsconnectAUR instead of kdeconnect. To start the KDE Connect daemon manually, execute `/usr/lib/kdeconnectd`.

If you use a firewall, you need to open UDP and TCP ports `1714` through `1764`.

Sometimes, KDE Connect will not detect a phone. You can restart the services by running `killall kdeconnectd` and then opening kdeconnect in system settings or running `kdeconnect-cli --refresh` followed by `kdeconnect-cli -l`.

## 提示和技巧

### 使用其他窗口管理器

Plasma 中的组件选择器设置已不再允许更改窗口管理器。[8]若需更改窗口管理器，您需要在 KDE 启动之前设置 `KDEWM` 环境变量。The instructions are available on the KDE UserBase Wiki—Tutorials/Using Other Window Managers with Plasma.

Note: When using i3 window manager with Plasma, it may be necessary to manually set dialogs to open in floating mode in order for them to correctly appear. For more information, see i3#Correct handling of floating dialogs.

#### KDE/Openbox 会话

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

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

    ~/.xinitrc

    exec openbox-kde-session

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

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

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

若要在 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 Integration

IBus is an input method framework and can be integrated into KDE. See IBus#Integration for details.

Using IBus may be required when using KDE on Wayland to offer accented characters and dead keys support [9].

### Enable hotspot in plasma-nm

See NetworkManager#Sharing internet connection over Wi-Fi.

### Restore previous saved session

If you have System Settings > Startup and Shutdown > Desktop Session > When logging in: Restore previous saved session (default) selected, ksmserver (KDE's session manager) will automatically save/load all open applications to/from `~/.config/ksmserverrc` on logout/login.

Note: Currently, native Wayland windows cannot be restored. See Wayland Showstoppers for the current state of development.

### Receive local mail in KMail

If you have set up local mail delivery with a mail server that uses the Maildir format, you may want to receive this mail in KMail. To do so, you can re-use KMail's default receiving account "Local Folders" that stores mail in `~/.local/share/local-mail/`.

Symlink the `~/Maildir` directory (where Maildir format mail is commonly delivered) to the Local Folders' inbox:

    $ ln -s .local/share/local-mail/inbox ~/Maildir

Alternatively, add a new receiving account with the type Maildir and set `~/Maildir` as its directory.

### Configure Plasma for all users

Edit `config/main.xml` files in the `/usr/share/plasma`. For example, to configure the Application Launcher for all users, edit `/usr/share/plasma/plasmoids/org.kde.plasma.kickoff/contents/config/main.xml`. To prevent the files from being overwritten with package updates, add the files to Pacman's NoUpgrade

### Disable hibernate

Properly disable the hibernate feature and hide it from the menu with a Polkit policy rule.

    /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;
       }
    });

## 疑难解答

### qt5ct and kvantum bugs after upgrade

This article or section is out of date.

Reason: This was added 2021-02-15 : the "latest update" is one year old, is this fixed ? (Discuss in Talk:KDE (简体中文))

Latest update might cause incompatible HiDPI scaling that made some interfaces becomes too big for your screen, some icons are missing or can not be displayed, and missing panels or widgets.

Try to remove qt5ct and kvantum related package, then apply default global Plasma theme. If the problem persists, try clearing all your KDE configuration and reinstalling plasma to overwrite the configuration. Be sure to check HiDPI scaling in KDE system settings as well.

### 字体

#### 字体在Plasma会话中看起来发虚

尝试安装ttf-dejavu和ttf-liberation包。

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

如果您设置了字体Fonts (简体中文)的渲染方式，请注意系统设置可能会改变它们的外观。当您进入 系统设置 > 字体 时，系统设置可能会改变您的字体配置文件(`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

Optionally, empty the `~/.cache/` folder contents, however, this will also clear the cache of other applications:

    $ rm -rf ~/.cache/*

#### Plasma desktop does not respect locale/language settings

Plasma desktop may use different settings than you set at KDE System Settings panel, or in `locale.conf` (per Locale#Variables). First thing to do is log out and log in after removing `~/.config/plasma-localerc`, if this does not fix the issue, try to edit the file manually. For example, to set `LANG` variable to `es_ES.UTF-8` and the `LC_MESSAGES` variable to `en_US.UTF-8`:

    ~/.config/plasma-localerc

    [Formats]
    LANG=es_ES.UTF-8

    [Translations]
    LANGUAGE=en_US

#### 不能在系统设置中更改主题、图标、字体、颜色;大多数图标不显示

确保 `QT_QPA_PLATFORMTHEME` 在 Environment variables (简体中文) 未设置，命令 `printenv QT_QPA_PLATFORMTHEME` 输出应该为空。Otherwise if you had an environment set (most likely qt5ct) the variable will force qt5ct settings upon Qt applications, the command `export QT_QPA_PLATFORMTHEME=` should unset the environment.

An easier (and more reliable) solution can be to uninstall completely qt5ct.

#### 音量控制、通知或多媒体键不起作用

隐藏系统托盘设置中的某些项(如音频音量、媒体播放器或通知)也会禁用相关功能。Hiding the Audio Volume disables volume control keys, Media Player disables multimedia keys (rewind, stop, pause) and hiding Notifications disables showing notifications.

#### 登录界面不会将光标设置同步到SDDM

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

#### Missing panels/widgets

A crash or hardware change can modify the screen numbers, even on a single monitor setup. The panels/widgets can be missing after such an event, this can be fixed in the `~/.config/plasma-org.kde.plasma.desktop-appletsrc` file by changing the `lastScreen` values.

### 图形问题

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

#### 获取KWin的当前状态以用于获得帮助和调试

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

    $ qdbus org.kde.KWin /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，那么您可以安装{{Pkg|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

详见 [10]。

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

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

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

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

### 保存凭据和持续显示 KWallet 对话框的问题

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

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

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

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

### Discover不显示任何程序

请安装 packagekit-qt5 以解决问题。

### NVIDIA驱动程序的kscreenlocker_greet的CPU使用率很高

As described in KDE Bug 347772 NVIDIA OpenGL drivers and QML may not play well together with Qt 5. This may lead `kscreenlocker_greet` to high CPU usage after unlocking the session. To work around this issue, set the `QSG_RENDERER_LOOP` environment variable to `basic`.

Then kill previous instances of the greeter with `killall kscreenlocker_greet`.

### OS error 22 when running Akonadi on ZFS

If your home directory is on a ZFS pool, create a `~/.config/akonadi/mysql-local.conf` file with the following contents:

    [mysqld]
    innodb_use_native_aio = 0

See MariaDB#OS error 22 when running on ZFS.

### 某些程序的窗口处于非活动状态时无法滚动

这是由GTK3处理鼠标滚动事件处理有问题造成的。一个解决方法是设置environment variable `GDK_CORE_DEVICE_EVENTS=1`。但是，这种方法也会破坏触摸板的平滑滚动和触摸屏滚动。

### TeamViewer 很卡

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

### Kmail, Kontact and wayland

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

### Unlock widgets (Plasma ≥ 5.18)

If you previously locked your widgets, you will probably find yourself unable to unlock them again. You just have to run this command to do so:

    $ qdbus org.kde.plasmashell /PlasmaShell evaluateScript "lockCorona(false)"

The new `Customize Layout` does not require to lock them back up but if want to do that:

    $ qdbus org.kde.plasmashell /PlasmaShell evaluateScript "lockCorona(true)"

### KIO opens URLs with error programs

KIO had cached webpages and will try use cached files. Check file associations regarding html, php, etc. and change it to a browser. KIO's cache files are located in `$HOME/.cache/kioexec`. See also xdg-utils#URL scheme handlers.

### Custom Shortcuts tab is missing under Shortcuts in System Settings

This is due to the khotkeys package being missing. After installation, a restart of the System Settings application may be necessary to apply the changes.

### Lock the screen before suspending and hibernating

In the System Settings application, KDE offers a setting to automatically lock the screen after waking up from sleep. Upon resuming, some users report that the screen is briefly showed before locking. To prevent this behavior and have KDE lock the screen before suspending, create a hook in systemd(1) by creating the following file as the root user:

    /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 # necessary in order for the lock-session to complete before device is suspended. Lower value didn't allow for completion
                    ;;
                esac
            ;;
    esac

After creating the file, make it executable.

Finally, make sure that the KDE setting is enabled by going to System Settings > Workspace Behavior > Screen Locking and checking the "After waking from sleep" checkbox.

## 另见

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

Category:

- KDE (简体中文)

Hidden categories:

- Pages with broken package links
- Pages or sections flagged with Template:Out of date