在 Debian 上安装 Sway:从裸系统到可用桌面

举报
Chocola 发表于 2026/10/24 19:32:58 2026/10/24
【摘要】 Sway 是 i3 的 Wayland 原生替代品,保留了 i3 的平铺逻辑和配置语法,同时摆脱了 X11 的历史包袱,在安全性、多显示器和高 DPI 适配上表现更好。相比 Hyprland,它更稳定、更克制,适合想要“配好就不折腾”的人。不过要先说一个关键点:Debian Wiki 明确指出 Sway 不支持 NVIDIA 闭源驱动的任何形式。如果你是 N 卡用户,建议先确认显卡架构和驱动...

Sway 是 i3 的 Wayland 原生替代品,保留了 i3 的平铺逻辑和配置语法,同时摆脱了 X11 的历史包袱,在安全性、多显示器和高 DPI 适配上表现更好。相比 Hyprland,它更稳定、更克制,适合想要“配好就不折腾”的人。

不过要先说一个关键点:Debian Wiki 明确指出 Sway 不支持 NVIDIA 闭源驱动的任何形式。如果你是 N 卡用户,建议先确认显卡架构和驱动情况,否则很可能装完直接黑屏。

安装前准备

  • 系统建议 Debian 12 Bookworm 或 Debian 13 Trixie,Debian 11 及更新版本都可以通过仓库安装 Sway。
  • 确保启用 systemd,Wayland 桌面基本依赖它。
  • 建议先装好 xwayland,兼容那些只支持 X11 的老程序。
  • 如果源太旧导致软件版本落后,可以考虑 backports,或者用 nix 包管理器补一些更新快的工具。

安装核心组件

sudo apt update
sudo apt install sway swaybg swayidle swaylock foot wofi xwayland

swaybg 是 Sway 的壁纸工具,swayidle 用于空闲管理,swaylock 用于锁屏。

再补一些日常会用到的东西:

sudo apt install waybar grim slurp brightnessctl pavucontrol pamixer \
    fonts-wqy-zenhei fonts-noto-cjk \
    pipewire pipewire-pulse wireplumber \
    xdg-desktop-portal xdg-desktop-portal-wlr

其中 grim 和 slurp 负责截图,brightnessctl 控制亮度,pamixer、pavucontrol 管理音量。

初始化配置文件

安装完不要急着启动,默认配置很简陋,容易卡住。先复制官方示例配置:

mkdir -p ~/.config/sway
cp /etc/sway/config ~/.config/sway/
nano ~/.config/sway/config

如果你原来用 i3,可以直接把 i3 配置迁移过来:

mkdir -p ~/.config/sway
cp ~/.config/i3/config ~/.config/sway/config

迁移后建议加上这一行,加载系统级的补充配置:

include /etc/sway/config.d/*

这些步骤在 Debian Wiki 里都有说明。

启动 Sway

最简单的方式是在 TTY 登录后直接输入:

sway

也可以配置 TTY1 自动启动,编辑 ~/.bash_profile:

if [[ -z $DISPLAY ]] && [[ $(tty) = /dev/tty1 ]]; then
    XKB_DEFAULT_LAYOUT=us exec sway
fi

这是 ArchWiki 推荐的做法。

如果想通过登录管理器进入,Sway 的会话文件通常位于 /usr/share/wayland-sessions/sway.desktop,GDM、SDDM 这类现代显示管理器一般能识别,不过 Sway 官方并不正式支持显示管理器。另外 GDM3 默认支持 Wayland,需要确认 /etc/gdm3/daemon.conf 中 WaylandEnable=true;SDDM 默认走 X11,但可以启动 Wayland 会话。

默认快捷键

如果直接跑默认配置,可以先记住这几个:

  • Super + Return:打开 Foot 终端
  • Super + d:打开启动器
  • Super + Shift + e:退出 Sway,需要在屏幕上方确认

这些是默认配置里的快捷键。

键盘布局与输入法

中文用户最容易踩的坑就是输入法。先配置键盘布局:

input "type:keyboard" {
    xkb_layout us,cn
    xkb_options grp:alt_shift_toggle
}

具体参数可以参考 man 5 sway-input 和 man 7 xkeyboard-config。

如果用 Fcitx5,可以在配置里加自启动:

exec_always fcitx5 -d --replace

同时安装 fcitx5、fcitx5-chinese-addons 或 fcitx5-rime,并设置环境变量:

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

状态栏、壁纸与自动启动

想要好看的状态栏可以用 Waybar,在配置里加:

bar {
    swaybar_command waybar
}

如果只想快速有个状态栏,装 i3status 更省事,在配置末尾加:

bar {
    status_command i3status
}

设置壁纸:

output "*" background /home/你的用户名/Pictures/wallpaper.jpg fill

自动启动程序用 exec 或 exec_always,比如:

exec waybar
exec swayidle -w timeout 300 'swaylock -f'

配置支持用 include 拆分成快捷键、主题、状态栏等多个文件,便于维护。

常见问题排查

鼠标不显示:虚拟机里常见,可以在 ~/.profile 加:

export WLR_NO_HARDWARE_CURSORS=1

EGL 初始化报错:部分显卡或虚拟机需要启动时加 --unsupported-gpu,也就是 sway --unsupported-gpu。

GTK 或 Qt 程序界面异常:可以尝试设置环境变量:

export GDK_BACKEND=wayland
export QT_QPA_PLATFORM=wayland;xcb

Firefox 可以设置 MOZ_ENABLE_WAYLAND=1,Chromium 使用 --ozone-platform=wayland。

NVIDIA 用户:除了前面提到的闭源驱动不兼容问题,如果坚持在 Wayland 下使用 N 卡,通常还需要启用 DRM 内核级模式设置,可以创建 /etc/modprobe.d/nvidia_drm.conf 写入:

options nvidia_drm modeset=1

然后执行 sudo update-initramfs -u。同时建议安装 libnvidia-egl-wayland1。但即便如此,Sway 对 N 卡的支持依然不如 GNOME、KDE 成熟,建议先在虚拟机试。

适合谁换 Sway

如果你习惯 i3,想平滑迁移到 Wayland,Sway 是很自然的选择。如果你追求动画、圆角、花哨特效,Hyprland 更对味;如果你只想低资源占用、稳定干活,Sway 更合适。

另外提醒一句,Debian stable 的软件包普遍偏旧,有些工具版本可能落后不少,遇到缺功能的情况可以考虑 backports 或用 nix 单独管理这些软件。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。