st.suckless.org

st 是 suckless.org 开发的一款面向 X Window System 的轻量级终端模拟器，核心定位是“simple terminal”（简单终端）。它的设计理念可以概括为：终端模拟本身不该复杂，代码规模应当可控，功能按需通过源码配置而非堆砌选项。如果你需要一个启动快、依赖少、行为可预测的 X 终端，并且不介意改 config.h 后重新编译，st 是合适的选择；如果你需要开箱即用的图形化设置、大量内置功能或非 X 环境支持，它可能不是最优解。

它解决什么问题

st 项目页面的 Motivation 部分直接引用了 xterm(1) README 中的自嘲：“Abandon All Hope, Ye Who Enter Here”，并指出 xterm 超过 65K 行代码，还模拟了许多“你永远用不到的冷门和过时终端”；而流行替代品 rxvt 也有 32K 行代码。st 认为，对于一个终端模拟器来说这太庞大了，是代码复杂度的典型反面案例。终端模拟不需要这么复杂——这是 st 的出发点。

因此 st 的取舍很明确：保留日常终端真正需要的 VT10X 转义序列、UTF-8 宽字符、256 色与真彩色、抗锯齿字体、剪贴板、鼠标键盘快捷键等能力，把“可配置性”交给源码而不是运行时选项。

设计理念如何落地

配置即源码

st 的配置通过 config.h 完成，默认值存放在 config.def.h。页面说明是：阅读生成的 config.h 中的注释，按需编辑。这意味着修改快捷键、字体、颜色等行为时，你改的是 C 源码并重新编译，而不是在图形界面里点选或写一份独立的配置文件。这种做法的好处是最终二进制只包含你实际要用的东西；代价是每次调整都需要编译环境。

功能范围有明确清单

页面 Status 部分列出了已实现的能力：

• 大部分 VT10X 转义序列
• 串口线路支持
• XIM 输入法支持
• 通过 utmp(1) 的 utmp 支持
• 剪贴板处理
• 鼠标和键盘快捷键（通过 config.h）
• UTF-8 宽字符支持
• 窗口缩放
• 256 色与真彩色
• 抗锯齿字体（使用 fontconfig）
• 回退字体
• 线条绘制

这份清单也说明了它的边界：它是一个 X 终端，功能围绕终端仿真和日常交互展开，更多目标写在 goals 页面，未完成项写在 TODO 中。

与 xterm、rxvt 的差异

这张表只对比页面明确提到的维度；启动速度、内存占用等具体数值页面未给出，不应据此推断。

使用前需要知道的事

st 当前版本为 0.9.3（2025-08-09 发布，源码包 48kb），项目处于活跃开发状态。获取源码的方式是：

git clone https://git.suckless.org/st

也可以从下载页获取 0.9.3 的源码包。编译前需要准备 X 开发库、fontconfig 等依赖（具体依赖以源码包内说明为准），然后编辑 config.h、编译安装。验证是否可用时，启动 st 后检查字体渲染、中文宽字符显示、剪贴板复制粘贴和窗口缩放是否符合预期；常见卡点是改了 config.h 却忘记重新编译，或快捷键与窗口管理器冲突。FAQ 维护在 st 的源码仓库中，遇到具体行为问题可以先查那里。

st 的配置通过修改源码目录中的 config.h 完成，下载则有两种方式：从官网获取源码包，或用 git 克隆仓库。当前官网提供的最新发布版是 st 0.9.3（48kb，2025-08-09）。这套流程适合愿意自己编译、接受“改配置即改源码”的 X11 用户；如果你需要开箱即用的图形化设置界面，st 不是这种路线。

下载 st 的两种方式

方式一：下载发布源码包

访问 st 官网的下载入口，获取 st 0.9.3 的源码压缩包（48kb）。适合想固定使用某个发布版本、不追踪最新提交的用户。下载后解压，进入源码目录即可开始配置和编译。

方式二：用 git 克隆源码仓库

官网给出的命令是：

git clone https://git.suckless.org/st

适合想跟进最新开发状态、或打算基于最新代码打补丁的用户。st 处于活跃开发中，仓库里的代码可能比 0.9.3 发布包更新。

两种方式得到的都是一份需要自行编译的 C 源码，没有预编译安装包。

配置 st：改 config.h

st 的配置方式很直接：配置写在 config.h 里，改完重新编译生效。官网明确说明配置通过 config.h 完成，并要求阅读生成的 config.h 中的注释，按需修改。

关键点是默认值的存放位置：默认配置保存在 config.def.h。也就是说，config.h 是你本地的实际配置文件，config.def.h 是上游维护的默认模板。第一次编译时，如果 config.h 不存在，构建过程会从 config.def.h 生成它。

具体步骤

1. 进入源码目录，确认存在 config.def.h。
2. 若尚无 config.h，先执行一次 make 让它生成，或直接复制：cp config.def.h config.h。
3. 打开 config.h，按文件内注释修改。可配置的内容包括快捷键、颜色、字体等，官网列出的相关能力有：剪贴板处理、鼠标与键盘快捷键（通过 config.h）、256 色与真彩色、抗锯齿字体（使用 fontconfig）、回退字体。
4. 保存后重新编译并安装，使改动生效。

验证方法

重新编译安装后，启动 st，检查你改动的项目是否按预期表现，例如快捷键是否触发对应动作、字体与颜色是否变化。若没有变化，最常见的原因是改的不是实际参与编译的 config.h，或改完没有重新编译。

常见卡点

• 改了 config.def.h 却没生效：日常应改 config.h；config.def.h 是默认模板，用于重新生成或对照。
• 忘记重新编译：st 的配置是编译期写入的，不重新编译就不会生效。
• 升级源码后配置丢失：拉取新代码后注意保留自己的 config.h，避免被默认模板覆盖。

st 能做什么：判断它是否适合你

官网列出的已实现功能包括：

它的设计取向是“简单终端”：官网引用 xterm 的 README 说明动机——xterm 超过 6.5 万行代码、模拟大量冷门过时终端，而终端仿真本不需要这么复杂。st 因此把功能收敛到常用范围，配置也不做成运行时选项，而是编译期常量。

适用条件：使用 X11、愿意编译源码、接受用编辑头文件的方式配置。不适合：需要图形化设置界面、或需要模拟大量冷门终端的场景。

进一步了解

• FAQ：维护在 st 的源码仓库中，遇到具体问题可先查这里。
• 目标与待办：官网提供 goals 与 TODO，可了解设计边界和尚未实现或待修复的内容。
• 补丁：官网有 patches 入口，社区补丁是 st 扩展功能的常见方式。
• 开发状态：st 处于活跃开发中，可浏览源码仓库了解最新进展。

st 是面向 X 的轻量终端模拟器，功能覆盖日常终端使用的主要需求：大部分 VT10X 转义序列、UTF-8 宽字符、256 色与真彩色、抗锯齿字体与回退字体、XIM 输入、剪贴板、鼠标与键盘快捷键、窗口缩放、串口、utmp 以及制表线绘制。它不追求模拟 xterm 中那些陈旧冷僻的终端类型，配置通过源码中的 config.h 完成，适合愿意自行编译、接受“小代码库 + 自己改配置”这一取舍的用户。

已实现的功能

根据官网 Status 一节，st 当前已实现：

官网同时说明，更完整的目标见 goals 页面，尚未实现或待修复的内容见 TODO。

设计取向：功能够用，而非大而全

st 的 Motivation 一节直接引用了 xterm(1) README 的自嘲：xterm 是发行版里“最丑的程序”，带着大量历史包袱，超过 65K 行代码，还模拟了许多你永远用不到的冷僻、过时终端；而流行的替代品 rxvt 也有 32K 行代码。st 认为终端模拟本身不需要这么复杂。

这解释了 st 的功能边界：它实现日常使用所需的终端能力，但不以兼容所有历史终端类型为目标。如果你需要模拟 tek4014 之类特殊终端，st 不是合适选择；如果只是日常 shell、编辑器、分页器和 TUI 程序，已实现的功能列表基本够用。

配置方式与前提

st 没有图形化设置界面，配置在编译阶段完成：

1. 获取源码：git clone https://git.suckless.org/st，或下载发布包（官网提供 st 0.9.3，48kb，2025-08-09）。
2. 编辑 config.h：按文件内注释修改快捷键、字体、颜色等。默认值存放在 config.def.h。
3. 重新编译安装，使配置生效。

预期结果是得到一份按你需求定制的 st 二进制。常见卡点是：直接改 config.h 后未重新编译，或升级源码时覆盖了自己的配置——后者需要自行保留改动。FAQ 维护在 st 的源码仓库中，遇到具体问题可先查那里。

适合谁，不适合谁

• 适合：使用 X、希望终端代码量小、愿意用 config.h 管理配置、需要真彩色和字体回退的 Linux/BSD 用户。
• 不适合：需要开箱即用的图形设置、需要模拟冷僻历史终端、或不愿自行编译的用户。

st 处于活跃开发中，源码可通过 git 浏览和获取，功能列表也可能随版本变化，选型时以对应版本的 goals 与 TODO 为准。

st 目前仍在积极开发中，官方 FAQ 不在网页上单独维护，而是放在 st 的源码仓库里。想跟进开发进度或查常见问题，直接浏览源码仓库，或用 git 克隆一份代码即可。

开发状态

根据 st.suckless.org 的说明，st 处于活跃开发状态。页面列出了已经实现的主要能力，可作为判断它是否满足你需求的依据：

• 大部分 VT10X 转义序列
• 串行线路支持
• XIM 支持
• 通过 utmp(1) 支持 utmp
• 剪贴板处理
• 鼠标和键盘快捷键（通过 config.h 配置）
• UTF-8 宽字符支持
• 窗口缩放
• 256 色与真彩色
• 抗锯齿字体（使用 fontconfig）
• 回退字体
• 线条绘制

尚未实现或待修复的内容，页面指向 goals 和 TODO 两个文档，需要具体确认时以这两处为准。

FAQ 在哪里查看

FAQ 维护在 st 的源码代码仓库中，不在网站单独设页面。获取方式有两种：

方式一：在线浏览源码仓库

访问 st 的源码仓库页面，在文件列表中找到 FAQ 相关文件直接查看。

方式二：用 git 克隆到本地

git clone https://git.suckless.org/st

克隆完成后，在本地仓库目录中打开 FAQ 文件阅读。这种方式同时能拿到源码和 config.def.h，方便对照配置项。

顺带说明：版本与配置

• 当前页面提供的下载版本为 st 0.9.3（48kb，2025-08-09）。
• 配置通过 config.h 完成，默认值存放在 config.def.h。编辑前先读生成后的 config.h 里的注释，按需修改。

常见卡点

• 找不到 FAQ 网页入口：这是正常的，FAQ 只在源码仓库中，按上面的方式获取。
• 克隆后不知道看哪个文件：优先看仓库根目录下的 FAQ 文件；配置问题则对照 config.h 注释和 config.def.h 默认值。
• 想确认某功能是否已支持：先对照上文“已实现”清单，清单未覆盖的再看 goals 与 TODO，避免把计划中的功能当成现成能力。

st.suckless.org 是 suckless.org 旗下 st（simple terminal）的项目主页。st 是一个面向 X 的简单终端模拟器实现，网站围绕它提供源码下载、补丁、截图、文档和开发信息。如果你在找一个轻量、以源码配置为主的 X 终端，这个站点就是它的官方入口；如果你需要开箱即用的图形化设置界面，它并不属于这类工具。

网站提供什么

页面导航和正文显示，站点主要包含以下内容：

• download：下载 st 源码包，当前页面标注的版本为 st 0.9.3（48kb，2025-08-09）
• source：浏览源码仓库，也可用 git 获取
• about：项目目标说明
• patches：社区补丁
• screenshots：界面截图
• goals / FAQ / TODO：目标、常见问题与待办事项

页面还给出克隆命令：

git clone https://git.suckless.org/st

st 是什么

st 是 X 下的终端模拟器。项目动机部分直接引用了 xterm(1) README 的自嘲：xterm 代码超过 65K 行，还模拟了许多冷门、过时的终端；而 st 想用更少的代码完成终端模拟这件“简单的事”。

根据页面 Status 部分，st 已实现的功能包括：

更细的目标见 goals，未完成或待修复的内容见 TODO。

配置方式：改 config.h 再编译

st 不走运行时配置文件，而是在编译前编辑 config.h。页面说明：配置通过 config.h 完成，按生成文件中的注释修改；默认值存放在 config.def.h。

这意味着使用流程通常是：获取源码 → 按需修改 config.h（快捷键、字体、颜色等）→ 编译安装。适合接受“改源码即配置”的用户；不习惯重新编译的人需要评估这一点。

开发状态与文档位置

页面明确写着 st 处于活跃开发中，源码仓库可直接浏览或用 git 克隆。FAQ 不在网页上单独维护，而是放在 st 源码仓库里，遇到常见问题时需要到仓库中查找。

适合谁

• 想要一个代码量小、行为可控的 X 终端，并愿意通过 config.h 定制的人
• 想读源码、打补丁或参与开发的人
• 需要查 st 官方版本、源码和补丁入口的人

如果你需要图形化配置界面、或者不想自行编译，应先考虑其他终端方案，再决定是否采用 st。