(LaTeX) 经验帖：使用 VSCode 书写 LaTeX 文件时遇到的各种奇怪的问题

2021/04/05 更新
最近频繁地在用 VSCode + LaTeX 来书写 lab report, tmd 遇到了许许多多的问题。其中最恶心的，莫过于 LaTeX 的表格构建，体验及其恶劣。不过本博客将暂时不提及表格，而是着重于编译过程中容易出现的各种问题及其可能的解决方案

问题复现

到目前为止笔者大概遇上过几次比较恶心的报错，这个“恶心”主要体现在这个报错可以说是乱报的，经常出现的报错有：

1. tex 文件首行的大红线
2. 提示缺少 {}、$$ 或者提示引用出错

但是在大多数情况下，基本上都不是这些出的毛病。

解决方式

当读者遇到此类奇怪问题时，可以试着做以下尝试：

1 检查错误

1. 有些奇怪符号会直接导致报错，例如表示度数的符号 $\circ$
2. 部分符号需要使用 \ 转义，例如 \%
3. 如果报错主要集中在数学公式这块，那么大概率问题就出现在某一处数学公式的编译错误：例如下图中， \text{} 内部的符号错误而导致了大量的报错，将 \text{kg_f} 纠正为 \text{kg}_f 后问题解决
   

2 重新编译

这里的重新编译不仅是点击一下绿色的编译按钮，而是需要把除了 .tex .bib 之外的其他全部编译文件删去之后，再重新编译一次。

其他建议

1 分文件书写

如果需要写的报告不短，建议将内容按照 section 拆分到多个文件中进行书写，再使用诸如 \include{}, \input{} 等命令。这样的好处在于能够很快地检查具体报错出现在哪个文件中

2 检查数学公式

数学公式错误是一个非常常见的导致报错的问题，在 VS Code 中可以通过鼠标悬停预览的方式初步检查各个数学公式