LaTeX环境搭建与ACM/IEEE论文模板适配指南 (v2024.08.15)

TL;DR: 本文档旨在提供LaTeX本地环境的搭建指南，并详细阐述如何下载、配置及适配标准的ACM/IEEE论文模板。重点关注TeX Live发行版的安装、VS Code集成以及模板的初步定制。适用于需要离线或精细控制排版流程的学术用户。

1. 前置条件与环境准备

本节列出进行LaTeX环境搭建及模板适配所需的基础条件。

1.1 操作系统要求

Windows 10/11 (64-bit)
macOS 10.15 Catalina 或更高版本
Linux (Ubuntu 20.04+, Fedora 34+, Debian 11+)

1.2 推荐工具版本

TeX Live 2023 或 MiKTeX 2.9+ (Windows)
VS Code 1.80+ (配合 LaTeX Workshop 插件)
Git 2.30+

2. LaTeX发行版安装与配置

选择一个合适的LaTeX发行版是本地环境搭建的第一步。

2.1 TeX Live 安装 (推荐)

TeX Live 是一个全面且跨平台的 LaTeX 发行版。建议通过其官方ISO镜像进行离线安装，避免网络中断问题。

下载 TeX Live ISO 镜像:

访问 TUG官网或通过镜像站下载最新版ISO。例如，搜索“清华镜像站 TeX Live 下载”。
挂载 ISO 并执行安装脚本:

Windows用户可双击ISO文件挂载。macOS/Linux用户可使用mount命令。
```
# Linux/macOS 示例
sudo mount -o loop texlive2023-xxxxxx.iso /mnt/texlive
cd /mnt/texlive
sudo ./install-tl
```
交互式安装过程中，建议选择“完整安装”（Full installation）以包含所有宏包。安装路径默认即可。

预期输出: 命令行界面显示安装进度，最终提示“Installation finished. Have fun!”

验证安装:

pdflatex --version

预期输出:

pdfTeX 3.141592653-2.6-1.40.24 (TeX Live 2023/Debian)
kpathsea version 6.3.5
... (其他版本信息)

2.2 VS Code 配置 LaTeX Workshop 插件

VS Code 配合 LaTeX Workshop 插件能提供强大的编辑和编译体验。

安装插件:

在VS Code扩展市场搜索“LaTeX Workshop”并安装。
配置编译器:

打开VS Code设置 (Ctrl+,)，搜索“latex-workshop.latex.tools”。确保pdflatex或xelatex等编译器路径正确。

Note: 默认情况下，TeX Live安装后，编译器路径会被自动添加到系统环境变量，VS Code通常能自动识别。

3. ACM/IEEE 论文模板下载与适配

标准的论文模板是确保格式符合期刊要求的基础。

3.1 模板获取

两种主要方式获取模板：

ACM 官方模板 (acmart):

访问 ACM Proceedings Template。通常提供acmart.cls及其示例文件。
IEEE 官方模板 (IEEEtran):

访问 IEEE Template Selector。下载IEEEtran.cls及其示例文件。注意区分期刊和会议模板。

Warning: 勿从非官方渠道下载模板，以防宏包缺失或版本过旧。

3.2 模板适配与初步编辑

解压模板文件:

将下载的.zip模板文件解压到一个新目录，例如 my_acm_paper/。
打开主.tex文件:

在VS Code中打开模板目录，通常主文件名为sample-acmsmall.tex (ACM) 或 bare_jrnl.tex (IEEE)。
初步编译:

使用LaTeX Workshop插件的“Build LaTeX project”功能 (通常是快捷键 Ctrl+Alt+B 或点击左侧边栏的“Build LaTeX project”图标)。

预期输出: VS Code内置的PDF预览窗口应显示编译成功的模板文档。

基本信息修改:

根据模板文件中的注释，修改文档标题、作者信息、摘要等。例如，在acmart.tex中，找到并修改以下行：

\documentclass[acmsmall,screen]{acmart}
\setcopyright{acmlicensed}
\acmJournal{TOG}
\acmYear{2023}
\acmVolume{1}
\acmNumber{1}
\acmArticle{1}
\acmMonth{1}
\acmDOI{10.1145/xxxxxx.xxxxxx}

\author{Jane Doe}
\authornote{Both authors contributed equally to this research.}
\email{[email protected]}
\affiliation{
  \institution{University of Nowhere}
  \country{USA}
}

Note: 修改后务必重新编译以查看效果。熟悉.cls和.sty文件有助于深度定制，但初学者应优先修改.tex主文件。

4. 常见问题与排查

本节列出LaTeX排版过程中常见的技术问题。

4.1 宏包缺失

问题描述: 编译时报错 ! LaTeX Error: File 'somepackage.sty' not found.

解决方案:

自动安装: 对于TeX Live，通常会提示是否自动安装缺失宏包。选择y。
手动安装: 如果自动安装失败，可使用tlmgr命令手动安装。
```
sudo tlmgr install somepackage
```
预期输出: 显示宏包下载及安装进度。

4.2 编译乱码

问题描述: PDF输出中文显示乱码或空白。