# 文件与文件夹

资源管理器：创建、重命名、移动和复制文件，Git 状态，主文档，标签页，图片和 PDF 视图，以及自动保存如何保护你的工作。

每个项目都是一个由文件组成的真实文件夹，而 **资源管理器** 面板（左侧栏的第一个标签页）就是你操作它的地方。多文件项目是一等公民：把各章拆成独立的 `.tex` 文件，把图片放进文件夹，Oleafly 的编译、导航和搜索都会跟着适配。

![LLaMA 的文件树。用面板标题旁的三个控件来创建文件、创建文件夹或导入现有文件。](https://cdn.oleafly.com/images/screenshots/desktop/docs/project-files-dark-window-v2.png#view=0,45,344,638)

![在项目的所有文件中搜索，然后打开一个匹配项并定位到它所在的行。](https://cdn.oleafly.com/images/gifs/desktop/project-search.gif?v=2)

## 资源管理器面板

文件夹排在前面，然后是按字母顺序排列的文件。点击文件夹可展开或折叠，点击文件会在标签页中打开，用方向键加 Enter 可以完全通过键盘导航。项目的 **主文档**（编译器开始编译的文件）会用星标标出。

面板标题栏里有两个用来创建内容的按钮：**新建文件** 和 **新建文件夹**。两者都会在当前选中的文件夹内创建；如果没有选中任何内容，则在项目根目录创建。直接在原位输入名称并按 Enter；新文件会立即打开。

杂务是看不见的：`.git` 这类内部文件夹和构建缓存永远不会出现在树中，符号链接也不会被跟随。

## 树中的 Git 状态

项目使用 Git 时，资源管理器会用与[源代码管理](/docs/git-history/)相同的字母标出已更改的文件：

| 字母 | 含义 |
|---|---|
| **M** | 已修改 |
| **A** | 已添加 |
| **D** | 已删除 |
| **R** | 已重命名 |
| **U** | 未跟踪（Git 尚未跟踪的新文件） |
| **!** | 冲突 |

字母位于该行的右端，悬停在上面会显示状态名称。文件名保持原来的颜色。包含更改的文件夹会显示一个圆点而不是字母，圆点的颜色取决于其中最紧要的更改，所以即使文件夹是折叠的，`sections/` 深处的冲突也会显示在 `sections` 这一行上。

## 右键菜单

在 **文件** 上：

- **打开**
- **设为主文档**（适用于项目引擎能编译的文件类型，例如 `.tex`、`.typ` 或 `.md`）：把这个文件设为编译入口，星标也随之移动。
- **重命名**：在原位编辑名称。已打开的标签页、未保存的编辑和主文档指向都会跟随重命名，[指向该文件的路径](#paths-follow-a-moved-file)也可以。
- **创建副本**：在原文件旁边创建 `name copy.tex`。按字节原样复制，所以图片和其他二进制文件也能安全复制。
- **删除**：确认后移除该文件。在应用中无法撤销，不过[Git 历史](/docs/git-history/)可以找回你提交过的任何内容。在就地打开的文件夹中，删除会改为把文件移到废纸篓（Windows 上是回收站）。

在 **文件夹** 上：**新建文件**、**新建文件夹**、**导入文件**、**导入文件夹**、**重命名**、**创建副本**（递归复制整个文件夹）和 **删除**。

## 移动内容：拖放

把任意文件或文件夹拖到另一个文件夹上，即可移入其中；拖到树底部的空白区域，则移到项目根目录。悬停时放置目标会高亮显示。Oleafly 会拒绝把文件夹移入它自己内部的操作。

从文件管理器拖进来的文件和文件夹，会被复制到指针下方的文件夹中。这在 macOS、Windows 和 Linux 上都可用。

## 路径会跟随移动的文件

重命名或移动文件可能会让指向它的路径失效。Oleafly 会找出这些路径并更新它们：

- 在 LaTeX 中：`\input`、`\include`、`\includegraphics`、`\bibliography` 及类似命令。
- 在 Typst 中：`#include`、`image()` 和 `bibliography()`。
- 在 Markdown 中：链接和图片。

你可以从编辑器或资源管理器发起。在编辑器中，把光标放在路径上并按 F2，或从右键菜单中选择 **重命名文件…**。**重命名文件** 对话框接受完整路径，所以它也可以把文件移到另一个文件夹，并会创建尚不存在的文件夹。在资源管理器中，使用 **重命名**，或把文件拖到新的文件夹。

默认情况下，Oleafly 会先询问。对话框会列出仍在使用旧路径的每个文件，以及其中有多少处引用。选择 **更新引用** 或 **不更新**，并勾选 **不再询问** 以记住这个答案。以后想修改，可以在 **设置 → 外观 → 编辑器** 中把 **移动文件时** 设为 **询问**、**始终更新** 或 **从不更新**。移动之后又发生改动、或无法保存的文件会保留旧路径，对话框会说明这一点。

## 标签页

打开的文件会以标签页的形式出现在编辑器上方，按你打开的顺序排列。标签页上的圆点表示有未保存的更改（它们稍后会自动保存）。Git 的[差异视图](/docs/git-history/)会作为标签页在同一排中打开，标注为文件名加上 `(Index)` 或 `(Working Tree)`。

关闭当前标签页后，会激活前一个标签页。撤销历史不会跨文件：每个文件保留自己的撤销历史。

## 不同类型的文件如何打开

- **LaTeX 和文本文件**（`.tex`、`.sty`、`.cls`、`.bib`、`.md` 等）在编辑器中打开，语法高亮与扩展名匹配。
- **图片**（`.png`、`.jpg`、`.gif`、`.webp`、`.svg` 等）以渲染后的图片打开。
- **PDF** 在 PDF 查看器中打开。
- **不透明的二进制文件**（`.zip`、`.eps`、字体文件）会显示“二进制文件，无法预览。”的提示，而不会冒着损坏的风险把它们当作文本加载。
- **`.bib` 文件** 在项目打开的那一刻也会在后台解析，这就是[引用自动补全](/docs/citations/#complete-and-navigate-references)的基础。

## 自动保存

你无需按保存。停止输入大约 1.5 秒后，编辑内容会写入磁盘，而且 Oleafly 做得比简单的计时器更周全：

- 编辑文件 A，在计时器触发前切换到文件 B，A 仍然会保存。
- 关闭或重新加载应用时，会先写入所有待保存的内容，所以在防抖窗口内退出也不会丢失任何东西。
- 编译前会先保存当前文件，所以 PDF 总是反映你所看到的内容。

## 添加已有文件

使用 **导入文件** 或 **导入文件夹**（在面板标题栏的菜单和右键菜单中）可以把磁盘上任何位置的图片、`.bib` 文件或整个目录复制进项目。导入到选中的文件夹时，副本会放在那里；否则会放在项目根目录。

因为项目也只是普通文件夹，直接的办法同样可行：用文件管理器把文件放进 `~/.oleafly/projects/<project>/`，然后重新打开项目，让 Oleafly 识别它们。请在项目关闭时进行复制（或复制后立即重新打开），因为应用的自动保存会写入它内存中的内容。
