LaTeX论文写不出来主因是环境未配通，需先解决编译器安装、PATH配置及VS Code重启问题，再检查文档结构、引擎匹配、synctex参数与ctex宏包正确用法。
LaTeX 论文写不出来，大概率不是语法问题，而是环境根本没跑通——编译器没装、路径没配对、latex-workshop 没认出 xelatex，连最基本的 pdflatex 都报错「command not found」。先确保底层能动，再谈写作。
TeX Live 安装失败或命令不可用？重点查这三处
很多用户卡在「latex --version 不识别」，本质是系统找不到编译器，不是插件问题。
- 安装时没勾选「Add T
EX Live2026 to PATH」（Windows 安装器默认不勾），导致命令行无法调用； - 手动添加环境变量时路径写错：
D:\texlive\2026\bin\win32（不是bin\windows或bin\win64）； - 安装后没重启终端（cmd/PowerShell）或 VS Code —— 环境变量变更不会自动生效到已打开的进程。
验证方式：新开一个 PowerShell，直接运行 pdflatex --version。只有这里返回版本号，VS Code 才可能调用成功。
VS Code 中 latex-workshop 编译失败？别急着改 settings.json
90% 的编译失败，根源不在配置文件，而在当前项目缺少必要文件或引擎不匹配。
-
.tex文件里没写\documentclass{article}和\begin{document}...\end{document}—— 插件不会帮你补骨架； - 中文论文用了
pdflatex，但文档含中文（如摘要），必然报错；必须改用xelatex或lualatex并加载ctex宏包； - 没设默认 recipe：即使装了
xelatex，插件默认仍走pdflatex，需在命令面板（Ctrl+Shift+P）输入「LaTeX: Select Recipe to Run」手动选一次，或在settings.json中明确指定：
{
"latex-workshop.latex.recipe.default": "xelatex",
"latex-workshop.latex.tools": [
{
"name": "xelatex",
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
}
]
}
PDF 不自动预览 / 同步跳转失效？检查 viewer 和 synctex
VS Code 内置 PDF 查看器依赖 synctex 信息，而这个信息必须由编译器生成，且路径不能被拦截。
- 确认编译命令含
-synctex=1参数（上面xelatex示例已包含）； - PDF 输出路径不能跨盘符或含空格/中文 —— 比如
D:\My Papers\thesis.pdf可能触发安全限制，建议用默认./out/目录； - 如果用外部阅读器（如 SumatraPDF），需额外配置
latex-workshop.view.pdf.external.viewer.command，且必须关闭其「只允许一个实例」选项，否则反向同步（Ctrl+Click 跳回源码）会失败。
中文支持总出乱码？宏包和引擎必须严格配对
不是加个 \usepackage{ctex} 就完事——它只对 xelatex 和 lualatex 生效，对 pdflatex 无效，强行用会卡死或输出方框。
- 推荐起步模板开头这么写：
\documentclass[UTF8]{ctexart}
\usepackage{amsmath,amssymb}
\begin{document}
你好，世界！
\end{document}
注意：[UTF8] 是 ctex 的选项，不是文档编码声明；文件本身保存为 UTF-8（VS Code 默认就是），无需 BOM。
真正容易被忽略的是：一旦用了 ctex，所有中文字体、章节标题、页眉页脚都由它接管，不要再手动加 \usepackage{fontspec} 或 \setmainfont，除非你明确要覆盖默认行为。
