2026年Atom写LaTeX唯一可行路径是弃用官方插件、改用社区维护的atom-latex并交由外部可重载PDF阅读器预览；因Electron升级导致temp等模块兼容性断层，官方latex插件已彻底失效。
Atom 的 LaTeX 插件生态已实质性失效，2026 年仍坚持用 Atom 写 LaTeX 的唯一可行路径是：弃用官方 latex 插件，改用社区维护的 atom-latex，并绕过所有内嵌 PDF 预览逻辑——这不是配置技巧问题，而是 Electron 运行时兼容性断层导致的硬性限制。
为什么 latex 插件点击 Build 没反应或报 Cannot find module 'temp'
这是 Atom 1.80+ 内置 Electron 升级后移除旧 Node.js 兼容层的直接结果。latex 插件依赖的 temp、fs-plus 等模块在新版中被彻底废弃，手动 npm install 也无法修复，因为 require is not defined 是运行时错误，不是缺失包。
- 现象包括：控制台报
TypeError: Cannot read property 'onDidDestroy' of undefined、构建按钮灰显、快捷键ctrl-alt-b完全无响应 - 别浪费时间调试
latex插件的 Path 或 Builder 设置——它根本不会执行任何命令 - 已停更插件
latex-plus和pdf-view（旧版）会与atom-latex冲突，必须卸载
atom-latex 插件怎么装和基础启动
atom-latex 是目前唯一能跑通的分支，它重写了模块加载逻辑，适配了新版 Electron。但安装和启用有明确顺序：
- 在 Atom Settings → Install 中搜索
atom-latex（注意不是latex），安装后重启编辑器 - 确保系统已安装完整 TeX 发行版：
latexmk --version在终端必须返回版本号；macOS 用brew install --cask mactex，Ubuntu 用sudo apt install texlive-full latexmk，Windows 必须装texlive完整版（非 MiKTeX） - 右键主
.tex文件 →Set as Root Document，否则子文件编译时找不到宏包或引用会失败 - 不要在 Settings 里填
Tex Path——atom-latex直接读取系统$PATH，GUI 启动 Atom 时需从终端执行atom .（macOS/Linux）或确保 Windows PATH 已生效
PDF 预览空白或不刷新的真正原因
atom-latex 不支持内嵌 PDF 渲染，强行启用 pdf-view 会导致预览窗口空白或卡死。正确做法是交由外部阅读器处理，且必须满足“可重载”前提：
- macOS：设置
View Command为open -a Skim，并在 Skim 中开启Preferences → Sync → Check for file changes；Preview不支持自动重载，禁用 - Windows：用
SumatraPDF -reuse-instance，确保 SumatraPDF 安装路径不含空格或中文，且未被设为默认 PDF 查看器（会锁文件） - Linux：用
xdg-open，但必须配合支持 inotify 的阅读器（如 Evince 42+），旧版 Okular 会因文件锁导致编译失败 - 关键检查项：编译前确认 PDF 文件未被其他进程独占（比如双击打开的 Adobe Reader），否则
latexmk写入失败且无提示
中文编译失败或乱码的硬性条件
pdflatex + UTF-8 中文 = 必然失败。xelatex 或 lualatex 不是可选项，是强制要求，且字体声明不能省略：
- 在
atom-latexSettings 中把Builder明确设为xelatex（不是pdflatex） - 主文档开头必须含：
\usepackage{fontspec}+\setmainfont{Noto Serif CJK SC}（macOS）、\setmainfont{SimSun}（Windows）、\setmainfont{WenQuanYi Micro Hei}（Linux） - 不要依赖
ctex宏包自动处理字体——它只封装逻辑，底层仍需系统存在对应字体文件，fc-list :lang=zh可验证 -
-shell-escape参数必须加入Latexmk Arguments：填-pdf -shell-escape -interaction=nonstopmode -synctex=1，漏掉则minted、tikz等宏包直接报错退出
最易被忽略的是：Atom 不会自动识别项目级 .latexmkrc，即使文件存在且语法正确，atom-latex 也只读全局配置。所有关键参数必须手动填进插件 Settings，且 -output-directory 严禁使用——生成的 PDF 必须落在根目录，否则外部阅读器找不到文件。
