需安装TeX发行版（Windows用TeX Live、macOS用MacTeX、Linux用texlive-full/most）和VSCode的LaTeX Workshop扩展；配置xelatex为默认引擎，设置ctex宏包与中文字体，用biblatex+biber管理参考文献，并按xelatex→biber→xelatex→xelatex顺序编译。
安装 LaTeX 工具链和 VSCode 扩展
VSCode 本身不带 LaTeX 编译能力，必须手动配置底层工具链和编辑器支持。Windows 用户推荐安装 TeX Live（完整版），macOS 用户用 MacTeX，Linux 用户可选 texlive-full（Ubuntu/Debian）或 texlive-most（Arch）。装完后终端运行 pdflatex --version 或 xelatex --version 能输出版本号才算成功。
VSCode 扩展只装一个：官方维护的 LaTeX Workshop。不要同时启用其他 LaTeX 插件（如 LaTeX Tools），它们会冲突。安装后重启 VSCode，插件会自动检测本地 TeX 发行版路径——若未识别，需手动在 settings.json 中设置："latex-workshop.latex.tools" 和 "latex-workshop.latex.recipes"。
配置编译命令与默认引擎
LaTeX Workshop 默认使用 pdflatex，但中文、字体或特殊符号常需 xelatex 或 lualatex。直接改默认 recipe 更可靠：
{
"latex-workshop.latex.recipes": [
{
"name": "xelatex",
"tools": ["xelatex"]
}
],
"latex-workshop.latex.tools": [
{
"name": "xelatex",
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
}
]
}
关键点：%DOC% 是占位符，代表当前打开的主 .tex 文件；-synctex=1 启用正向/反向同步；-interaction=nonstopmode 避免编译卡在错误提示上。
处理中文、字体和参考文献
中文支持不能只靠 ctex 宏包，还依赖引擎和字体配置。用 xelatex 时，导言区必须包含：
本文档主要讲述的是j2me3D游戏开发简单教程； 如今，3D图形几乎是任何一部游戏的关键部分，甚至一些应用程序也通过用3D形式来描述信息而获得了成功。如前文中所述，以立即模式和手工编码建立所有的3D对象的方式进行开发速度很慢且很复杂。应用程序中多边形的所有角点必须在数组中独立编码。在JSR 184中，这称为立即模式。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
\usepackage{ctex}
\setmainfont{Noto Serif CJK SC} % 或系统已安装的中文字体，如 "SimSun"、"PingFang SC"
\setsansfont{Noto Sans CJK SC}
\setmonofont{Noto Sans Mono CJK SC}
参考文献推荐 biblatex + biber 组合（比传统 bibtex 更兼容 Unicode）：
- 导言区加
\usepackage[backend=biber]{biblatex}和\addbibresource{references.bib} - 在
settings.json中为biber单独配 tool："name": "biber", "command": "biber", "args": ["%DOCFILE%"] - recipe 中按顺序调用：
xelatex → biber → xelatex → xelatex（两次编译确保交叉引用正确）
常见编译失败原因与排查
报错信息往往藏在 VSCode 右下角状态栏或 LaTeX Compiler 输出面板里。高频问题包括：
-
File not found: xxx.aux：首次编译前删掉所有辅助文件（.aux、.log、.out等），或用LaTeX Workshop提供的Clean auxiliary files命令 -
Undefined control sequence：检查宏包是否漏加载（如用\textcircled却没加amsmath），或命令拼写错误（\ref写成\reft） - PDF 不更新：确认当前打开的是主文件（含
\documentclass），且右键菜单中Set as root document已激活；子文件需用\input{xxx}或\include{xxx}引入 -
中文乱码或方块字：确认用了
xelatex而非pdflatex，且\setmainfont指定的字体名与系统实际安装名称完全一致（大小写、空格、中英文括号都算）
最易被忽略的是工作区设置覆盖用户设置——如果项目根目录有 .vscode/settings.json，它会优先生效，务必检查其中是否误删了 latex-workshop 相关配置。
