KDE - Arch Linux 中文维基

跳至內容

# KDE

出自 Arch Linux 中文维基
翻譯狀態：

- 本文（或部分內容）譯自 KDE，最近一次同步於 2026-02-22，若英文版本有所更改，則您可以幫助同步與翻譯更改的內容。
- 您可以在 ArchWiki 的對應頁面找到本文翻譯的原始修訂歷史。
- 本文可能與英文原文存在出入。

相關文章

- 桌面環境
- 顯示管理器
- 窗口管理器
- Qt
- SDDM
- Dolphin
- KDE Wallet
- KDevelop
- Trinity
- 統一 Qt 和 GTK 應用程式的外觀
- Official repositories#kde-unstable

KDE 是一套由桌面環境(KDE Plasma)、應用程式（KDE Applications）以及 Qt 附加庫（KDE Frameworks）構成的軟體項目。

## 安裝

### Plasma 桌面

安裝 plasma-meta包 元軟體包或者 plasma包組 組。關於 plasma-meta包 和 plasma包組 兩者的不同見元軟體包與軟體包組。若要使用 Plasma 的最小安裝，請安裝 plasma-desktop包 包。上游 KDE 有軟體包和安裝推薦以獲得功能齊全的 Plasma 會話。

如果你是 NVIDIA 用戶，請確保已啟用 DRM內核級顯示模式設置。

### Plasma Mobile

安裝 plasma-mobileAUR。

### KDE 應用

若要安裝 KDE 的全套應用，請安裝 kde-applications-meta包 元軟體包或 kde-applications包組 組。若只需要安裝特定類別的 KDE 應用（如遊戲或教育），請只安裝 kde-applications-meta包 中與此相關的依賴。請注意只安裝kde應用不會安裝任何版本的 Plasma 桌面。

### 不穩定版

見 Official repositories#kde-unstable。

## 啟動 Plasma

從 Plasma 6.4 開始，Wayland 會話已足夠成熟，成為默認且首選的會話：X11 會話需要單獨安裝 plasma-x11-session包 軟體包才能使用 [1]。Xorg 會話目前仍受支持，但將在 Plasma 6.8 中被移除。更多信息請參閱 Wayland 已知重要問題 和 X11 已知重要問題 文檔。

Plasma 既可以通過顯示管理器啟動，也可以從控制台啟動。

### 使用顯示管理器

提示：推薦使用 Plasma Login Manager 顯示管理器。

- 選擇 Plasma (Wayland) 以在 Wayland 下開啟新會話。
- 選擇 Plasma (X11) 以在 Xorg 下開啟新會話。
- 選擇 Plasma mobile (Wayland) 以在 Wayland下開啟新的 Plasma mobile 會話。

### 從控制台啟動

- 要從控制台啟動 Plasma on Wayland 會話，請運行 `/usr/lib/plasma-dbus-run-session-if-needed /usr/bin/startplasma-wayland`[2]。
- 若要使用 "xinit/startx" 啟動 Plasma 桌面，請在 `.xinitrc` 文件中添加 `export DESKTOP_SESSION=plasma` 和 `exec startplasma-x11`，或者直接在控制台運行`startx /usr/bin/startplasma-x11`。若要在登錄時開啟 Xorg，見登錄時啟動 X。

## 配置

KDE應用的大部分配置存儲於 `~/.config` 目錄下。KDE 主要使用"系統設置"調整配置，也可以在終端執行 `systemsettings` 啟動它。

### 個性化

#### Plasma 桌面

##### 主題

有不同類型的 KDE 主題，根據它們修改的範圍而有所不同：

- 全局主題，全面的包，可以包括 Plasma 主題、應用程式樣式、顏色、字體、圖標、光標、啟動屏幕、SDDM 主題和 Konsole 配色方案。要應用全局主題，可用 `lookandfeeltool` 命令行工具。
- Plasma 視覺風格， 修改 Plasma 面板和小部件的外觀。這些通常有一個推薦的 Kvantum 或 Aurorae 主題來完成外觀。
- 應用程式風格，修改程序的外觀。
- 使用主題引擎的應用程式樣式，例如 Kvantum、QtCurve [1]、QSvgStyle [2] 以及 Aurorae。
- #圖標主題，為應用程式、文件和操作提供圖標。

為了便於系統範圍內的安裝和更新，一些主題在官方倉庫和 AUR 都可用。

全局主題亦可通過系統設置 > 顏色和主題 > 全局主題 > 獲取新全局主題... 安裝。

警告：終端用戶提供的全局主題通常沒有經過監管。你應該對下載並應用這些全局主題保持極度警惕。這些全局主題可能運行惡意代碼並造成用戶數據丟失

###### GTK 應用的外觀

提示：若要使 Qt 和 GTK 應用程式主題一致，請閱讀統一 Qt 和 GTK 應用程式的外觀。

在 GTK 中推薦使用 breeze-gtk包 主題，這款 GTK 主題模仿了 Plasma 的 Breeze 主題。 安裝 kde-gtk-config包（該軟體是 plasma包組 的一部分），在系統設置 > 顏色和主題 > 應用風格 > 配置 GNOME/GTK 應用風格中選擇 `Breeze` 並重新登陸即可。

本文或本節內容已經過時。

原因： Plasma GTKd 後台服務會在Plasma啟動時覆蓋 GTK 設置。 (在Talk:KDE討論)

在某些主題下，GTK應用的提示條在白色背景下會顯示難以閱讀的白色字體內容。要改變GTK2應用的顏色，找到 `.gtkrc-2.0` 文件中的tooltips部分並更改。對於GTK3應用，需要更改 `gtk.css` 和 `settings.ini` 兩個文件。

有些GTK2程序如 vuescan-binAUR 在Breeze或Adwaita皮膚的Plasma會話下因「消失的勾選框」問題仍然很難使用。要解決這個問題，安裝並在系統設置 > 顏色和主題 > 應用風格 > 配置 GNOME/GTK 應用風格 > GTK 主題中選擇如 numix-frost-themesAUR 提供的Numix-Frost-Light皮膚，該皮膚風格與Breeze類似。

##### 頭像

Plasma和 SDDM 都會使用存在 `/var/lib/AccountsService/icons/` 的圖像作為用戶頭像。要使用圖形界面配置，你可以使用系統設置 > 用戶。移除與用戶名對應的文件可以恢復默認頭像。

##### 小部件

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 的面板在其他窗口之上，所以其陰影也會渲染在其他窗口之上。[3] 若要在不影響其他陰影的情況下禁用此行為，安裝 xorg-xprop包 並運行:

    $ xprop -remove _KDE_NET_WM_SHADOW

然後用增大的光標選擇面板。[4] 若要自動化此操作，請安裝 xorg-xwininfo包 並創建以下腳本：

    /usr/local/bin/kde-no-shadow

    #!/bin/bash
    for WID in $(xwininfo -root -tree | sed '/"plasmashell": ("plasmashell" "plasmashell")/!d; s/^  *\([^ ]*\) .*/\1/g'); do
       xprop -id $WID -remove _KDE_NET_WM_SHADOW
    done

並添加此腳本的可執行權限。

本文或本章節的事實準確性存在爭議。

原因： 由於腳本啟動過早，自動啟動可能無法生效。（`sleep 5` 可能有用，但不可靠）（在 Talk:KDE 中討論）

在自動啟動的添加腳本中添加此腳本，可以使其在登錄時啟動：

    $ kcmshell6 autostart

##### 顯示縮放/高DPI顯示

見 HiDPI#KDE。

#### Plasma Mobile

plasma-phone-settings倉庫包含了一些能夠用於全局(`/etc/xdg`)和/或用戶 (`~/.config`) 的推薦設置。

##### 鎖屏

`/etc/xdg/kscreenlockerrc`（或 `~/.config/kscreenlockerrc`）可配置登錄後立即鎖屏[5]。這在使用 SDDM#自動登錄功能時會很有用。

    /etc/xdg/kscreenlockerrc

    [Daemon]

    LockOnStart=true

##### 虛擬鍵盤

如果你的設備具備實體鍵盤，但你想使用虛擬鍵盤，在環境變量裡添加 `KWIN_IM_SHOW_ALWAYS=1` 到你的 Wayland 會話中。

若在 Wayland 會話中使用虛擬鍵盤，請安裝 maliit-keyboard包並確保系統設置 > 鍵盤 > 虛擬鍵盤已經啟用

若在 X11 會話中使用虛擬鍵盤，應在應用程式列表/工具#屏幕鍵盤中選擇合適的包，再手動運行它。

#### 窗口裝飾

窗口裝飾可以在 AUR 中找到。

可在系統設置 > 顏色和主題 > 窗口裝飾中設置窗口裝飾，也可以直接下載更多主題並一鍵安裝。

#### 圖標主題

可在系統設置 > 顏色和主題 > 圖標中安裝或改變圖標主題。

注意：雖然所有現代的Linux發行版都共享統一的圖標主題格式，但像 GNOME這樣的桌面使用更少的圖標（特別是在工具欄和菜單中）。為這些桌面開發的主題一般都缺少 Plasma 和 KDE 應用需要的圖標。建議安裝與 Plasma 兼容的主題。
提示：部分圖標主題不從默認圖標主題中引入圖標，這將導致部分圖標缺失。要想從默認圖標主題中導入缺失圖標，把 `breeze` 添加到 `/usr/share/icon/theme-name/index.theme` 的 `Inherits=` 中，比如 `Inherits=breeze,hicolor`。每次更新圖標主題時都需要重新使用這個補丁，嘗試使用 Pacman hooks 來自動完成這項任務。

#### 空間效率

Plasma Netbook shell（上網本交互界面）已從 Plasma 5 中移除，請閱此 KDE 論壇帖子。但您仍然可以通過編輯 `~/.config/kwinrc`，在 `[Windows]` 部分加上 `BorderlessMaximizedWindows=true` 來實現類似的操作。

#### 縮略圖生成

若要在桌面和 Dolphin 內為媒體或文檔文件生成縮略圖，安裝 kdegraphics-thumbnailers包 和 ffmpegthumbs包。

要啟用或配置桌面的縮略圖功能，右鍵桌面背景，選擇配置桌面和壁紙 > 圖標 > 配置預覽插件進行設置。

在 Dolphin 中，點擊窗口右上角的打開菜單按鈕（或按下 F10），選擇配置 > 配置 Dolphin(C)... > 界面 > 預覽圖進行設置。

### 夜間顏色

Plasma 提供了一種類似 Redshift 的特性（在 Xorg 和 Wayland 上都可以使用），稱為夜間顏色。它使屏幕上的顏色呈現更暖的色調，以在指定的時間裡減少眼睛疲勞。 您可以在系統設置 > 顏色和主題 > 夜間顏色中啟動該功能。

### 列印

提示：使用 CUPS 的 Web 接口進行快速配置。這種方式配置的印表機可以被 KDE 應用使用。

您也可以在系統設置 > 印表機中配置印表機。要使用這種配置方式，必須首先安裝 system-config-printer包，print-manager包 和 cups包 軟體包。請閱 CUPS配置。

### Samba/Windows 支持

Dophin 的共享服務需要 kdenetwork-filesharing包 軟體包以及 usershares。關於如何配置 usershares（在不啟動 `smb.conf` 的情況下），見建立 Usershare 路徑。重新啟動 Samba 後，應無需進一步配置 Dolphin 的共享。

從 Dolphin 訪問 Windows 共享是無需額外設置的。使用 `smb://伺服器名或地址/共享目錄`路徑訪問共享文件。

提示：在 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，見 [6]（在 Talk:KDE 中討論）

注意：Powerdevil 可能無法覆蓋所有的 logind 設置(例如筆記本合蓋動作). 如果遇到這樣的問題，需要修改logind的設置，請參考 電源管理#ACPI 事件。

### 自動啟動

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-qt6-vlc包
- GStreamer: phonon-qt6-gstreamer-gitAUR 參見GStreamer#安裝以獲取其他編碼支持
- mpv: phonon-qt6-mpv包

KDE 僅推薦VLC後端，因為 GStreamer 不再維護。

注意：

- 可以同時安裝多個後端，並在 系統設置 > 多媒體 > 後端 中進行優先級設定。
- 根據 KDE 這個帖子, VLC 後端不支持 ReplayGain。
- 如果使用 VLC 後端，可能會遇到崩潰問題，如在每次 Plasma 發送語音警告時崩潰等等，詳見 [7]。重建 VLC 插件緩存也許能解決問題：

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

### 備份與恢復

Plasma 將個性化配置以配置文件的形式儲存在 XDG_CONFIG_HOME 中。參照 KDE 的配置文件並選擇恰當的備份恢復方案。

### systemd 啟動

自Plasam5.25起，默認啟動方式更改為使用 systemd 用戶服務實例來啟動或管理所有 Plasma 服務。可以關閉該方法並使用基於腳本的啟動，使用下列命令（此方法在未來版本中可能會停用）：

    $ kwriteconfig6 --file startkderc --group General --key systemdBoot false

更多關於該方法的實現細節可以參考 "Edmundson 的博客：Plasma 和 systemd 啟動"。

### 拼寫檢查

KDE 使用 sonnet包 提供拼寫檢查功能。查看它的可選依賴以獲取支持的拼寫檢查。

可在系統設置->拼寫檢查配置拼寫檢查。

### 使用 NVIDIA 顯卡運行 KWin Wayland

見 https://community.kde.org/Plasma/Wayland/Nvidia 。

## 應用程式

KDE項目提供了一套與Plasma桌面集成的應用程式。有關可用應用程式的完整列表，詳見 kde-applications包組 軟體包。另見 KDE 相關應用頁面。

除了 KDE 應用程式包提供的程序之外，還有許多其他可用於補充 Plasma 的應用程式。其中一些將在下面討論。

### 系統管理

#### KDE 系統設置中配置終止 Xorg-server

瀏覽到子菜單： 系統設置 > 鍵盤 > 高級（標籤）中選中「殺死 X 伺服器的按鍵序列」複選框。

#### KCM

KCM 意為 KDE 配置模塊（KConfig Module）。這些模塊在系統設置中提供了界面從而幫助您配置系統，或通過命令行（kcmshell6）。

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

- wacom tablet — KDE Wacom 驅動的圖形界面。

  https://www.linux-apps.com/p/1127862/ || kcm-wacomtablet包

可在 linux-apps.com 找到更多的 KCM 。

### 桌面搜索

KDE 使用 Baloo 索引與查找文件。

### Web 瀏覽器

下列瀏覽器可以與 Plasma 集成：

- Konqueror — KDE 項目的一部分, 支持兩種渲染引擎 – KHTML 和基於Chromium的 Qt Web引擎。

  https://konqueror.org/ || konqueror包

- Falkon — 一個具有 Plasma 集成特性的 Qt 瀏覽器，前身是 Qupzilla，使用 Qt WebEngine。

  https://userbase.kde.org/Falkon/ || falkon包

- Chromium — Chromium 及它的專有版本 Google Chrome 具有有限的 Plasma 集成。它們可以使用 KWallet 以及 KDE 窗口 打開/保存。

  https://www.chromium.org/ || chromium包

- Firefox — Firefox 可以通過配置以和 Plasma 更好地集成。參考 Firefox KDE整合。

  https://mozilla.org/firefox || firefox包

提示：從 Plasma 5.13 起，你可以通過 Plasma 與 Firefox 或 Chromium 的集成功能，從Plasma托盤控制媒體播放、顯示下載狀態以及在KRunner中找到打開選項。通過安裝plasma-browser-integration包和對應瀏覽器的插件完成。Chrome/Chromium應該已經隨包支持，Firefox插件參見Firefox KDE整合。

### 個人信息管理 (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 用於其資料庫。[8]

    ~/.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 配置文件做如下編輯：

    ~/.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 Connect

KDE Connect 提供了一些功能以將 Android 或 iOS 手機與Linux桌面連接：

- 從任何應用向 KDE 共享文件和 URL 或從 KDE 向任何應用共享，無需連線。
- 觸摸板模擬：將手機屏幕用作計算機的觸摸板。
- 通知同步（4.3+）：從桌面讀取您的安卓通知。
- 共享剪貼板：在手機和電腦之間複製粘貼。
- 多媒體遠程控制：將手機用作 Linux 媒體播放器的遙控器。
- Wi-Fi 連接：不需要 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。對於 GNOME 用戶，可以通過安裝 gnome-shell-extension-gsconnectAUR 獲得更好的集成，而不是安裝 kdeconnect包。如果要手動啟動 KDE Connect 進程, 運行 `/usr/bin/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 桌面的功能與平鋪窗口管理器的特性結合起來，這樣做可能會比KWin的平鋪腳本的效果更豐富。

Plasma 中的組件選擇設置不再允許更改窗口管理器，但仍然可以通過其它方法替換 KWin 服務。

注意：當您用不包含混成器的窗口管理器（例如 Openbox）替換 Kwin 時，任何桌面特殊效果都會失效（例如窗口透明度）。在這種情況下，請安裝並運行其他獨立的混成器，如 Xcompmgr 或 picom 。

#### 替換KWin服務

自 KDE 5.25，Plasma默認使用基於 systemd 的啟動。

要在此啟動方式中替換 KWin，首先為當前用戶禁用 (mask) `plasma-kwin_x11.service`服務避免 KWin 啟動。

接下來創建 (create) 一個新的 systemd 用戶單元 (user unit) 來啟動你選擇的窗口管理器[9]：

    ~/.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) 來切換窗口管理器。

##### 系統全局

如果有 root 權限，您也可以為所有用戶在登錄界面添加 XSession 選項。

首先，創建如下腳本並賦予執行權限：

    /usr/local/bin/plasma-i3.sh

    #!/bin/sh
    export KDEWM=/usr/bin/i3
    /usr/bin/startplasma-x11

若使用別的窗口管理器，則替換示例中的 `/usr/bin/i3`，務必保證路徑正確。若窗口管理器無法正常啟動，用戶將退回登錄界面。

然後，在 `/usr/share/xsessions/` 下創建如下文件：

    /usr/share/xsessions/plasma-i3.desktop

    [Desktop Entry]
    Type=XSession
    Exec=/usr/local/bin/plasma-i3.sh
    DesktopNames=KDE
    Name=Plasma (i3)
    Comment=KDE Plasma with i3 as the WM

#### KDE/Openbox 會話

軟體包 openbox包 為在plasma下使用 Openbox 提供了會話. 要使用這個會話，請禁用 KDE#systemd啟動，並在 display manager 菜單中選擇 KDE/Openbox .

若要手動啟動會話，請將下面這行添加到您的 xinit 配置中：

    ~/.xinitrc

    exec openbox-kde-session

### KWin 平鋪窗口腳本

下列 KWin 擴展能夠讓 KDE 變得更像一個平鋪窗口管理器：

- Polonium — 一個 Bismuth 的（非官方）繼任者。

  https://github.com/zeroxoneafour/polonium Polonium || kwin-poloniumAUR

- Kröhnkite — 受dwm啟發的一個動態平鋪擴展組件。

  https://github.com/anametologin/krohnkite || kwin-scripts-krohnkiteAUR

- KZones — 一個模仿微軟 PowerToys 和 Windows 11 的 snap layouts 功能的 KWin 腳本。

  https://github.com/gerritdevriese/kzones KZones || kwin-scripts-kzonesAUR

### 配置顯示器解析度 / 多顯示器

若要在 Plasma 中啟用解析度和多顯示器管理, 請安裝 kscreen包. 它在系統設置 > 顯示和監視器中添加了更多選項.

### 配置 ICC 特性文件

在 X11 上，ICC 特性文件由 colord包 管理，要在 Plasma 中配置這些文件，可安裝 colord-kde包。在新增的系統設置 > 色彩管理選項中，點擊導入特性文件可導入 ICC 特性文件.

### HDR

HDR功能目前是實驗性的且僅在Wayland會話中支持。相關設置位於系統設置 > 顯示和監視器 > 高動態範圍 (HDR) > 啟用 HDR。

關於更多 HDR 顯示內容信息參見HDR 監視器支持。Development details about HDR in Plasma can be found on Xaver Hugl's blog post.

[10]

### 禁用使用 Super 鍵（Windows 鍵）打開應用程式啟動器

若要禁用此功能，需要編輯`kwinrc`配置文件並設置`ModifierOnlyShortcuts`下的`Meta`為空：

    $XDG_CONFIG_HOME/kwinrc

    [ModifierOnlyShortcuts]
    Meta=

也可以運行以下命令：

    $ kwriteconfig6 --file kwinrc --group ModifierOnlyShortcuts --key Meta ""

### 在應用程式菜單中禁用書籤

安裝了Plasma Browser集成後，KDE將在應用程式啟動器中顯示書籤。

要禁用此功能，進入系統設置 > 搜索 > Plasma 搜索，取消勾選書籤

### 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`。 然後，在"更多操作>配置特殊應用程式設置/窗口設置"中，您可以設置所需的屬性。 創建的規則列表可從"系統設置>窗口管理>窗口規則"中獲取。

### 在固定位置掛載網絡共享

KDE的掛載管理器(kio-fuse包)默認會將網絡共享掛載到`${XDG_RUNTIME_DIR}/kio-fuse-長度為6個字符的隨機字符串`。

在你的家目錄創建一個目錄，例如`mnt_kio`：

    $ mkdir ~/mnt_kio

使用一個#附加配置片段覆蓋默認值：

    ~/.config/systemd/user/kio-fuse.service.d/mountpoint.conf

    [Service]
    ExecStart=
    ExecStart=/usr/lib/kio-fuse -f %h/mnt_kio

修改後如果你通過dbus或在Dolphin裡打開一些網絡共享的文件：

    $ dbus-send --session --print-reply --type=method_call \
              --dest=org.kde.KIOFuse \
                     /org/kde/KIOFuse \
                     org.kde.KIOFuse.VFS.mountUrl "smb://etcetc"

這些目錄會掛載到`~/mnt_kio`。

### 本地集成菜單

如果要將菜單欄集成到標題欄, 請從AUR安裝 material-kwin-decoration-gitAUR, 然後再 系統設置 > 窗口裝飾, 選擇 'Material' ， 然後添加應用菜單按鈕到標題欄 (最好放到從左數第二個的位置)。

### 在 Wayland 上預授權遠程控制

Xdg-desktop-portal-kde 支持來自遠程桌面會話、虛擬 KVM 切換器、kde-connect、通過 steam-input 等模擬的設備（如遊戲手柄）的遠程輸入、等等。此授權在應用程式或 desktop-portal 重啟後會失效，導致「請求遠程控制」窗口每次彈出，使得無人值守訪問無法實現。

自 Plasma 6.3 版本起，引入了一套權限系統，允許對應用程式進行預授權。目前，該權限 API 僅可通過 flatpak 命令行工具使用，但應用程式無需以 Flatpak 形式運行即可獲得預授權。

根據 the upstream docs 和 `flatpak-permission-set` 手冊頁, 你需要確認要授權的應用程式是否設置了應用程式 ID, 如果通過 KRunner 這種啟動器啟動, 該 ID 通常由 Plasma 設置， 並且一般是在 `/usr/share/applications` 下的 `.desktop` 文件。

例如，要為類似 lan-mouse 這樣的虛擬 KVM 切換器進行預授權，可以執行：

    $ flatpak permission-set kde-authorized remote-desktop de.feschbar.LanMouse yes

如果將其作為 systemd 用戶單元中的守護進程啟動，則應使用該單元的名稱：

    $ flatpak permission-set kde-authorized remote-desktop lan-mouse yes

如果你的應用程式未設置 ID，可以將該欄位留空：

    $ flatpak permission-set kde-authorized remote-desktop "" yes

## 疑難解答

### 升級到 KDE 6 後 KDE 應用在 GNOME 中啟動失敗

KDE 6應用默認使用Wayland，在GNOME Wayland（也可能在其他桌面環境/窗口管理器中） 啟動失敗。通過設置環境變量`QT_QPA_PLATFORM=xcb`來解決該問題。

這是一個KDE bugs的解決方法，問題不是來源於Wayland本身。

### 升級到 KDE 6 後圖標消失

升級到KDE 6後可能會出現所有KDE圖標不顯示的問題，但新創建的用戶正常顯示。

該問題的原因是升級過程主題丟失，因此需要手動重新指定。在系統設置 > 顏色和主題 > 圖標中再次選擇你要使用的圖標即可解決。

### 字體過大或比例異常

嘗試在系統設置 > 文字和字體中強制字體 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
    $ kbuildsycoca6 --noincremental

或者，清空 `~/.cache/` 文件夾內容，但是，這也會清除其他應用程式的緩存：

    $ rm -rf ~/.cache/*

有些情況下清空 `~/.cache/` 文件夾不能解決問題，如果你遇到了類似下文所示的錯誤：

    kf.service.sycoca: The menu spec file ( "" ) contains a Layout or DefaultLayout tag without the mandatory Merge tag inside. Please fix it.

這可能和一些過期配置文件有關，這種情況移走`~/.config/menus/`文件夾可能會修復問題。另外嘗試逐一移走`~/.config/menus/`內的配置文件來確認哪一個文件導致問題出現也是一個好的解決辦法。

#### 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 或 qt6ct），該變量將在 Qt 應用程式上強制設置 qt5ct/qt6ct，命令 `export QT_QPA_PLATFORMTHEME=` 應該取消設置環境。

一個更簡單（更可靠）的解決方案是完全卸載 qt5ct 和 qt6ct。

#### 音量控制、通知或多媒體鍵不起作用

隱藏系統托盤設置中的某些項(如音頻音量、媒體播放器或通知)也會禁用相關功能。隱藏「音頻音量」會禁用音量控制鍵，「媒體播放器」會禁用多媒體鍵（倒帶、停止、暫停），隱藏「通知」會禁用顯示通知。

#### 登錄界面不會將光標設置同步到 SDDM

登錄界面從 `~/.config/kcminputrc` 讀取您的光標設置，如果沒有此文件，則不會同步任何設置。生成此文件的最簡單方法是在系統設置 > 顏色和主題 > 光標中更改光標主題，然後將其更改回首選的光標主題。

#### 缺少面板/小部件

崩潰或硬體更改可以修改屏幕編號，即使在單個顯示器設置上也是如此。此類事件後面板/小部件可能會丟失，這可以通過在 `~/.config/plasma-org.kde.plasma.desktop-appletsrc` 文件中修復 `lastScreen` 值解決。

### 圖形問題

請先確保您已安裝了適合您 GPU 的驅動程序。詳見 Xorg#Driver installation。如果您的顯卡較舊，您可以嘗試 #禁用桌面特效或 #禁用混成。

#### 在混合顯卡的系統上強制使用獨立顯卡

Hybrid graphics 是筆記本電腦常用的一種電源管理策略，它使獨立顯卡（dGPU）在不需要時保持非活動狀態，默認使用集成顯卡（iGPU）進行基本的桌面渲染，以節省電池電量。

雖然這種方式有助於節能，但可能導致桌面性能不佳，包括動畫幀率低下和潛在的圖形異常，即使在配備性能足夠的獨立顯卡的系統上也是如此。

強制 KDE Plasma 使用獨立顯卡，可以顯著改善桌面響應速度和視覺質量。

##### 方法 1: DRI_PRIME (開源驅動程序)

對於使用開源圖形驅動程序 (Intel + AMDGPU, Intel + Nouveau) 的系統, 可通過 globally set 設置 `DRI_PRIME` 環境變量來指定使用獨立顯卡：

    DRI_PRIME=1

索引值（0 或 1）取決於你的系統配置。通過運行以下命令來驗證哪個索引對應於你的獨立顯卡：

    DRI_PRIME=1 glxinfo

注意：此方法不適用於 NVIDIA 專有驅動程序。對於 NVIDIA ，請用 PRIME render offload 或下面的 Kwin方法

##### 方法 2: KWIN_DRM_DEVICES (KWin專用)

為了直接控制 KWin 的 GPU 選擇，創建一個設置 DRM 設備優先級的啟動腳本：

    ~/.config/plasma-workspace/env/gpu.sh

    #!/bin/bash

    export KWIN_DRM_DEVICES=/dev/dri/card1:/dev/dri/card0

要識別你的 DRM 設備卡及其對應的 GPU：

    for i in /sys/class/drm/card*/device; do

        echo "Card: $(basename $(dirname $i))"

        if [ -f "$i/vendor" ] && [ -f "$i/device" ]; then

            echo "GPU: $(cat $i/vendor) $(cat $i/device)"

        fi

        echo "---"

    done

在 `KWIN_DRM_DEVICES` 變量中將獨立顯卡的設備列在前面，以使其獲得渲染優先權。

#### 獲取 KWin 的當前狀態以用於獲得幫助和調試

該命令列印出 KWin 當前狀態的摘要，包括使用的選項，使用的合成後端以及相關的 OpenGL 驅動程序功能。詳見Martin's blog。

    $ qdbus6 org.kde.KWin /KWin org.kde.KWin.supportInformation

#### 禁用桌面特效

Plasma 默認啟用了桌面特效，並且不是所有的遊戲都會自動禁用它們。您可以通過系統設置 > 窗口管理 > 桌面特效禁用桌面特效。您也可以使用 `Alt+Shift+F12` 切換桌面效果。

另外，您也可以在系統設置 > 窗口管理 > 窗口規則下創建自定義 KWin 規則，以在某個應用程式/窗口啟動時自動禁用/啟用某些項。

#### 啟用透明功能

如果使用透明背景而不啟用混成器，則會收到以下消息：

    配色方案使用的透明背景在您的桌面上似乎不受支持

在系統設置 > 顯示和監視器 > 混成器中，選中啟動時開啟混成器並重啟 Plasma。

#### 禁用混成

在系統設置 > 顯示和監視器 > 混成器中，取消選中啟動時開啟混成器並重啟 Plasma。

#### 啟用混成時全屏狀態會閃爍

在系統設置 > 顯示和監視器 > 混成器中，取消選中允許應用程式阻止混成，這可能會影響性能。

#### 桌面網格等特效卡頓

為 KWIN 設置環境變量 `QSG_USE_SIMPLE_ANIMATION_DRIVER` 可以減少部分基於 Quick Scene Graphics 的特效的卡頓現象， 只需為運行 KWIN 的服務創建一個置入式配置片段即可：

    /etc/systemd/user/plasma-kwin_x11.service.d/10-kwin_QSG_SAD.conf

    [Service]

    Environment="QSG_USE_SIMPLE_ANIMATION_DRIVER=1"

（對於 Wayland 會話，目錄名應使用 plasma-kwin_wayland.service.d）

然後重啟會話。

另一種方法是設置 `QSG_NO_VSYNC` 而非 `QSG_USE_SIMPLE_ANIMATION_DRIVER`.

#### Plasma 光標有時顯示不正確

創建 `~/.local/share/icons/default/`（或 `~/.icons/default`）目錄並在其內創建如下文件：

    ~/.local/share/icons/default/index.theme

    [Icon Theme]
    Inherits=breeze_cursors

如有需要，將 `breeze_cursors` 替換為自定義的光標主題。（光標主題可在 `/usr/share/icons/` 中找到，如`Breeze_Light`）

注意：你必須重新登錄以確保設置生效。

Wayland 下，需要安裝xdg-desktop-portal-gtk包 以保證 GTK/GNOME 應用的光標主題正確。

##### Firefox 和 Thunderbird 沒有使用光標主題

Wayland 下，Firefox 和 Thunderbird 會根據 GSettings 來確定光標如何顯示。

要將 KDE 的設置應用到GTK應用，安裝 kde-gtk-config包。

如果不想安裝額外的包，也可以手動設置光標主題：

    $ gsettings set org.gnome.desktop.interface cursor-theme cursor-theme-name

#### （例如將滑鼠懸停在超連結上時）光標抖動/閃爍

嘗試為系統和窗口管理器安裝相應的 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包 沒有安裝。

#### GTK 應用裡，字體渲染很差

參見 XDG 桌面門戶#GTK應用在KDE Plasma中字體渲染很差.

#### 窗口大小調整不當

您可能會發現某些應用程式的窗口不能正確調整大小，而是調整後的部分是透明的，滑鼠點擊會被發送到底層窗口。 要糾正這種行為，請將 KDE 的 GTK3 主題改為 oxygen-gtk 以外的其他主題。

#### 在使用 modesetting 或 nouveau 驅動時，老舊 NVIDIA 顯卡發生隨機性死機

參閱 Nouveau#Random lockups with kernel error messages.

### 聲音問題

注意：首先保證您已經安裝了 alsa-utils包。

#### 掛起後沒有聲音

如果掛起後沒有聲音並且 Kmix 沒有顯示應該顯示的音頻設備，可以嘗試重新啟動 plasmeshell 和 pulseaudio：

    $ killall plasmashell
    $ systemctl --user restart pulseaudio.service
    $ plasmashell

某些應用程式也可能需要重新啟動才能再次播放聲音。

#### 使用 GStreamer Phonon 後端時不能播放 MP3 文件

安裝 GStreamer libav 插件（軟體包gst-libav包）可以解決問題。如果仍然碰到，您可以嘗試換一個軟體包，例如phonon-qt6-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設置密碼：

    $ qdbus6 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/6 applications under environments other than KDE Plasma。

### 保存憑據和持續顯示 KWallet 對話框的問題

不建議在用戶設置中關閉 KWallet 密碼保存系統，因為需要它為每個用戶保存加密憑證（如Wi-Fi密碼）。關閉它可能會導致 KWallet 對話框持續出現。

如果您嫌每當應用程式想要訪問 Kwallet 時需要解鎖煩，您可以讓登錄管理器 SDDM 和 LightDM 在登錄時自動解鎖 KWallet，見 KDE Wallet。第一個錢包需要由 KWallet 生成（而不是"用戶生成"），以便用於系統程序憑據。

如果您不希望讓錢包憑據在內存內為每個應用打開，可以通過 kwalletmanager包 在KWallet設置中限制應用程式訪問它。

如果您不關心憑證加密，您可以在創建錢包，KWallet 要求輸入密碼時，將密碼留空。這樣，應用程式將可以在不解鎖錢包的情況下訪問密碼。

### Discover不顯示任何程序

根據你的Plasma/Qt版本，請安裝packagekit-qt6包 或 packagekit-qt5包 以解決問題。

警告：包管理者在GitHub comment裡做出了聲明：「通過packagekit管理系統軟體包，從根本上不兼容我們有著大量維護的滾動式發行版，如果用戶在重啟前沒有關注pacman的輸出日誌或合併pacnew文件，任何更新都有可能導致系統無法啟動或處於一個不穩定的狀態。」

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

如果您之前鎖定了小部件，您可能會發現自己無法再次解鎖它們。 您只需運行此命令即可：

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

新的 `Customize Layout` 不需要將它們鎖定，但如果想這樣做：

    $ qdbus6 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。

### 在暫停和休眠之前鎖定屏幕

在系統設置應用程式中，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

為了在設備掛起之前完成`loginctl lock-session`命令，必須使用`sleep`。較低的值可能不足以完成這個命令。

創建文件後，將其設為可執行的。

最後，通過轉到系統設置 > 鎖屏並選中從休眠恢復時鎖定屏幕複選框，確保啟用了 該 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，應用設置。

### 改變系統設置後沒有生效

這可能是因為系統設置無法訪問/修改位於家目錄的 .config 文件夾。

要解決該問題，你需要改變文件夾的所有者：

    # chown user:user /home/user/.config

`user` 代表你在KDE Plasma登陸的用戶。如果你的家目錄和你登陸的帳戶不同，請在相應位置更改。

如果上面的辦法無效，你可能還需要更改文件夾的權限：

    # chmod 755 /home/user/.config

### 某些應用的 Plasma 6 全局菜單不能使用

即使安裝了appmenu-gtk-module包和libdbusmenu-glib包，"全局菜單"小部件在一些應用上仍然不能使用。要解決這個問題，安裝plasma5-integration包並重啟你的會話。

## 參見

- KDE 主頁
- KDE news
- KDE Blogs
- KDE 論壇
- KDE Wikis
- KDE 缺陷跟蹤頁
- Martin Graesslin's blog
- KDE Matrix 房間

分類：​

- KDE
- 使用「模板:過時」標記的頁面或章節

隱藏分類：​

- 使用「模板:準確性」標記的頁面或章節
- 使用「模板:合併」標記的頁面或章節

KDE
新增話題