Atom需系统TeX环境支持，安装latexmk或pdflatex并配置PATH；PDF预览需设输出目录为.且用支持重载的阅读器；中文须用xelatex+lualatex引擎及fontspec+中文字体；构建失败先查日志、路径、文件锁与快捷键绑定。
LaTeX编译失败：找不到latexmk或pdflatex
Atom本身不带LaTeX编译能力，所有构建都依赖系统已安装的TeX发行版和latexmk（推荐）或pdflatex等命令。常见错误是弹出Command not found: latexmk或spawn pdflatex ENOENT。
- 先在终端运行
which latexmk或latexmk --version确认是否已安装——macOS用brew install --cask mactex，Ubuntu用sudo apt install texlive-latex-recommended latexmk，Windows建议用texlive完整安装（而非仅basic-miktex） - Atom默认从shell环境读取
$PATH，但GUI启动时可能不加载~/.zshrc或~/.bash_profile里的路径。解决方法：Mac上用atom .从终端启动；Windows/Linux确保latexmk所在目录（如C:\texlive\2023\bin\win32）已加进系统PATH环境变量 -
language-latex插件只提供语法高亮，真正触发编译的是latex插件（注意不是latex-plus，它已停更且与新版Atom冲突）
PDF预览不自动刷新或显示空白
这是最常被误认为“配置失败”的问题，实际多因编译输出路径、查看器绑定或PDF文件锁导致。
-
latex插件默认把PDF生成到.latexmk/子目录，但预览器（如pdf-view）默认只监控同级PDF。进Settings → Packages → latex → Settings，把Output Directory设为.（当前目录），并勾选Clear output directory before build - Windows下若用SumatraPDF预览，需在
latex插件设置中填入SumatraPDF -reuse-instance作为PDF Viewer Command；macOS用open -a Preview，但Preview不支持自动重载，建议换Skim并配置Skim.app/Contents/SharedSupport/displayline - 编辑时PDF被其他程序独占（比如双击打开的Adobe Reader），会导致
latex插件无法覆盖写入新PDF——始终用Atom内嵌pdf-view或支持重载的第三方阅读器
中文支持乱码或编译报Unicode character … not set up for use
默认article类+pdflatex根本不认识UTF-8中文。必须切换引擎和宏包，且Atom插件不会帮你改源码。
- 用
xelatex或lualatex代替pdflatex：在latex插件设置里把Builder改为xelatex，并在.latexmkrc中加$latex = 'xelatex'; $pdflatex = 'xelatex'; - 主文档开头必须包含：
\usepackage{fontspec}+\setmainfont{Noto Serif CJK SC}（macOS）或SimSun（Windows），不能只靠ctex宏包——它只是封装，底层仍需字体支持 - 如果用
ctex，确保文档类是\documentclass[UTF8]{ctexrep}，而非\documentclass{article}后硬加\usepackage{ctex}，后者在xelatex下易出编码冲突
快捷键Ctrl-Alt-B没反应或构建日志一闪而过
这不是Atom坏了，而是构建过程被静默吞掉错误，或者快捷键被其他插件劫持。
- 先手动触发：右键编辑区 →
Build LaTeX project，看底部状态栏是否出现Building...，再点View build log（小齿轮图标旁）——90%的问题都能在这里看到具体! Undefined control sequence或File not found - 检查快捷键冲突：
Atom → Keymap...搜索latex:build，确认绑定是ctrl-alt-b（Windows/Linux）或cmd-alt-b（macOS）；有冲突就右键→Unbind -
latex插件要求当前文件后缀为.tex且文件已保存（未保存的临时文件不触发构建），同时光标必须在.tex文件内——切到console或settings标签页时快捷键无效
latexmk、字体、引擎、预览器四者路径通、权限清、协议对。最容易被忽略的是Shell环境变量加载时机和PDF文件锁——这两个问题不看构建日志根本发现不了。 
