本文记录一套稳定、可复用的 LaTeX 毕设项目工程方案。目标是：源码干净、编译稳定、结构清晰、方便 Git 管理。

---

一、项目目录结构

建议结构如下：

thesis/
├── main.tex
├── Sections/
│   ├── Introduction.tex
│   ├── Methodology.tex
│   ├── Experimental_Validation_and_Discussion.tex
│   ├── Conclusion_and_Future_Work.tex
│   └── References.tex
├── Figures/
├── Tables/
├── Appendices/
├── notes/
├── build/
└── .gitignore

说明：

• Sections/：各章节内容

• Figures/：所有图片资源

• Tables/：实验表格（.tex / .csv）

• Appendices/：附录

• notes/：AI草稿、临时记录

• build/：所有编译产物（不进 Git）

---

二、工具分工

• VSCode：写 LaTeX 源码 + Git 管理 + AI 辅助

• TeXStudio：负责编译 + PDF 预览

原则：

所有源码修改在 VSCode 完成
TeXStudio只用于编译和排版检查

---

三、TeXStudio 编译配置（核心）

1. 命令页设置

路径：

设置 → 命令

找到 Latexmk，修改为：

latexmk.exe -xelatex -synctex=1 -interaction=nonstopmode -file-line-error -outdir=build %

---

2. 构建页设置

路径：

设置 → 构建

设置如下：

• 默认编译器：Latexmk

• 默认查看器：PDF 查看器

• PDF 查看器：内置 PDF 查看器

---

3. 快速构建（绿色箭头）

路径：

设置 → 快速构建

设置为：

Latexmk
内置 PDF 查看器

---

四、编译结果检查

点击绿色箭头后，确认：

build 目录中生成：

build/
├── main.pdf
├── main.aux
├── main.log
├── main.toc
├── main.bbl（如有文献）

根目录不再出现：

*.aux
*.log
*.out
*.toc
*.synctex.gz

---

五、.gitignore 配置

在项目根目录新建 .gitignore：

# LaTeX intermediate files
*.aux
*.log
*.out
*.toc
*.synctex.gz
*.fls
*.fdb_latexmk
*.bbl
*.blg
*.bcf
*.run.xml
*.nav
*.snm
*.lof
*.lot
*.xdv

# Build directory
build/

# OS
.DS_Store
Thumbs.db

# Editor
.vscode/

# Temp
*.tmp
*.bak
*.swp

---

六、日常使用流程

每天工作流程：

1. VSCode 修改 .tex

2. TeXStudio 点击绿色箭头编译

3. 检查 build/main.pdf

4. Git 提交

---

七、关键原则

• 所有编译文件必须进入 build/

• 根目录只保留源码

• 不在 TeXStudio 编辑正文

---

这套配置适用于毕业论文、中大型 LaTeX 项目。