【报错】latex无法正向搜索/反向搜索

独上C楼

已于 2025-03-10 21:30:06 修改

阅读量922

点赞数 18

CC 4.0 BY-SA版权

分类专栏： linux 文章标签：笔记经验分享

于 2025-03-10 20:21:10 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_43769683/article/details/146162783

linux 专栏收录该内容

2 篇文章

订阅专栏

考虑用了中文+引用，需要xelatex和bibtex编译的情况。假设主文件是main.tex

正向搜索和反向搜索，简单理解，就是定位，就是从latex代码定位到pdf对应位置，和从pdf点击到latex源码处。这个功能，依赖于编译过程产生的 synctex.gz同步文件。

手动编译

# 在终端，按序执行四次
xelatex main.tex
bibtex main.aux
xelatex main.tex
xelatex main.tex

但是这样只会得到pdf，不会得到同步的synctex.gz文件，所以需要添加参数

xelatex -synctex=1 -interaction=nonstopmode -file-line-error main
bibtex main.aux
xelatex -synctex=1 -interaction=nonstopmode -file-line-error main
xelatex -synctex=1 -interaction=nonstopmode -file-line-error main

命令解释：

xelatex：这是命令的主体，代表使用 XeLaTeX 编译器来处理 LaTeX 文档。XeLaTeX 是 LaTeX 的一种扩展版本，它支持直接使用系统字体，能够很好地处理中文等非拉丁字符，在处理复杂的排版需求和多语言文档时表现出色。
synctex=1：这是一个编译选项，用于启用synctex功能。synctex主要用于实现源文件与生成的 PDF 之间的双向同步功能，即用户在编辑器中点击 PDF 中的某一位置，能够快速定位到源文件中对应的代码行，反之亦然。启用该功能后，编译过程中会生成.synctex.gz文件，用于记录同步信息。
interaction=nonstopmode：该选项指定了编译过程中的交互模式为nonstopmode（非停止模式）。在这种模式下，当 LaTeX 编译器遇到错误时，它不会停止编译过程并等待用户输入，而是会尝试继续编译，尽可能多地找出文档中的错误，并在编译结束后将所有错误信息一次性显示出来。这对于处理包含大量错误的文档非常有用，可以避免用户在每次遇到错误时都需要手动干预，提高了编译效率。
file-line-error：这个选项的作用是在编译出现错误时，在错误信息中显示出错的文件名和行号。这样用户能够更快速、准确地定位到源文件中出现问题的具体位置，方便进行错误排查和修正。
main：通常表示要编译的主 LaTeX 源文件的文件名（假设这里省略了.tex后缀）。在 LaTeX 项目中，main.tex一般是整个文档的入口文件，它可能会通过\input或\include命令引入其他的 LaTeX 文件来构建整个文档的结构。

自动编译

快捷键 ctrl+shift+P，输入setttings.json
注意检查是否有xelatex -> bibtex -> xelatex*2这一条，没有的话可以对照下面的json，在合适的地方加进去。

第一次从侧面的tex->构建latex项目->△xelatex -> bibtex -> xelatex*2，以后点运行，就会重复以前的命令。

// 用于配置编译链
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "LuaLaTeX",
            "tools": [
                "lualatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }],
        // 使用上次的recipe编译组合
    "latex-workshop.latex.recipe.default": "lastUsed",