项目和文件

项目是保存在你设备上的一组文件，其中一个是会被排版的主文件。你可以打开一个 .zip 或文件夹，一次导入整个项目，例如从其他 LaTeX 编辑器下载的项目。

什么是项目

项目包含你的文档所需的所有文件：.tex 源文件、存放参考文献的 .bib 文件、图片，以及绘图用的数据文件。文件可以放在文件夹中，例如 chapters/intro.tex 或 figures/plot.png。

每次修改后片刻，项目就会保存到这台设备上的浏览器存储中。项目面板按从新到旧的顺序列出它们，你可以在这里重命名、切换或删除项目。在这里删除项目，永远不会删除你保存到 Google Drive 中的副本。

主文件

其中一个 .tex 文件是主文件：也就是包含 \documentclass 和 \begin{document} 的那个。它是会被排版的文件，并通过 \input 和 \include 引入其他文件。“文件”面板会用主文件标记它。

要排版另一个文件，请在“文件”面板中打开该文件的菜单并选择排版此文件，或在主文件下选中它。

带参考文献的主文件

LaTeX复制在编辑器中打开 （在新标签页中打开）

\documentclass{article}
\begin{document}
\section{Background}
Long tables are discussed by \cite{mustermann2021}.
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

上面的示例需要同一项目中的第二个文件 refs.bib。在编辑器中打开它即可看到这两个文件。关于参考文献的更多内容，请参阅参考文献与引用。

多个 .tex 文件

把较长的文档拆分为每章一个文件，再把它们引入主文件。\input{chapters/intro} 会在命令所在的位置插入该文件；\include{chapters/intro} 的作用相同，但会先另起一页。.tex 扩展名可以省略。

\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\input{appendix}
\end{document}

被引入的文件中的错误，会在“问题”标签页中指向正确的文件和行。详情请参阅包含多个文件的项目，其中也说明了 \includeonly 和 subfiles 宏包的情况。

添加文件

向打开的项目添加文件有几种方式：

• 把文件拖放到编辑器的任意位置。
• 在“文件”面板中，用上传添加文件，或用文件夹添加这台设备上的整个文件夹。
• 用新建文件创建一个空文件。输入 chapters/intro.tex 这样的路径，即可把它放进文件夹。
• 用 Drive 或 Drive 文件夹从你的 Google Drive 添加文件。参见保存到 Google Drive。

如果项目中已经有同名文件，编辑器会询问是替换它，还是保留你原有的文件。

编辑器接受 .tex、.bib、.sty、.cls、.bst、.txt、.md、.csv 等文本文件，图片（PNG、JPG、SVG、PDF 以及其他几种格式），以及会被自动解压的 .zip 文件。

从 .zip 或文件夹导入项目

大多数 LaTeX 编辑器和所有 TeX 发行版都以文件夹的形式保存项目。要把这样的项目带到 Scissor LaTeX 中：

1. 从另一个编辑器把项目下载为 .zip，或在你的电脑上找到它的文件夹。
2. 在 Scissor LaTeX 中选择新建项目，然后选择打开 .tex 或 .zip 文件或打开文件夹。
3. 编辑器会解压项目，保留其文件夹结构，并选出主文件。

如果其中有多个完整的文档，编辑器会优先选择 main.tex，其次是与文件夹同名的文件，然后是路径最短的文件。一条提示会告诉你它选择了哪个文件，你也可以在主文件下更改。

一个文件夹最多可以包含 2,000 个文件、100 MB。如果文件夹更大，会优先保留源文件，其余部分会被略过并统计数量。

文档需要但项目中缺少的文件

打开或添加文件后，编辑器会检查文档引用了哪些内容：\includegraphics 中的图片、.bib 文件、\input 和 \include 中的文件，以及图表的数据文件。如果缺少某些文件，“文件”面板会把它们列出来，并提供上传或从 Drive 添加的按钮。只按文件名添加的文件会放到文档期望的位置，所以如果文档需要 figures/plot.png，plot.png 就会放进 figures/。

在此之前，缺失的图片会显示为一个带有文件名的虚线框，“问题”标签页也会说明缺少哪些图片。

项目中有一张图片，另一张缺失

LaTeX导言区： \usepackage{graphicx}复制在编辑器中打开 （在新标签页中打开）

\includegraphics[width=0.45\linewidth]{figures-plot.png}

\includegraphics[width=0.45\linewidth]{figures/missing.png}

“问题”标签页： Images not in the project: figures/missing.png

你自己的 .sty 和 .cls 文件

项目可以包含你自己的 .sty 和 .cls 文件：它们会被保留、保存到 Drive，并随项目一起导出。不过，预览目前还不会读取它们。指向你自己文件的 \usepackage{mymacros} 会在“问题”标签页中被报告为不可用的宏包，其中定义的命令也会被跳过。

在此情况改变之前，请把你需要的 \newcommand 和 \newenvironment 行从 .sty 文件复制到主文件的导言区。它们在那里可以正常工作，文档在 TeX 发行版中也仍然可以编译。

\documentclass{article}
% from mymacros.sty
\newcommand{\project}{River Survey}
\newcommand{\unit}[1]{\,\mathrm{#1}}
\begin{document}
The \project{} measured a flow of $44\unit{m^3/s}$.
\end{document}

与 TeX 发行版的不同之处

本页的每个示例都在构建网站时由 Scissor LaTeX 排版。 最后更新：2026-11-07