Debian 13 KDE 系统初始化指南

适用环境：Debian 13 “Trixie”、KDE Plasma 桌面、x86_64 架构约定：命令前缀 $ 表示普通用户执行；sudo 表示需要管理员权限（root 也可）。说明：本文档命令均可复制到终端直接执行，建议按顺序从上到下操作。

0. 准备工作

0.1 确认 sudo 可用

Debian 安装时如果设置了 root 密码，普通用户默认没有 sudo 权限；若安装时留空 root 密码，则首个用户会自动加入 sudo 组。

# 测试 sudo
sudo -v

如果提示 command not found 或 不在 sudoers 文件中，先切换到 root 处理：

su -                                   # 输入 root 密码
apt update
apt install -y sudo
usermod -aG sudo 你的用户名            # 把用户名替换成实际用户名
exit                                   # 退出 root

然后注销重新登录（或重启），使 sudo 组权限生效。

0.2 确认系统版本

lsb_release -a      # 应显示 Debian GNU/Linux 13 (trixie)
cat /etc/os-release # 确认 VERSION_CODENAME=trixie
uname -m             # 应显示 x86_64

1. 换源（中科大 / 清华镜像）

官网换源说明（推荐先访问，以官网最新内容为准）：
中科大 USTC：https://mirrors.ustc.edu.cn/help/debian.html
清华 TUNA：https://mirrors.tuna.tsinghua.edu.cn/help/debian/

重要：Debian 13 默认使用 deb822（.sources）格式，源文件位于 /etc/apt/sources.list.d/debian.sources，而不再是传统的 /etc/apt/sources.list。请按 deb822 格式修改。

1.1 备份原源文件

sudo cp /etc/apt/sources.list.d/debian.sources /etc/apt/sources.list.d/debian.sources.bak

1.2 替换为中科大源（推荐）

sudo tee /etc/apt/sources.list.d/debian.sources > /dev/null <<'EOF'
Types: deb
URIs: http://mirrors.ustc.edu.cn/debian
Suites: trixie trixie-updates
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://mirrors.ustc.edu.cn/debian-security
Suites: trixie-security
Components: main contrib non-free non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
EOF

如需源码仓库（deb-src），在每个块开头加一行 Types: deb deb-src。如需 backports，单独追加一个块：Suites: trixie-backports、Components: main contrib non-free non-free-firmware。

1.3 清华源（备选）

将上面的 URIs 改为：

URIs: https://mirrors.tuna.tsinghua.edu.cn/debian
URIs: https://mirrors.tuna.tsinghua.edu.cn/debian-security

其余字段不变。

1.4 更新系统

sudo apt update
sudo apt full-upgrade -y

看到 Get、Hit、Ign 正常输出即表示源配置成功。升级完成后可选清理：

sudo apt autoremove -y

2. 中文环境

目标：系统界面、语言改为中文；但用户主目录下的文件夹（Desktop、Documents、Downloads 等）保持英文名。

2.1 设置时区

sudo timedatectl set-timezone Asia/Shanghai
timedatectl     # 确认 Time zone 为 Asia/Shanghai (CST)

2.2 生成中文 locale

sudo apt install -y locales
sudo sed -i 's/^# *zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen
sudo locale-gen

2.3 设置系统默认语言为中文

sudo update-locale LANG=zh_CN.UTF-8 LANGUAGE=zh_CN:en

2.4 安装中文字体（否则中文显示为方块）

sudo apt install -y fonts-noto-cjk fonts-noto-cjk-extra

2.5 保持用户目录为英文名

这是关键步骤。切换为中文 locale 后，系统默认会把“桌面/文档/下载”等目录重命名为中文。按下面方法锁定为英文：

# 1. 指定用户目录语言为英文
echo 'en_US' > ~/.config/user-dirs.locale

# 2. 重新生成用户目录配置（保持英文名）
xdg-user-dirs-update

注意：下次登录 KDE 时，如果弹出“是否将目录更新为中文名称？”的提示框，请选择**“保留原名称 / Keep Old Names / 不更新”**。

2.6 注销重新登录

# 注销当前桌面会话后重新登录，即可看到中文界面

重新登录后可用以下命令验证：

locale            # LANG 应为 zh_CN.UTF-8
ls ~              # 目录仍为 Documents/Downloads/Pictures 等英文名

3. 输入法（fcitx5 + 雾凇拼音）

KDE 桌面默认使用 fcitx5 输入法框架。雾凇拼音（rime-ice）是基于 Rime 引擎的开源拼音方案，词库新、纠错好。

3.1 安装 fcitx5 + Rime

sudo apt install -y im-config fcitx5 fcitx5-rime fcitx5-config-qt fcitx5-chinese-addons librime-plugin-lua

fcitx5-rime：Rime 输入法引擎（雾凇拼音的底层）
fcitx5-config-qt：Qt 图形配置工具（KDE 使用）
librime-plugin-lua：Rime 的 Lua 插件，雾凇拼音部分扩展功能需要
fcitx5-chinese-addons：系统自带的拼音方案（作为备用）

3.2 设置 fcitx5 为默认输入法框架

im-config -n fcitx5

3.3 （可选）显式配置环境变量

KDE 通常会通过 fcitx5 自启动自动配置，但为兼容 X11 应用可显式添加：

cat >> ~/.profile <<'EOF'

# fcitx5 input method
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
EOF

3.4 安装雾凇拼音

# 备份旧的 Rime 配置（如有）
mv ~/.local/share/fcitx5/rime ~/.local/share/fcitx5/rime.bak.$(date +%F) 2>/dev/null

# 克隆雾凇拼音配置到 Rime 用户目录
git clone --depth=1 https://github.com/iDvel/rime-ice.git ~/.local/share/fcitx5/rime

克隆完成后，仓库自带的 default.custom.yaml 已默认启用「雾凇拼音（rime_ice）」方案，无需再手动配置。如需自定义（如候选词数量），可自行新建 ~/.local/share/fcitx5/rime/default.custom.yaml，参考雾凇拼音仓库文档。

3.5 生效

注销并重新登录（使 fcitx5 框架生效，系统托盘出现键盘/企鹅图标）。
打开「Fcitx 5 配置」（系统设置或应用菜单中搜索 Fcitx），在输入法列表中添加「中州韵 / Rime」。
右键系统托盘的 fcitx5 图标 → 选择「重新部署 / Deploy」，加载雾凇拼音词库。

# 也可以命令行重新部署
fcitx5-remote -r

3.6 使用

功能	快捷键
中英文切换	`Ctrl + Space`
临时切换中英文	`Shift`（或雾凇拼音默认的 `Shift`）
切换输入方案	`Ctrl + 反引号`（`）
中英文标点切换	`Ctrl + .`

3.7 更新雾凇拼音词库

cd ~/.local/share/fcitx5/rime && git pull
fcitx5-remote -r

4. 开发环境

4.1 基础工具

sudo apt install -y git vim wget curl build-essential zip unzip ca-certificates gnupg

4.2 fnm 管理多版本 Node.js

fnm（Fast Node Manager）是用 Rust 编写的轻量、快速的 Node.js 版本管理器。

# 安装 fnm（脚本会自动写入 ~/.bashrc）
curl -fsSL https://fnm.vercel.app/install | bash

# 使当前终端立即生效
source ~/.bashrc

# 验证
fnm --version

安装 Node.js 14 / 18 / 22：

fnm install 14
fnm install 18
fnm install 22

# 设置默认版本（推荐 22）
fnm default 22

# 查看已安装版本
fnm ls

切换版本：fnm use 18
国内加速：fnm install 18 --node-dist-mirror https://npmmirror.com/mirrors/node（或设置环境变量 NODE_BUILD_MIRROR_URL）
建议配置 npm 国内镜像：npm config set registry https://registry.npmmirror.com

4.3 sdkman 管理多版本 JDK

sdkman 统一管理 JDK、Maven 等多套 SDK 版本。

# 安装 sdkman
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 验证
sdk version

安装 JDK 8 / 11 / 17（Temurin 发行版）：

# 先查看可用版本标识符（版本号会更新，以下为示例）
sdk list java | grep -E 'tem$|tem '

# 安装（版本号以 sdk list java 实际输出为准）
sdk install java 8.0.432-tem
sdk install java 11.0.25-tem
sdk install java 17.0.13-tem

# 设置默认 JDK
sdk default java 17.0.13-tem

# 查看已安装
sdk list java

临时切换：sdk use java 8.0.432-tem
查看当前：java -version

4.4 安装 Maven 3.9.3（通过 sdkman）

sdk install maven 3.9.3
sdk default maven 3.9.3

# 验证
mvn -version

可选：配置阿里云 Maven 镜像，编辑 ~/.m2/settings.xml，在 <mirrors> 中加入阿里云 <mirror>。

4.5 安装 Docker

使用 Docker 官方 apt 仓库（Debian 13 专用）：

# 依赖
sudo apt install -y ca-certificates curl

# 添加 Docker 官方 GPG key
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 添加仓库（自动识别 trixie 代号）
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 启动并设置开机自启
sudo systemctl enable --now docker

# 将当前用户加入 docker 组（免 sudo 使用 docker，需重新登录生效）
sudo usermod -aG docker $USER

# 验证
docker --version
docker run --rm hello-world

国内拉取镜像较慢时，可在 /etc/docker/daemon.json 中配置 "registry-mirrors" 加速镜像（地址请以当时可用为准），然后 sudo systemctl restart docker。

5. 常用软件

5.1 RustDesk（远程桌面）

# 获取最新版本号并下载 deb
LATEST=$(curl -sL https://api.github.com/repos/rustdesk/rustdesk/releases/latest | sed -n 's/.*"tag_name": *"\([^"]*\)".*/\1/p')
wget -O /tmp/rustdesk.deb "https://github.com/rustdesk/rustdesk/releases/download/${LATEST}/rustdesk-${LATEST}-x86_64.deb"
sudo apt install -y /tmp/rustdesk.deb

也可手动到 https://github.com/rustdesk/rustdesk/releases 下载对应 .deb。提示：RustDesk 被控端在 Wayland 下可能无法远程控制，如需被控建议切换到 X11 会话。

5.2 微信（官方 Linux 版）

# 官方下载页：https://linux.weixin.qq.com/
wget -O /tmp/wechat.deb "https://dldir1v6.qq.com/weixin/Universal/Linux/WeChatLinux_x86_64.deb"
sudo apt install -y /tmp/wechat.deb

若提示依赖缺失，执行 sudo apt --fix-broken install 后再重装。首次启动用手机扫码登录。

5.3 钉钉（官方 Linux 版）

# 官方下载页：https://page.dingtalk.com/wow/z/dingtalk/simple/ddhomedownload#/
wget -O /tmp/dingtalk.deb "https://update.dingtalk.com/update/download?os=linux&arch=x86_64&channel=stable"
sudo apt install -y /tmp/dingtalk.deb

若直接下载链接失效，请从钉钉官网手动下载 com.alibabainc.dingtalk_*.deb 后执行 sudo apt install ./文件名.deb。

5.4 Visual Studio Code（官方 apt 源）

# 添加微软 GPG key
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg

# 添加仓库
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-prod.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null

# 安装
sudo apt update
sudo apt install -y code

5.5 Microsoft Edge 浏览器（官方 apt 源）

# 复用上面的微软 GPG key，直接添加 Edge 仓库
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-prod.gpg] https://packages.microsoft.com/repos/edge stable main" | sudo tee /etc/apt/sources.list.d/microsoft-edge.list > /dev/null

# 安装
sudo apt update
sudo apt install -y microsoft-edge-stable

5.6 JetBrains Toolbox + IntelliJ IDEA

# 安装 Toolbox 所需依赖
sudo apt install -y libxi6 libxrender1 libxtst6 mesa-utils libfontconfig libgtk-3-bin tar dbus-user-session

# 下载 Toolbox（Linux 版 tar.gz）
wget -O /tmp/jetbrains-toolbox.tar.gz "https://data.services.jetbrains.com/products/download?platform=linux&code=TBA"

# 解压并运行
mkdir -p ~/apps && tar -xzf /tmp/jetbrains-toolbox.tar.gz -C ~/apps
~/apps/jetbrains-toolbox-*/jetbrains-toolbox

首次运行会把自己安装到 ~/.local/share/JetBrains/Toolbox 并自动创建应用菜单图标。
在 Toolbox 界面中找到 IntelliJ IDEA（Community 免费 / Ultimate 付费），点击 Install 即可。
登录 JetBrains 账号后会自动激活许可证。

6. 收尾与验证

完成上述所有步骤后，重启系统，逐一验证：

# 1. 系统与源
lsb_release -d && sudo apt update

# 2. 语言与时区
locale | head -n 1        # zh_CN.UTF-8
timedatectl               # Asia/Shanghai
ls ~                      # 目录为英文名

# 3. 输入法
fcitx5 --version          # 托盘应出现输入法图标，可切换中文

# 4. 开发环境
git --version
node -v && fnm ls
java -version && sdk list java
mvn -version
docker --version

# 5. 常用软件（应用菜单中应能看到）
code --version
microsoft-edge --version

附录：常用国内加速镜像速查

用途	地址
Debian apt 源（中科大）	`http://mirrors.ustc.edu.cn/debian`
Debian apt 源（清华）	`https://mirrors.tuna.tsinghua.edu.cn/debian`
npm 镜像	`https://registry.npmmirror.com`
Node.js 发行包镜像	`https://npmmirror.com/mirrors/node`
Maven 镜像（阿里云）	`https://maven.aliyun.com/repository/public`
Flathub 镜像	见 https://mirrorz.org/

说明：镜像地址可能随时间调整，使用前请以各镜像站官网最新说明为准。

目录#

0. 准备工作#

0.1 确认 sudo 可用#

0.2 确认系统版本#

1. 换源（中科大 / 清华镜像）#

1.1 备份原源文件#

1.2 替换为中科大源（推荐）#

1.3 清华源（备选）#

1.4 更新系统#

2. 中文环境#

2.1 设置时区#

2.2 生成中文 locale#

2.3 设置系统默认语言为中文#

2.4 安装中文字体（否则中文显示为方块）#

2.5 保持用户目录为英文名#

2.6 注销重新登录#

3. 输入法（fcitx5 + 雾凇拼音）#

3.1 安装 fcitx5 + Rime#

3.2 设置 fcitx5 为默认输入法框架#

3.3 （可选）显式配置环境变量#

3.4 安装雾凇拼音#

3.5 生效#

3.6 使用#

3.7 更新雾凇拼音词库#

4. 开发环境#

4.1 基础工具#

4.2 fnm 管理多版本 Node.js#

4.3 sdkman 管理多版本 JDK#

4.4 安装 Maven 3.9.3（通过 sdkman）#

4.5 安装 Docker#

5. 常用软件#

5.1 RustDesk（远程桌面）#

5.2 微信（官方 Linux 版）#

5.3 钉钉（官方 Linux 版）#

5.4 Visual Studio Code（官方 apt 源）#

5.5 Microsoft Edge 浏览器（官方 apt 源）#

5.6 JetBrains Toolbox + IntelliJ IDEA#

6. 收尾与验证#

附录：常用国内加速镜像速查#

目录