需安装latex workshop扩展和mactex，配置xelatex编译器、ctex宏包与hiragino字体，启用synctex同步，使用subfiles管理多文件项目，并依提示解决ctex缺失、编译器误选及引用未生成等问题。
如果您希望在 VSCode 中高效编写和编译 LaTeX 学术论文，但尚未配置好环境或遇到编译失败、预览异常、中文支持缺失等问题，则可能是由于扩展未安装、编译链未指定或字体配置不兼容所致。以下是实现稳定 LaTeX 工作流的具体操作：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心扩展与编译工具
VSCode 本身不内置 LaTeX 支持，需通过扩展提供语法高亮、自动补全、实时错误检查及 PDF 编译能力；同时需系统级 LaTeX 发行版作为后端引擎。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 LaTeX Workshop，选择由 James Yu 发布的官方扩展并点击“安装”。
3、在终端中执行 brew install --cask mactex（macOS）或访问 tug.org/mactex 下载完整 MacTeX 安装包并完成安装。
4、安装完成后，在 VSCode 设置中搜索 latex-workshop.latex.recipe.default，将其值设为 latexmk。
二、配置中文支持与字体渲染
默认 LaTeX 模板对中文字符无响应，需切换至支持 Unicode 的引擎（如 XeLaTeX 或 LuaLaTeX），并显式声明中文字体，否则编译将报错或显示方块。
1、在项目根目录创建 main.tex，首行添加 \documentclass[12pt]{article}。
2、在导言区插入以下代码段：
\usepackage{fontspec}
\setmainfont{Hiragino Sans GB}
\usepackage{ctex}
3、保存文件后，右键编辑器空白处，选择 “LaTeX Workshop: Set Compiler to XeLaTeX”。
三、启用反向与正向同步（SyncTeX）
SyncTeX 允许在 PDF 预览中点击某处直接跳转到对应源码位置，反之亦然，极大提升长文档修订效率；该功能依赖编译参数与 PDF 查看器协同支持。
1、在 VSCode 设置中搜索 latex-workshop.view.pdf.viewer，设为 tab（内建标签页查看器）。
2、在设置中查找 latex-workshop.latex.tools，确认其中 xelatex 条目包含 -synctex=1 参数。
3、编译成功后，按 Cmd+Click（macOS）PDF 预览区域任意文本行，光标将自动定位至 .tex 文件对应位置。
四、管理多文件项目结构
学术论文常拆分为多个逻辑文件（如 intro.tex、method.tex、ref.bib），需通过主文件统一调用，否则编译器无法识别章节依赖关系或参考文献数据库。
1、在主文件 main.tex 导言区添加 \usepackage{subfiles}。
2、各子文件头部写入 \documentclass[main]{subfiles}，末尾使用 \end{document} 结束。
3、在主文件正文中，用 \subfile{intro} 替代原始 \input{intro} 调用方式，以启用独立编译与路径解析。
五、调试常见编译错误
LaTeX 编译失败时，VSCode 底部状态栏会显示红色错误图标，点击可展开日志；多数问题源于宏包冲突、路径错误或缺失依赖项，而非语法本身。
1、若提示 "File not found: ctex.sty"，说明 MacTeX 安装不完整，需重新运行 sudo tlmgr update --self && sudo tlmgr install ctex。
2、若 PDF 预览为空白且控制台输出 "no output PDF was created"，检查是否误选 pdfLaTeX 编译器——中文文档必须使用 XeLaTeX 或 LuaLaTeX。
3、若引用编号显示为问号，确认已执行两次编译（首次生成 .aux，第二次读取并填充交叉引用），或手动点击状态栏 “LaTeX Workshop: Build with recipe” 并选择 build。
