Atom 的 LaTeX 插件因官方停更与 Electron 升级已基本失效,编译失败是生态断层所致;推荐改用社区维护的 atom-latex 插件并配合系统 PDF 查看器,或直接迁移到 VS Code + LaTeX Workshop。

Atom 本身不支持 LaTeX 编译,必须靠插件组合实现「编辑 + 编译 + 预览」闭环;现在(2024 年)官方已停止维护 Atom,latex 插件长期未适配新版 Electron,多数用户会在保存或编译时遇到 Cannot find module 'temp' 或 spawn latexmk ENOENT 错误——这不是配置问题,是生态断层。
为什么 latex 插件大概率编译失败
该插件依赖 Node.js 的旧版 temp、fs-plus 等模块,而 Atom 1.80+ 内置的 Electron 版本升级后移除了对这些模块的兼容层。即使手动安装依赖,也会触发 require is not defined 运行时错误。更关键的是,插件作者自 2022 年起不再发布新版本,issue 区大量未关闭的编译失败报告。
常见现象:
- 点击「Build」无反应,控制台报
TypeError: Cannot read property 'onDidDestroy' of undefined - 配置了
latexmk路径,但插件始终调用pdflatex且不读取.latexmkrc - PDF 预览窗口空白,或提示
Failed to load PDF document
如果坚持用 Atom,只推荐这 2 种能跑通的方案
绕过 latex 插件,改用轻量级替代组合:
- 装
atom-latex(注意不是latex):它是社区维护分支,修复了模块加载问题,支持latexmk和自定义引擎参数 - 禁用所有其他 LaTeX 相关插件(尤其是
pdf-view的旧版),改用系统默认 PDF 查看器:在atom-latex设置里把View Command改成open -a Preview(macOS)或xdg-open(Linux)或start(Windows) - 确保本地已安装完整 TeX 发行版(如
texlive-full或MacTeX),并在终端中能直接运行latexmk -v -
atom-latex的Root File必须手动指定:右键主.tex文件 →Set as Root Document,否则子文件编译会找不到宏包
latexmk 参数和 .latexmkrc 怎么写才不踩坑
Atom 插件不解析项目根目录下的 .latexmkrc,除非你显式启用「Use latexmkrc」选项(在 atom-latex 设置里)。但即使启用了,它也只读取全局配置,不支持 per-project 覆盖。
安全做法是直接在插件设置中填参数:
-
Latexmk Arguments填:-pdf -shell-escape -interaction=nonstopmode -synctex=1 -
-shell-escape是调用tikz、minted等需外部程序的宏包必需项,漏掉会报! Package minted Error: You must invoke LaTeX with the -shell-escape flag - 不要在参数里加
-output-directory=build:Atom 插件无法自动定位生成的 PDF,会导致预览失败 - 中文支持别靠插件解决,用
\usepackage{ctex}+ UTF-8 编码 + XeLaTeX 引擎(在插件设置中把Latex Engine改成xelatex)
真要稳定写 LaTeX,VS Code + LaTeX Workshop 插件仍是当前最省心的选择。Atom 的 LaTeX 生态本质上已冻结,所有“教程”里的配置步骤,只要涉及 latex 插件或旧版 pdf-view,基本都失效了。

















