From b1517bc7523a7d7269273c5a034550bae6b01210 Mon Sep 17 00:00:00 2001 From: Josh Gao Date: Wed, 17 Jun 2026 13:47:20 +0800 Subject: [PATCH] =?UTF-8?q?meta:=20CLAUDE.md=20=E7=BC=96=E8=AF=91=E8=A7=84?= =?UTF-8?q?=E5=88=99=E8=A1=A5=20-synctex=3D1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 验证编译统一改为 xelatex -synctex=1，并新增一条：裸 xelatex 会覆盖 PDF 却不更新 .synctex.gz，破坏 VS Code 源码↔PDF 双向索引；若已用裸命令编过， 补跑一次 xelatex -synctex=1 重建即可。 --- CLAUDE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 470623f..747c06f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -28,7 +28,8 @@ LaTeX 学习笔记：相控阵 DoA + Doppler 估计与 CRB 推导。作者 Josh # LaTeX 操作约束 -- **默认不编译**。阶段性收尾或涉及交叉引用/宏定义的改动后用 `xelatex` 验证：至少跑两次让 ref 稳定，有 bib 引用时夹一次 `biber`；检查 log 里的 `! `、`undefined references`、`label(s) may have changed`，全部消除后再 commit。 +- **默认不编译**。阶段性收尾或涉及交叉引用/宏定义的改动后用 `xelatex -synctex=1` 验证：至少跑两次让 ref 稳定，有 bib 引用时夹一次 `biber`；检查 log 里的 `! `、`undefined references`、`label(s) may have changed`，全部消除后再 commit。 +- **编译一律带 `-synctex=1`**：裸 `xelatex` 会覆盖 PDF 却不更新 `.synctex.gz`，使 VS Code 源码↔PDF 双向索引（SyncTeX）失效。若已用裸命令编过，补跑一次 `xelatex -synctex=1` 重建 synctex 即可。 - **编译产物在 .gitignore，不主动 add，也不主动 rm**：用户在本地可能反复使用。 - **不读编译产物**：`*.aux`、`*.log`、`*.bbl`、`*.bcf`、`*.synctex.gz`、`*.run.xml`、`*.toc`、`*.ist`、`*.glo`、`*.acn`、根目录历史 PDF（`doa_doppler_est_*.pdf`）、`*.zip`。 - **preamble 指主文件 `\documentclass` 到 `\begin{document}` 之间的宏包/计数器/glossary 等设置**。新增或修复 `\newacronym` 词条不算改 preamble，按 `fix(preamble)` 处理。`\input` 列表可按重构需要调整。