LaTeX安装及过程中常见问题

LaTeX安装配置及过程中常见问题

TEX/LATEX并不是单独的程序，现在的TeX系统都是复杂的软件包，里面包含各种排版的引擎、编译脚本、格式转换工具、管理界面、配置文件、支持工具、字体及数以千计的宏包和文档。一个TeX发行版就是把所有这样的部件整合起来，打包发布的软件。

两个比较流行的发行版是CTeX套装和TeX Live。前者是Windows系统下的软件，后者可以用在各种常见的桌面操作系统上。

Windows安装LaTeX

1. CTEX安装

官网网站：https://ctex.org/

  1. CTeX_2.9.2.167_Full.exe

WinEdt11激活码：

name: *60[20220501] Warez_Down [RU-BOARD] (100 users)
code:4049089118892183088

2. TexLive安装

安装步骤：

  1. 下载镜像文件；
    https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/
image-20241108203305777
  1. 在英文路径下解压texlive.iso文件，右键install-tl-windows.bat，以管理员身份打开；
image-20241108204658453
  1. 选择安装路径（使用英文不带括号的路径），点击安装；
image-20241108204923261
  1. 漫长等待，安装完成
image-20241112162248529
  1. Win+R输入cmd，分别输入tex -v，latex -v，xelatex -v，pdflatex -v进行验证。

3. TexStudio安装

安装包下载：

安装步骤：傻瓜式安装，中间可以切换安装路径，不带中文路径，C盘容量较小可以切换其他盘符。

4. VSCode环境配置

  1. 打开VS Code，点击左侧扩展图标，搜索LaTeX Workshop,点击第一个进行下载安装。

  2. 配置环境，在VS Code界面快捷键Ctrl Shift + P，输入Open Settings，回车打开Settings.json文件。在文件中的{}中添加以下代码：

Show Code 
// 编译工具和命令
    "latex-workshop.latex.tools": [
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    // 用于配置编译链
    "latex-workshop.latex.recipes": [
        {
            "name": "xelatex",
            "tools": [
                "xelatex"
            ],
        },
        {
            "name": "pdflatex",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "xe->bib->xe->xe",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdf->bib->pdf->pdf",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }
    ],
     //文件清理。此属性必须是字符串数组
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk"
    ],
    //tex文件浏览器，可选项为"none" "browser" "tab" "external"
    "latex-workshop.view.pdf.viewer": "tab",
    //设置是否自动编译tex文件
    "latex-workshop.latex.autoBuild.run": "never",
    //右键菜单，显示内容菜单：（1）编译文件；（2）定位游标
    "latex-workshop.showContextMenu": true,
    //显示错误
    "latex-workshop.message.error.show": false,
    //显示警告
    "latex-workshop.message.warning.show": false,
    //从使用的包中自动补全命令和环境
    "latex-workshop.intellisense.package.enabled": true,
    //设置为never，为不清除辅助文件
    "latex-workshop.latex.autoClean.run": "never",
    //设置vscode编译tex文档时的默认编译链
    "latex-workshop.latex.recipe.default": "lastUsed",
    // 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
  1. 编译.tex文件

打开Latex模板，打开*.tex文件夹，这时发现左侧多了一个TEX的图标，这就是LaTeX Workshop扩展。

image-20241116141827720

点击它打开，再点击左上角构建LaTeX中的配方条目，根据*.tex文件要求选择不同的条目进行编译。

编译失败则会显示×，其左侧的!显示的是警告，点击可以查看原因。点击上方的预览按钮，即可查看生成的*.pdf文件。

image-20241116142705560

Linux 安装LaTeX

1. 基于 Debian/Ubuntu 的系统

Debian 和 Ubuntu 使用 apt 包管理器。以下是常用安装命令：

  1. 安装基础版本（适合轻量需求）：

    sudo apt update
sudo apt install texlive-base

    包含基本的 LaTeX 运行环境。

  2. 安装完整版本（推荐，包含所有功能和扩展包）：

    sudo apt install texlive-full

    这是一个较大的安装包（约 3-4 GB），包含几乎所有的 LaTeX 包。

  3. 安装常用版本（适合大多数用户）：

    sudo apt install texlive-latex-extra

    包含大部分常用的 LaTeX 功能（如图形、表格支持）。

  4. 安装 PDF 引擎和编辑工具（可选）：

    sudo apt install texlive-fonts-recommended texlive-publishers texlive-science texmaker

2. 基于 Red Hat/CentOS/Fedora 的系统

Red Hat 系列使用 dnf 或 yum 包管理器：

  1. 更新包管理器：

    sudo dnf update

  2. 安装 TeX Live：

    sudo dnf install texlive

  3. 安装完整版本（包含所有包）：

    sudo dnf install texlive-scheme-full

3. 基于 Arch Linux 的系统

Arch 系列使用 pacman 包管理器：

  1. 安装 TeX Live：

    sudo pacman -S texlive-most

  2. 安装完整版本（如果需要额外的功能）：

    sudo pacman -S texlive-full

4. 通过官方 TeX Live 安装器

如果系统提供的包版本较旧，或者你需要特定版本，可以通过 TeX Live 官方安装程序进行安装：

  1. 下载 TeX Live 安装器：

    wget https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz

  2. 解压安装器：

    tar -xvzf install-tl-unx.tar.gz
cd install-tl-*

  3. 运行安装程序：

    sudo ./install-tl

  4. 安装完成后配置环境变量： 编辑 ~/.bashrc 文件，添加以下内容：

    export PATH=/usr/local/texlive/2024/bin/x86_64-linux:$PATH

    然后运行：

    source ~/.bashrc

5. 验证安装

无论使用哪种方法，安装完成后可以通过以下命令验证：

latex --version
pdflatex --version

如果输出版本号，说明安装成功。

6. 推荐的 LaTeX 编辑器

除了安装 LaTeX，你可能还需要一个编辑器来编写文档：

  • TeXworks：轻量级，适合初学者。

  • Texmaker：跨平台，功能全面。

    sudo apt install texmaker  # Debian/Ubuntu
sudo dnf install texmaker  # Red Hat/CentOS/Fedora

  • VS Code：使用 LaTeX Workshop 插件。

  • Overleaf：在线编辑器，不需要本地安装。

常见问题

0. 环境变量

首先查看系统环境变量Path是否正常，以下为常用值，最后texlive为你本地的安装路径。

C:\Windows\system32
C:\Windows
C:\Windows\System32\Wbem
C:\Windows\System32\WindowsPowerShell\v1.0\
C:\Windows\System32\OpenSSH\
C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common
D:\install\texlive\2024\bin\windows

1. LaTeX Error: File `picins.sty' not found.

image-20240905124943012

原因：picins.sty宏包缺失。

解决方法：添加picins.sty宏包。

步骤：

  1. 从https://ctan.org/ 下载宏包；
image-20240905153702004

  1. 解压到\CTEX\MiKTeX\tex\latex\目录下，并打开\CTEX\MiKTeX\miktex\bin\x64miktex-console_admin.exe，点击任务-刷新文件名数据库，更新宏包库（相当于激活该宏包）；

    image-20240905155622980

2. WinEdt编译提示pdf文件打不开，Cannot Run pdf

原因：遇到这个问题是因为其他的PDF阅读器强制占用了winedt的pdf打开程序。

解决方法：重新添加阅读器SumatraPDF。

步骤：

  1. 在安装CTEX的文件夹搜索SumatraPDF.exe，一般在D:\Program Files\CTEX\CTeX\ctex\bin
image-20240901105058347

  1. 复制路径，D:\Program Files\CTEX\CTeX\ctex\bin\SumatraPDF.exe，注意要加上SumatraPDF.exe。

  2. 打开WinEdt，option->execution modes->pdf viewer，修改路径后确认一下

image-20240901105515360

3. 应用程序无法正常启动0xc000007b

原因：缺少c++文件或者系统dll文件缺失

解决方法：http://www.zjkweiqi.cn/news/58112.html

  1. 命令行c:\windows\SYSTEM32>后边输入【sfc /scannow】（中间有空格），然后点击键盘上的回车（enter键），就会“开始系统扫描”。
  2. 电脑通过下载DirectX Repair修复工具来检测并修复。

4. miktex更新后无法打开，报错：This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

解决方法：原文链接：https://blog.csdn.net/Etincelle/article/details/140025280

  1. 点击链接，下载miktex-qt6-bin-x64.tar.lzma

    （该文件Windows下不容易解压，已将其中的x64文件夹转换为windows下容易解压的rar格式）链接：https://pan.baidu.com/s/1ZAb0rtBvEUF3PPaMUXIsUw?pwd=c7oc 提取码：c7oc

  2. 解压程序包后，进入此文件夹，找到\texmf\miktex\bin\x64

  3. 找到MikTeX安装文件夹，进入\CTEX\MiKTeX\miktex\bin\x64，将步骤2的x64文件夹替换步骤3的x64文件夹

5. 中文用户名

解决方法：

  1. 右击电脑- ->属性- -> 高级系统设置- ->在[高级]下点击[环境变量]，

  2. 在用户变量和系统变量栏里， 找到TEMP与TMP， 分别双击，设置如下：

    变量名：TEMP 变量值：%SystemRoot%\TEMP

    变量名：TMP变量值：%SystemRoot%\TEMP

注意：若用户和系统变量栏里没有TEMP与TMP，新建即可。

6. minted的使用

7. Please ignore spurious matches unrelated to TeX.

问题现象：

Please ignore spurious matches unrelated to TeX. (To omit this check,
set the environment variable TEXLIVE_INSTALL_ENV_NOCHECK.)
CCHZPATH=D:\install\CTEX\CTeX\cct\fonts
CCPKPATH=D:\install\CTEX\CTeX\fonts\pk\modeless\cct\dpi$d
II=D:\texlive\2022\bin\win32

解决方案：设置环境变量

  1. 打开“控制面板” > “系统和安全” > “系统”，然后点击左侧的“高级系统设置”。
  2. 在“系统属性”窗口中，点击“环境变量”。
  3. 在“环境变量”窗口下的“系统变量”部分，点击“新建”。
  4. 在“变量名”中输入：TEXLIVE_INSTALL_ENV_NOCHECK
  5. 在“变量值”中输入：1
  6. 点击“确定”保存设置。

设置完成后，再次运行 TeX Live 安装程序即可。这将避免在安装过程中显示与 TeX 无关的匹配警告，使安装过程更顺畅

8. 'vars' expected but 'powershell' 不是内部或外部命令，也不是可运行的程序 found

image-20250102195322647

解决方案：添加环境变量Path C:\Windows\System32\WindowsPowerShell\v1.0\

9. 字体问题

kpathsea: Running mktextfm STFangsong/OT The command name is D:\install\texlive\2024\bin\windows\mktextfm
name = STFangsong/OT, rootname = STFangsong/OT, pointsize = mktexmf: empty or non-existent rootfile!
kpathsea: Running mktexmf STFangsong/OT.mf The command name is D:\install\texlive\2024\bin\windows\mktexmf Cannot find STFangsong/OT.mf.
kpathsea: Appending font creation commands to missfont.log.

解决方案：下载对应字体，并选择为所有用户安装，（或者尝试在字体命令后加上.ttf）

posted @   Invinc-Z  阅读(531)  评论(0)  编辑  收藏  举报
相关博文：
· 09_安装TEX发行版
· LaTeX之宏包安装
· CTEX套装的安装与使用
· LaTeX + vscode 安装配置详细步骤
· Latex下载
阅读排行：
· 阿里最新开源QwQ-32B，效果媲美deepseek-r1满血版，部署成本又又又降低了！
· SQL Server 2025 AI相关能力初探
· AI编程工具终极对决：字节Trae VS Cursor，谁才是开发者新宠？
· 开源Multi-agent AI智能体框架aevatar.ai，欢迎大家贡献代码
· Manus重磅发布：全球首款通用AI代理技术深度解析与实战指南
点击右上角即可分享
微信分享提示
AI IDE Trae