0 引言

為什么選擇LaTeX+VSCode？

LaTeX 并非普通的文字處理工具，而是一個面向科研、出版和高質量印刷的排版系統。它的核心價值在于用“代碼”代替“手工排版”，徹底解決學術場景中的復雜格式需求：

• 數學公式的終極解決方案
• 圖表與參考文獻的自動化管理
• 跨平臺文檔一致性

VSCode作為微軟推出的輕量級代碼編輯器，在科研場景中遠比傳統編輯器（如Texmaker、WinEdt）更靈活：

• 插件生態的革命性提升
• 智能化的代碼編輯體驗
• 針對學術場景的深度優化

為什么不選擇Overleaf？

Overleaf必須聯網，編譯速度較慢，報錯信息不夠清晰，項目較大需付費，并且存在數據泄露風險。

優勢：

• 🚩 編譯加速：本地多核CPU并行編譯
• 🛠? 深度定制：支持LaTeX Workshop等20+插件
• 🔐 版本控制：可用Git全流程追蹤 + 差異對比
• 📈 離線可用：無需依賴網絡環境

對于需要長期進行學術寫作的用戶，本地LaTeX環境具有顯著優勢。

1 TeXLive安裝

這里說明一下，TeX是一種基礎的排版語言，由著名計算機科學家Donald E. Knuth發明。LaTeX是基于TeX的擴展版本，由美國計算機科學家Leslie Lamport在20世紀80年代初期開發。TeXLive是一個包含TeX和LaTeX的發行版，提供了一個完整的工作環境，類似于C語言的編譯器。這一步，可以理解為LaTex編譯器的安裝。

1.1 下載安裝包

進入TeXLive官網，找到下載鏈接

選擇Easy install，點擊 install-tl-windows.exe下載安裝程序

1.2 運行安裝程序

雙擊下載到本地的安裝程序，彈出的第一個窗口一路默認，等安裝程序提取完成后，進入安裝GUI，修改安裝根目錄，取消安裝TeXworks前端，并在高級中自定義語言包（去除其他用不到的語言包，只保留中文和英文）

配置完成后，點擊安裝，會彈出安裝進程窗口。

1.3 通過鏡像安裝

安裝進程報錯，程序終止，部分報錯信息如下：

TLPDB::_install_data: downloading did not succeed (check_file_and_remove failed) for https://mirror.ctan.org/systems/texlive/tlnet/archive/texlive-scripts.doc.tar.xz
Installation failed.

初步判斷為網絡下載的問題，采用Plan B，直接去國內鏡像源下載鏡像文件，這里推薦清華源texlive鏡像下載，下載texlive.iso

下載到本地后雙擊打開iso文件，以管理員身份運行install-tl-windows.bat進入和上面一樣的安裝界面，流程一樣，配置完成后點擊安裝。安裝時間較長，我安裝的是2025版本的，安裝完成GUI界面如下圖所示，并沒有提示“歡迎進入Tex live的世界！”

經搜索得知這可能是新版本安裝程序的BUG，打開安裝路徑下的日志文件install-tl.log，拉到最底部，可以看見提示，安裝完畢！

2 VSCode安裝與配置

2.1 下載VSCode安裝包

進入VSCode官網，點擊Download for Windows，直接下載安裝包到本地

2.2 安裝VSCode

雙擊運行安裝包

更改安裝路徑

點擊安裝即可。

2.3 安裝中文語言包

修改插件默認安裝位置

因為中文語言包其實是VSCode的一個擴展插件，而VSCode插件默認安裝在C盤用戶目錄下，隨著安裝的插件數量增加，占用C盤內存較大，建議先修改默認安裝位置。

參考方法：修改vscode插件安裝路徑

修改完成后，打開VSCode，點擊左側邊欄Extensions，搜索Chinese (Simplified) Language Pack，點擊install安裝

安裝完成后，根據使用方法指示，完成語言切換。

2.4 配置LaTeX核心擴展

擴展商店搜索LaTeX Workshop，該插件支持核心編譯和預覽功能，點擊安裝。

2.5 加載TeX模版文件

菜單欄點擊文件-打開文件夾，選擇TeX模板目錄，這里使用springer提供的模版為例，下載鏈接

雙擊sn-article.tex ，點擊左側邊欄出現TEX工具，進入如下界面，這便是LaTeX的編寫界面。

2.6 編譯配置優化

快捷鍵Ctrl+Shift+P 進入命令面板，輸入Preferences: Open User Settings (JSON)，添加如下代碼

{// 設置是否自動編譯"latex-workshop.latex.autoBuild.run":"never",// 右鍵菜單"latex-workshop.showContextMenu":true,// 從使用的包中自動補全命令和環境"latex-workshop.intellisense.package.enabled": true,// 編譯出錯時設置是否彈出氣泡設置"latex-workshop.message.error.show": false,"latex-workshop.message.warning.show": false,// 編譯工具和命令"latex-workshop.latex.tools": [{"name": "xelatex","command": "xelatex","args": ["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOCFILE%"]},{"name": "pdflatex","command": "pdflatex","args": ["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOCFILE%"]},{"name": "latexmk","command": "latexmk","args": ["-synctex=1","-interaction=nonstopmode","-file-line-error","-pdf","-outdir=%OUTDIR%","%DOCFILE%"]},{"name": "bibtex","command": "bibtex","args": ["%DOCFILE%"]}],// 用于配置編譯鏈"latex-workshop.latex.recipes": [{"name": "XeLaTeX","tools": ["xelatex"]},{"name": "XeLaTeX*2","tools": ["xelatex","xelatex"]},{"name": "PDFLaTeX","tools": ["pdflatex"]},{"name": "PDFLaTeX*2","tools": ["pdflatex","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"],// 設置為onFaild 在構建失敗后清除輔助文件"latex-workshop.latex.autoClean.run": "onFailed",// 使用上次的recipe編譯組合"latex-workshop.latex.recipe.default": "lastUsed",// 用于反向同步的內部查看器的鍵綁定。ctrl/cmd +點擊(默認)或雙擊"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click","latex-workshop.view.pdf.viewer": "tab",
}

上述配置詳細解釋參見：https://zhuanlan.zhihu.com/p/166523064

2.7 環境驗證

新建demo.tex，內容如下

\documentclass{article}
\title{Environment Validation}
\author{Test User}
\date{\today}\begin{document}
\maketitle\section{Basic Features}
Basic math: $a^2 + b^2 = c^2$\section{Math Environment}\label{sec:math}
\begin{equation}\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
\end{equation}\section{Advanced Features}
Cross-reference test: See section \ref{sec:math}\end{document}

選擇XeLaTeX構建項目，生成的PDF可在VSCode中預覽，點擊查看日志可分析報錯。

至此，科研寫作環境搭建基本完成。

3 VSCode其他配置（可選）

3.1 SumatraPDF

有的時候，由于想要看到 pdf 文件的完整展現效果，使用內置查看器已無法滿足需求，這時可以使用外部查看器進行查看。 SumatraPDF作為外部查看器，該軟件的優點在于在具有 pdf 閱讀功能的同時很輕量，安裝包不到 10MB 大小，且支持雙向同步功能。通過調整其與 vscode 的窗口位置，能夠在擁有這些優勢的同時，達到與內置 pdf 查看具有相同的效果。

安裝配置教程：https://zhuanlan.zhihu.com/p/166523064

配置完成后，PDF無法反向搜索的問題參見鏈接：https://blog.csdn.net/a1010026261/article/details/131446557

3.2 Git

使用Git進行版本控制：https://blog.csdn.net/wq3095435422/article/details/125010399

3.3 Zotero插件

實現點擊插入參考文獻：https://zhuanlan.zhihu.com/p/515335936

參考

[1] https://shutiaoz.top/寫作工具/LaTeX/Latex_VSCode

[2] https://blog.csdn.net/LiLiu_YiYu/article/details/146066653