[前言]
一、软件介绍
LaTeX(音译“拉泰赫”):一种基于 ΤeΧ 的排版系统,常用于论文、期刊、书籍的排版
在实际编写中,我们通常采用 TeX Live + VSCode 或 TeX Live + TeXstudio 等方式。如果不想在本地配置环境,也可以使用 Overleaf 这类在线 LaTeX 编辑器
如何选择: TeX Live 是编译的核心,而 VSCode 和 TeXstudio 提供了不同的编写环境。选择哪款编辑器取决于个人偏好和具体需求。如果是使用 VSCode 编写 C、C++、Java、Python 等 All in VSCode 的话,想必你心中已经有了答案;如果是刚接触编程的新手,那么 TeXstudio 简单的安装步骤可能会更适合你
- TeX Live:提供一个完整的环境来运行 TeX 处理流程
- Overleaf:在线 LaTeX 编辑器
- VSCode:宇宙最强通用代码编辑器,可安装插件用于 LaTeX,对新手来说较为麻烦
- TeXstudio:专门为 LaTeX 设计的代码编辑器,功能丰富且对用户友好
二、教程推荐
- LaTeX 快速入门:BV11h41127FD(时长:12分钟)
强推!能对 LaTeX 有基本全面的了解
- Overleaf 快速入门:BV1cg411V7hW(时长:7分钟)
需要在线编写 LaTeX 的话请入,不需要的可以忽略
- TeX Live + VSCode 环境配置:BV1sw411t7Zw(时长:10分钟)
使用 TeX Live + VSCode 方案的可以了解一下安装步骤,配置代码本文章里有: [点击跳转]
安装 TeX Live
- TeX Live 下载地址
- [官方网址 tug.org/texlive ] 速度较慢,加速下载需科学上网
- [清华大学开源软件镜像站](推荐) 进入后单击
texlive.iso
即可开始下载
- TeX Live 安装步骤
-
1.右键
texlive.iso
,点击装载
,或打开方式
>Windows 资源管理器
2. 运行install-tl-windows.bat
3. 安装完占用空间较大(>8GB)建议修改安装路径至其他盘
4. 点击安装
,安装大约需要 1 个小时。安装完成后点击关闭
即可(未安装完无法点击)
5. 在终端(教程:12种打开终端的方式 )中输入latex -v
(查询版本)验证是否安装成功Microsoft Windows [版本 10.0.26100.2894] (c) Microsoft Corporation。保留所有权利。 C:\\Users\\Logic>latex -v pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024) kpathsea version 6.4.0 Copyright 2024 Han The Thanh (pdfTeX) et al. There is NO warranty. Redistribution of this software is covered by the terms of both the pdfTeX copyright and the Lesser GNU General Public License. For more information about these matters, see the file named COPYING and the pdfTeX source. Primary author of pdfTeX: Han The Thanh (pdfTeX) et al. Compiled with libpng 1.6.43; using libpng 1.6.43 Compiled with zlib 1.3.1; using zlib 1.3.1 Compiled with xpdf version 4.04 C:\\Users\\Logic>
TeX Live + VSCode
安装 VSCode
- VSCode 下载地址:[点击进入 VSCode 官网],单击
Download for Windows
即可开始下载 - VSCode 安装步骤:运行安装程序后,安装位置任意,其余设置默认即可,除了以下设置需注意:
配置 VSCode
安装中文插件
- 点击左侧
Extensions
进入扩展页面以安装插件
- 在界面左上方搜索
Chinese
,选择Chinese (Simplified) (简体中文)
插件安装
- 安装完后点击
Change Language and Restart
重启 VSCode 以适配更改
安装 LaTeX 插件
- 点击左侧
扩展
进入扩展页面以安装插件
- 在界面左上方搜索
LaTeX
,选择LaTeX Workshop
插件安装 - 若弹出此窗口则选择
信任发布者和安装
配置 LaTeX 插件
- 在顶部搜索栏键入
>json
,或按键盘上的 Ctrl + Shift + P 后输入json
;
选择首选项:打开用户设置(JSON)
- 把配置代码粘贴进去后保存即可 [点击跳转至配置代码]
编译 LaTeX 文档
- 打开任意 tex 文件,没有现成文件的可前往:[点击跳转至 LaTeX 测试代码]
- 在识别到
.tex
后缀的文件后,VSCode 左侧会显示 TEX 扩展的图标
测试双向定位功能
正向定位:在代码框固定光标,然后按 Ctrl + Alt + J
反向定位:在 PDF 预览框按 Ctrl + 鼠标左键
TeX Live + TeXstudio
Download now
即可开始下载测试双向定位功能
请确保已完成 TeX Live 的安装!
- 打开 TeXstudio(桌面上没有快捷方式的话可前往开始菜单打开)将测试代码粘贴进 TeXstudio 中
[点击跳转至 LaTeX 测试代码] - 点击上方工具栏中的“构建并查看”,或按键盘上的 F5
- 稍等片刻,右侧会多出一栏编译好的 PDF
- 在左右任意侧按 Ctrl + 鼠标左键,即可实现双向定位
[附] VSCode 配置代码
{
// LaTeX 配置,详见:https://zhuanlan.zhihu.com/p/166523064
"latex-workshop.latex.autoBuild.run": "never", // 设置何时使用默认的(第一个)编译链自动构建 LaTeX:1. onFileChange:检测到代码被更改时自动编译;2. onSave:当代码被保存时自动编译;3. never:从不自动编译,需编写者手动编译
"latex-workshop.intellisense.package.enabled": true, // 设置为 true,则该拓展能够从使用的宏包中自动提取命令和环境,从而补全正在编写的代码
"latex-workshop.message.error.show": false, // 设置当文档编译错误时是否弹出显示出错和警告的弹窗
"latex-workshop.message.warning.show": false, // 设置当文档编译错误时是否弹出显示出错和警告的弹窗
"latex-workshop.latex.tools": [ // %DOCFILE% 表明编译器访问没有扩展名的根文件名,%DOC% 表明编译器访问的是没有扩展名的根文件完整路径。推荐后者,除非文件路径有中文
{
"name": "xelatex",
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
},
{
"name": "pdflatex",
"command": "pdflatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
},
{
"name": "latexmk",
"command": "latexmk",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"-outdir=%OUTDIR%",
"%DOC%"
]
},
{
"name": "bibtex",
"command": "bibtex",
"args": [
"%DOC%"
]
}
],
"latex-workshop.latex.recipes": [ // name 是标签,即出现在工具栏中的链名称;tool 是 name 标签所对应的编译顺序
{
"name": "XeLaTeX",
"tools": [
"xelatex"
]
},
{
"name": "PDFLaTeX",
"tools": [
"pdflatex"
]
},
{
"name": "BibTeX",
"tools": [
"bibtex"
]
},
{
"name": "LaTeXmk",
"tools": [
"latexmk"
]
},
{
"name": "xelatex -> bibtex -> xelatex*2",
"tools": [
"xelatex",
"bibtex",
"xelatex",
"xelatex"
]
},
{
"name": "pdflatex -> bibtex -> pdflatex*2",
"tools": [
"pdflatex",
"bibtex",
"pdflatex",
"pdflatex"
]
},
],
"latex-workshop.latex.clean.fileTypes": [ // 设置编译完成后要清除掉的辅助文件类型
"*.aux",
"*.bbl",
"*.blg",
"*.idx",
"*.ind",
"*.lof",
"*.lot",
"*.out",
"*.toc",
"*.acn",
"*.acr",
"*.alg",
"*.glg",
"*.glo",
"*.gls",
"*.ist",
"*.fls",
"*.log",
"*.fdb_latexmk"
],
"latex-workshop.latex.autoClean.run": "onFailed", // 设置何时对上文设置的辅助文件进行清除:1. onBuilt : 无论是否编译成功都清除;2. onFailed : 编译失败时清除;3. never : 无论何时都不清除
"latex-workshop.latex.recipe.default": "lastUsed", // 设置 VSCode 编译 tex 文档时的默认编译链:1. first:使用 latex-workshop.latex.recipes 中的第一条编译链,故而可根据自己的需要更改编译链顺序; 2. lastUsed:使用最近一次编译所用的编译链
"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click" // 设置反向同步的快捷键绑定:1. ctrl-click:默认选项,使用 Ctrl/cmd+鼠标左键单击;2. double-click:使用鼠标左键双击
}
[附] LaTeX 测试代码
使用说明:
- 将代码保存为
test.tex
- 通过 VSCode、TeXstudio 等软件编译,或使用以下命令之一编译:
pdflatex test.tex
xelatex test.tex
- 如果测试参考文献功能,需要运行:
bibtex test
(如果使用 BibTeX)
注意事项:
- 图片路径需要替换为实际存在的图片路径,本段代码默认注释掉图片部分
- 如果不需要参考文献测试,可以删除参考文献部分
- 编译后应生成包含以下内容的 PDF 文档:
- 带格式的标题
- 项目符号列表
- 数学公式
- 简单表格
- 居中显示的图片(如果有图片)
如果这个文件能成功编译为 PDF,说明你的 LaTeX 环境基本配置正确
\documentclass[UTF8]{ctexart}
\usepackage{amsmath} % 数学公式支持
\usepackage{graphicx} % 插入图片支持
\usepackage{hyperref} % 超链接支持
\title{LaTeX 环境测试文档}
\author{Your Name}
\date{\today}
\begin{document} % 开始文档内容
\maketitle % 生成标题页
\clearpage % 另起一页
\section{基础语法测试}
这是一个段落,包含\textbf{粗体}、\textit{斜体}和\underline{下划线}文本。
\begin{itemize}
\item 项目列表第一项
\item 项目列表第二项
\end{itemize}
\section{数学公式测试}
行内公式示例:勾股定理 $a^2 + b^2 = c^2$
独立公式示例:
\[
e^{i\pi} + 1 = 0
\]
矩阵公式测试:
\[
\begin{pmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{pmatrix}
\]
% \section{图片插入测试} % 此处没有图片文件因此整段注释掉
% \begin{figure}[h]
% \centering
% \includegraphics[width=0.5\textwidth]{example-image-a} % 需要替换为实际图片路径
% \caption{示例图片}
% \label{fig:example}
% \end{figure}
\section{简单表格测试}
\begin{tabular}{|c|c|c|}
\hline
项目 & 数量 & 价格 \\
\hline
苹果 & 10 & \$5 \\
香蕉 & 5 & \$3 \\
\hline
\end{tabular}
\section*{参考文献}
这是一个引用示例 \cite{citekey},实际使用时需要配置 .bib 文件
\begin{thebibliography}{9}
\bibitem{citekey}
示例参考文献条目
\end{thebibliography}
\end{document} % 结束文档内容