2026年Atom配置LaTeX已不推荐，官方latex插件自2022年起停更，与新版Electron存在不可修复的模块冲突；唯一可行方案是改用社区维护的atom-latex插件，配合系统PDF阅读器（如Skim/SumatraPDF）及手动设主文档，并确保TeX发行版PATH正确、中文需显式指定xelatex+fontspec。
Atom 编辑器配置 LaTeX 排版环境在 2026 年已不推荐作为主力方案——latex 插件自 2022 年起停止维护，与 Atom 1.80+（基于 Electron 25+）存在不可修复的模块加载冲突，Cannot find module 'temp' 和 require is not defined 是普遍现象，不是路径或配置错误，而是生态断层。
用 atom-latex 替代官方 latex 插件
社区维护的 atom-latex（注意包名不是 latex）是目前唯一能稳定工作的替代品，它重写了模块加载逻辑，修复了 fs-plus 和 temp 兼容问题：
- 卸载所有其他 LaTeX 相关插件，尤其是
pdf-view的旧版本（它会与 atom-latex 冲突） - 通过
apm install atom-latex安装，或在 Settings → Install 中搜索atom-latex - 安装后必须重启 Atom，否则
Ctrl+Alt+B构建快捷键不会生效 - 确认插件启用状态：Settings → Packages → 搜索
atom-latex→ 确保右侧开关为 on
TeX 发行版和 PATH 必须在终端中验证可用
Atom GUI 启动时不会自动加载 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），导致插件找不到 latexmk：
- macOS：必须从终端执行
atom .启动编辑器，才能继承当前 shell 的$PATH - Windows：确保 TeX Live 安装路径（如
C:\texlive\2025\bin\win32）已加入系统环境变量PATH，而非用户变量 - Linux：运行
which latexmk和latexmk --version成功后，再启动 Atom -
atom-latex不读取插件设置里的 “TeX Path” 字段，该字段已废弃，只认系统$PATH
PDF 预览必须绕过内嵌 viewer 改用系统阅读器
atom-latex 默认调用 open -a Preview（macOS）或 start（Windows）打开 PDF，但 Preview 和 Adobe Reader 不支持自动重载，会导致预览卡死或空白：
- macOS：安装 Skim，并在
atom-latex设置中填入skim -r -g作为View Command - Windows：安装 SumatraPDF，设置
View Command为SumatraPDF -reuse-instance - Linux：用
xdg-open即可，但需确保默认 PDF 查看器支持 inotify（如 Evince 42+） - 禁用
pdf-view插件——它与 atom-latex 的 PDF 生命周期管理冲突，强行启用会导致Failed to load PDF document
中文编译必须显式指定 xelatex + fontspec，不能只靠 ctex
ctex 宏包只是封装，底层仍依赖 XeLaTeX 引擎和系统字体。Atom 插件不会自动改写你的源码或引擎选项：
- 在
atom-latex设置中，将Builder明确设为xelatex（不是latexmk） - 主文档开头必须包含：
\usepackage{fontspec}和\setmainfont{Noto Serif CJK SC}（macOS）、\setmainfont{SimSun}（Windows）或\setmainfont{FandolSong}（Linux + texlive-full） - 不要在
Latexmk Arguments中加-output-directory=build：atom-latex 无法解析生成路径，会导致 PDF 找不到 - 若用
latexmk构建，需在项目根目录新建.latexmkrc，内容为：$xelatex = 'xelatex %O %S'; $pdf_mode = 5;，并在插件设置中启用Use latexmkrc
最易被忽略的一点：atom-latex 要求你手动标记主文件。右键点击主 .tex 文件 → Set as Root Document，否则子文件编译时会报 File not found: xxx.sty——它不会向上递归查找 \documentclass，也不识别 % !TEX root = main.tex 注释。
