# 外观与主题

为你的工作方式设置应用、编辑器、终端和 PDF 视图。

打开**设置 → 外观**。选择与你想修改的工作区部分对应的标签页。更改只在本地生效，不会改变导出文档的格式。

![设置 → 外观 → 应用。在这里选择程序坞位置、背景、强调色、字体和主题。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-appearance-dark-window-v2.png#view=519,89,883,902)

## 程序坞位置

在应用标签页中选择**左侧**、**底部**或**右侧**。这会移动主屏幕上包含新建项目、搜索、工具和设置的程序坞。想让项目库占满两侧边距之间的整个宽度时，可以试试底部。

## 背景图案

为项目库背景选择**圆点**、**网格**或**无**。选择无会让书架使用纯色背景；文档编辑器保留自己的主题。

## 强调色

选择一个色板，更改应用的选中色和操作强调色。这只会改变界面颜色；图中的颜色以及文档的 LaTeX 或 Typst 样式仍由你在源码中控制。

## 外观模式

在**外观**下选择浅色、深色或系统。系统会跟随你的操作系统，并在它变化时一起变化。主工具栏上的外观按钮是工作时切换的更快捷方式。编辑器会随之切换到你为该模式选择的主题。参见[编辑器主题](#editor-themes)。

## 应用字体大小

用**应用字体大小**让界面中的所有文字变大或变小，范围是 13 到 20 px。章节标题、计数徽章和其他小标签会随之缩放。想要更大的源码文字，请改用编辑器字号，或开启[使用应用字体](#use-the-app-font)。

## 缩放

**缩放**会让 Oleafly 中的一切变大或变小，包括编辑器和 PDF。可以选择 80% 到 200% 的级别。工作时，按 ⌘= 和 ⌘-（Windows 和 Linux 上为 Ctrl+= 和 Ctrl+-）来调整，按 ⌘0（Ctrl+0）回到 100%。所有 Oleafly 窗口使用同一个级别，Oleafly 会记住它。你可以在**设置 → 键盘快捷键**中更改这些按键。

## 应用字体

为菜单、面板和对话框选择电脑上安装的任意字体。列表中的每个名称都用它自己的字体显示。输入文字可搜索列表，也可以输入列表中没有显示的名称。Wingdings 之类的符号字体不在其中，因为它们会把每个字母变成图案。如果你保存的字体已不再安装，设置下方会有提示说明，Oleafly 会使用默认字体。

应用字体不会改变编译进 PDF 的字体。文档字体属于模板或稿件源码。

## 编辑器字号

![设置 → 外观 → 编辑器。字体、主题、键位绑定、补全、括号和光标控件都在这个标签页中。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-editor-dark-window-v2.png#view=519,89,883,902)

打开**编辑器**标签页，选择 11 到 24 px 的字号，或选择**自定义**并输入 6 到 100 px 之间的任意大小。做屏幕共享演示时，可以试试 18 px 加上**布局 → 仅编辑器**，让工具栏和源码都保持清晰可读。

## 使用应用字体

开启**使用应用字体**，让编辑器使用应用标签页中的应用字体和应用字体大小。开启期间，编辑器自己的字体和字号控件会被锁定，它们的提示会说明原因。

## 编辑器字体

为源文件选择电脑上安装的任意字体。等宽字体排在列表前面，每个名称都用它自己的字体显示。输入文字可搜索，也可以输入列表中没有的名称。**系统默认**会回到应用默认的源码字体。该设置影响编辑器中的 `.tex`、`.typ`、`.md` 和其他文本文件。

## 编辑器主题

编辑器的浅色模式和深色模式各有一个主题。在**浅色模式主题**和**深色模式主题**下选择它们，应用切换模式时编辑器也会切换主题。**跟随应用主题**使用应用自己的浅色或深色配色。其他选项有 Linear、GitHub Dark、Dracula、Nord、Tokyo Night、Rosé Pine、Catppuccin、One Dark、Paper 和 One Light。Paper（偏暖的米白色）和 One Light 是两个浅色主题。

两个列表都接受任何主题，所以你可以在应用是浅色的同时保持深色编辑器。你在旧版本中选择的主题会同时用于两种模式，直到你更改其中一个。

## 编辑器颜色

打开**编辑器颜色**，可以更改编辑器主题的任何颜色。选择**浅色模式**或**深色模式**，编辑为该模式设置的主题。这些按钮旁边的文字会写明你正在编辑的主题。在它们下面，选择 **LaTeX**、**Typst** 或 **Markdown**，可以看到该语言的一小段示例。示例会实时显示你所做的更改。

颜色按角色分组，同一个角色在三种语言中含义相同：

| 分组 | 颜色 |
|---|---|
| **编辑器** | 背景色、文本、行号、选区 |
| **语法** | 命令、导言区和导入、标题、格式、环境、引用和交叉引用、公式、值和字符串、名称和键名、链接、括号和符号、注释 |

点击色板选择颜色。更改过的颜色会出现一个重置箭头，可恢复主题自己的颜色，**重置**则清除该主题的所有更改。Oleafly 会分别保存你对每个主题的更改，所以切换回去时它们仍在。**跟随应用主题**会为浅色模式和深色模式各保留一套。[主题自定义](#theme-customization)下的**导出主题**会把你的编辑器主题和颜色与主题的其余部分一起保存。

## 键位绑定

选择源码编辑器使用的按键集：**默认**、**Vim** 或 **Emacs**。使用 Vim 时，按 `i` 进入插入模式，按 Esc 回到普通模式。更改立即生效，**默认**会回到普通的编辑器键位。参见 [Vim 和 Emacs 按键](/docs/editor/#vim-and-emacs-keys)。

## 制表符宽度

**制表符宽度**设定一级缩进插入多少个空格，以及制表符显示的宽度：2、4 或 8。默认是 4。

## 行高

为源码行之间的间距选择**紧凑**、**标准**或**宽松**，或选择**自定义**输入 1 到 3 之间的精确值。

## 字间距

**字间距**会在字符之间增加空间：+0.5、+1 或 +1.5 px，或最多 4 px 的**自定义**值。多出来的空间也会让光标周围更宽松。

## 光标宽度

让编辑器光标宽 1、2 或 3 px。

## 光标颜色

**光标颜色**为浅色编辑器主题和深色编辑器主题各提供一个色板，所以你在白色页面上选的颜色不会在深色主题下消失。在你选择颜色之前，每个色板显示的是主题自己的光标颜色。**使用主题颜色**会回到主题的颜色。Vim 的方块光标和 Markdown 可视模式下的插入符使用同一种颜色。

## 不闪烁光标

启用**不闪烁光标**，让编辑器插入符保持常亮。在阅读或演示源码时，这样可能更容易追踪插入点。

## 长行自动换行

长行默认会自动换行。关闭**长行自动换行**，改为左右滚动。

## 自动补全

启用**自动补全**，在输入时显示建议。关闭后，需要补全列表时按 Ctrl+Space。关于引用、命令、路径和符号，参见[自动补全](/docs/autocomplete/)。

## 自动闭合括号

启用**自动闭合括号**，在你输入左括号时自动插入配对的右括号。试着在源文件中输入 `(`：光标会停在这一对括号之间，方便你输入内容。

## 自动闭合公式

启用**自动闭合公式**，在输入 `$`、`\(` 和 `\[` 时自动配对。在 Typst 中，`$` 配对需要同时开启这个开关和**自动闭合括号**。

## 自动闭合环境

启用**自动闭合环境**，在 `\begin` 行后按 Enter 时自动插入对应的 `\end`。

## 行内建议

启用**行内建议**，在光标后显示可能的补全内容。按 Tab 接受可见的建议。这是编辑器补全控件。连接模型是另一个步骤，在 AI 助手下进行。

## 粘性滚动

启用**粘性滚动**，在滚动时把当前的章节、标题和环境保持在源码窗格顶部。在很长的方法章节中使用它，可以保留周围的结构，而不必跳回标题。

## 公式预览

启用**公式预览**，在光标所在公式的上方显示渲染后的公式。参见[公式预览](/docs/editor/#math-preview)。

## 移动文件时

重命名或移动文件后，源码中可能还留着使用旧名称的路径。**移动文件时**决定 Oleafly 如何处理它们。**询问**会列出这些路径，让你更新或保留；**始终更新**不经询问直接更改；**从不更新**则不去动它们。参见[路径跟随被移动的文件](/docs/files/#paths-follow-a-moved-file)。

## Typst 格式化与提示

编辑器标签页末尾的 **Typst** 组包含**保存时格式化**、**格式化行宽**、**格式化缩进**、**参数名称提示**和 **Typst lint 检查**。[代码智能](/docs/code-intelligence/#format-a-typst-file)逐一做了说明。

## 终端字体大小

![设置 → 外观 → 终端。在这里设置文字、光标、启动行为和终端颜色。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-terminal-dark-window-v2.png#view=519,89,883,902)

在**终端**标签页中，选择 shell 输入和输出的大小。分享命令演示之前可以调大它；它不影响文档编辑器。

## 终端字体

选择终端的等宽字体。阅读编译器路径和 shell 命令时，请使用标点清晰的字体。

## 常规字重

设置普通终端文字使用的字重。选择较粗的字重之前，先比较几行输出，在深色背景上尤其如此。

## 粗体字重

设置请求粗体文字的终端输出所用的字重。它可以与常规字重不同，让标题和命令诊断信息保持区分。

## 光标样式

从**光标样式**中选择终端光标的形状。该控件影响 shell 的插入符，不影响编辑器的插入符。

## 光标闪烁

启用**光标闪烁**，让终端插入符闪烁动画。关闭后，终端插入点保持稳定。

## 随项目启动 shell

启用**随项目启动 shell**，在打开项目时启动 shell。关闭后，shell 在你第一次显示终端时才启动。如果你很少需要使用命令行，请选后一种。

## 终端颜色主题

选择终端颜色主题，或让它跟随应用。打开一个有几行输出的终端，比较命令文字、错误信息和光标。

## 终端背景色

使用**终端颜色**下的背景色选择器来选择终端表面的颜色。搭配一个仍然清晰可读的前景色。

## 终端前景色

选择终端输出的默认文字颜色。程序仍然可以输出它们自己的 ANSI 颜色。

## 终端光标色

选择一个在背景和文字之间都醒目的光标颜色。当 shell 提示符包含多种颜色时，这很有用。

## PDF 深色模式

![设置 → 外观 → PDF 预览。在这里设置默认的 PDF 颜色和悬停预览。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-pdf-dark-window-v2.png#view=519,89,883,436)

在 **PDF 预览**标签页中，启用 **PDF 深色模式**，默认反转预览颜色。这只改变显示，不改变导出的 PDF。你可以在 PDF 工具栏上为当前视图切换它。

## 只缩放 PDF

⌘= 和 ⌘-（Ctrl+= 和 Ctrl+-）会[缩放整个应用](#zoom)，包括 PDF，即使焦点在 PDF 上也是如此。要只缩放 PDF，请使用预览工具栏上的缩放控件、在触控板上双指捏合，或按住 Ctrl 滚动。用缩放菜单可让页面适合宽度或高度。

## 悬停时预览 PDF

启用**悬停时预览 PDF**，当你把鼠标悬停在项目库中的某个项目上时，显示最近一次编译出的页面。请先编译一个文档，这样书架才有页面可以显示。

## 默认主页视图

![设置 → 外观 → 项目。设置打开时的布局和文件树行为，然后管理隐藏文件的匹配模式。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-project-dark-window-v2.png#view=519,89,883,902)

选择项目库以网格还是列表打开。网格突出封面和预览；列表则让项目名称更容易浏览。

## 项目打开方式

选择初始的源码、分屏或 PDF 视图。这是你进入项目时的起始布局。工作时可以用[项目工具栏](/docs/project-toolbar/)更改它。

## 打开时显示文件树

启用后，每个项目打开时都会同时打开资源管理器。关闭可以获得更多写作空间，需要文件时再打开**资源管理器**，即左侧栏的第一个标签页。

## 隐藏文件

输入文件名或匹配模式并选择**添加**，即可在资源管理器中隐藏匹配的条目。例如，隐藏一个会干扰稿件的辅助文件名。移除它的标签即可重新显示。隐藏文件不会删除它。

## 禅模式设置

**项目**标签页末尾的**禅模式**组有两个开关。**进入全屏**会在[禅模式](/docs/editor/#zen-mode)开启时铺满屏幕，并在你离开时还原窗口。**编译时显示 PDF**会在 PDF 被隐藏时，每次编译都在编辑器旁边打开 PDF。开启和关闭禅模式的按键在**设置 → 键盘快捷键**中。

## 主题自定义

在**应用**标签页底部，打开**主题自定义**，选择要编辑的浅色或深色模式，然后更改各个颜色令牌。点击令牌的颜色圆圈，即可在系统的取色器中选择颜色。两种模式各有独立的值，在你更改之前，每个色板显示该模式的默认颜色。更改之后，请检查文字、选区、面板和按钮。编辑器内部的颜色有自己的章节，[编辑器颜色](#editor-colors)。

### 圆角半径

输入 CSS 长度，例如 `8px`、`0.5rem` 或 `1em`。清空该值则使用默认值。这会调整应用组件的圆角。

### 限定作用域的 CSS 声明

只输入声明，例如受支持的自定义属性值。该字段不接受完整的 CSS 规则、导入或 URL。无效的值会被报告，而不是被应用。

### 导入和导出主题

选择**导出主题**，保存一个可复用的主题文件。其中包含颜色令牌、圆角半径和限定作用域的 CSS，以及你的浅色和深色模式编辑器主题和[编辑器颜色](#editor-colors)。**导入主题**会应用已保存的文件。用重置控件可以恢复自定义部分的默认值。

## 试试写作设置

把源码文字设为 16 px，启用粘性滚动，打开一个很长的 LaTeX 文档，然后选择**布局 → 编辑器 + 预览**。拖动分隔线，直到源码行读起来舒适为止。编译后在预览中选择**适合宽度**。把文档的排版保存在它的源码中；外观设置只用来调整你自己的阅读环境。

## 恢复默认设置

选择外观底部的**恢复默认设置**，恢复它的偏好设置。重置同时会清除主题自定义。按钮上的圆点表示外观中有内容与默认值不同。应用重置之前，请先确认提示。