修复 LaTeX 找不到文件的错误
根据请求路径查找缺失的项目资源、参考文献、文档类、宏包或生成文件。
本页内容
找不到文件表示编译器无法从项目或所选 TeX Live 快照中解析某个请求名称。文件可能位于其他路径、使用不同大小写或扩展名,或不在当前项目访问范围内,并不一定真的不存在。
判断请求的文件类型#
从第一个问题开始,记下完整请求名称和当前论文的根文件。多论文项目中,项目默认打开的文档可能是另一篇。扩展名可帮助判断修复位置:
| 请求的输入 | 首先检查 |
|---|---|
.tex |
项目中的被包含章节或共享宏文件 |
| 图片扩展名 | 已上传图片的路径,以及格式是否兼容引擎 |
.bib 或参考文献输出 |
参考文献数据库及 BibTeX/Biber 流程 |
.sty、.cls、字体或格式 |
投稿方提供的文件或所选 TeX Live 快照 |
| 生成的索引、参考文献文件 | 更早的辅助步骤警告或源代码错误 |
项目自有文件以 CorTeX 文件树为准。电脑上的文件只有上传或包含在导入中后,编译器才能使用。
逐字比较路径#
项目路径使用 /,且区分大小写。LaTeX 相对路径从主文档所在文件夹开始,而不是从被包含章节的文件夹开始。
paper/
main.tex
sections/results.tex
figures/calibration.pdf从 paper/main.tex 出发,章节路径及章节内部引用的图片路径都相对于 paper:
\input{sections/results}
\includegraphics{figures/calibration.pdf}实际文件名为小写时,以下写法会失败:
\input{Results} % The project contains results.tex修正后的独立示例使用完全匹配的名称:
\begin{filecontents*}{results.tex}
\section{Results}
The included file was found.
\end{filecontents*}
\documentclass{article}
\begin{document}
\input{results}
\end{document}检查拼写、大小写、文件夹名和扩展名。\input 通常可以省略 .tex;省略图片扩展名会让引擎从受支持格式中选择,如果多个文件同名但扩展名不同,容易产生混淆。只有统一图片根目录确实能简化项目时才使用 \graphicspath,并向合作者说明约定。
检查导入、宏包和辅助步骤#
导入审核会列出因路径不安全、符号链接、冲突或体积过大而跳过的文件。回看报告,或补充上传缺失的安全依赖。对于 .sty 和 .cls,先判断应由投稿方还是 TeX Live 提供。将模板文件与官方投稿包或模板库来源比较,补齐缺失项。发行版提供的宏包应核实名称和所选快照,不要随意下载一个副本放进项目。
参考文献和索引文件缺失可能是更早错误的结果。手动创建辅助文件之前,先修复第一个 LaTeX、Biber、BibTeX 或 Xindy 问题。
重命名或移动文件时,CorTeX 会更新能够识别的文件引用。自定义命令、计算路径或纯文本中的引用仍需人工检查,可能继续指向旧位置。范围受限的共享还需确认读者能够访问所有被包含文件和图片;编译不能暴露未共享的依赖。
从预期主文档编译。成功意味着缺失输入的问题已消失,且最新 PDF 包含预期章节、图形、参考文献或文档类格式。继续阅读多文件项目组织,减少路径失配。
