LaTeX TeX Live 安裝與 CTAN 國內鏡像配置（Windows / macOS / Linux 全流程）

這是一份面向國內環境的 LaTeX 從零到可編譯 指南：覆蓋 TeX Live / MacTeX 安裝、PATH 配置、CTAN 國內鏡像（清華/北外/上交/中科大等）一鍵切換與回滾、常見坑位（權限、鏡像路徑、版本切換）、以及 XeLaTeX/latexmk 的實用建議。

關鍵點先說：TeX Live 的軟件與宏包由 CTAN 鏡像分發；安裝器與包管理器 tlmgr 都可以指定或切換鏡像。默認用 mirror.ctan.org 做“就近自動選擇”，國內建議改成固定的近源鏡像以提速與提高成功率。(TeX 用戶組, CTAN)

0. 你需要準備什么

  • Windows、macOS 或 Linux 任一平臺的普通用戶權限（部分命令在系統級安裝時需要管理員/sudo）。

  • 穩定的網絡（國內建議固定 CTAN 國內鏡像，加速明顯）。

  • 一個編輯器（VS Code + LaTeX Workshop / TeXstudio / TeXworks 均可）。

1. 獲取并安裝發行版

1.1 Windows：TeX Live（官方安裝器）

1）下載網絡安裝器 install-tl-windows.exe（TeX Live 官方）。
雙擊運行即可進入 GUI 安裝；也可在命令行/無界面模式下帶參數（如指定倉庫）。(TeX 用戶組, 數學FTP網站)

2）（可選）在安裝階段就指定國內鏡像
如果你想全程走國內鏡像，先打開命令行到下載目錄，執行（示例：清華 TUNA）：

install-tl-windows.exe -repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

（GUI 模式里也能手動“選擇鏡像”。命令行參數 -repository/--repository 為官方支持。）(數學FTP網站, tug.ctan.org)

3）安裝完成后，確認 PATH
TeX Live 的 Windows 可執行一般在 C:\texlive\2025\bin\windows，安裝器通常會代你寫入 PATH；若 xelatex -v 報找不到，就把該路徑補進系統 PATH。（見“故障排查”）

4）驗證：

tex -v
tlmgr -v
xelatex -version

1.2 macOS：優先用 MacTeX（TeX Live 的 macOS 發行包）

1）下載并安裝 MacTeX（或更小的 BasicTeX）。安裝器會為你創建并使用 /Library/TeX/texbin 這個符號鏈接，指向當年的 TeX Live 二進制目錄；絕大多數 GUI/終端默認按這個路徑找編譯器。(TeX 用戶組)

2）確認 PATH
新開終端執行：

which xelatex   # 一般應返回 /Library/TeX/texbin/xelatex
latex -v

若沒生效，可在 ~/.zshrc 追加：

export PATH="/Library/TeX/texbin:$PATH"

（MacTeX 官方也建議把 /Library/TeX/texbin 放到 PATH 的最前，以避免與 Homebrew/MacPorts 下的同名工具沖突。）(TeX 用戶組)

1.3 Linux：用官方 install-tl 安裝腳本

1）下載并解壓 TeX Live 網絡安裝器（或直接 wget 官方 install-tl 入口）。
2）命令行安裝，直接指定國內鏡像（示例：北外 BFSU）：

sudo perl install-tl --repository https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/tlnet

（如果只給出鏡像站的根域名而不帶 /systems/texlive/tlnet，安裝器可能報倉庫元數據找不到；務必包含該子路徑。）(TeX 用戶組, DEV Community)

3）完成后，把當年版本的二進制目錄寫入 PATH，例如：

# x86_64 Linux 示例
echo 'export PATH="/usr/local/texlive/2025/bin/x86_64-linux:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. 配置 CTAN 國內鏡像（安裝后也能一鍵切）

TeX Live 自帶包管理器 tlmgr，既能裝/更包，也能設置默認倉庫（即鏡像）。常用國內鏡像示例：

  • 清華 TUNA
    https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet（幫助頁有 tlmgr 示例）(mirrors.tuna.tsinghua.edu.cn)

  • 北京外國語大學 BFSU
    https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/tlnet（幫助頁附永久/臨時切換命令） (mirrors.bfsu.edu.cn)

  • 上海交通大學 SJTUG
    https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/tlnet（目錄可瀏覽） (mirrors.sjtug.sjtu.edu.cn)

  • 中國科學技術大學 USTC
    https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet（鏡像站文檔提供用法）

官方“自動就近”入口是 https://mirror.ctan.org/systems/texlive/tlnet（會重定向到附近鏡像）。如遇同步延遲或跳到國外慢站，手動改為固定鏡像即可。 (TeX 用戶組)

2.1 永久切換默認倉庫（推薦）

# Linux / macOS（按需加 sudo）
tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet# Windows（PowerShell 或 cmd 里同樣可用）
tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

（tlmgr option repository <URL> 為官方支持的標準做法。）(TeX 用戶組, tug.ctan.org)

2.2 僅本次操作臨時用鏡像

tlmgr update --self --all \--repository https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/tlnet

（臨時參數只對本次命令生效，適合“某鏡像沒同步某個包”時應急。）(mirrors.bfsu.edu.cn)

2.3 GUI 切換（可選）

tlmgr gui

在 TeX Live Manager 界面里：Options → Repository 選擇鏡像即可。（Windows 下也可用 tlshell/GUI 管理器改源。）(Medium)

3. 初次更新與基礎包

1）先自更新 tlmgr，再全更包：

tlmgr update --self
tlmgr update --all

（tlmgr 是 TeX Live 的包管理器，官方文檔建議先 --self 再 --all。）(TeX 用戶組)

2）中文排版建議裝好 ctex 宏包；最小安裝或 BasicTeX 可能沒帶全：

tlmgr install ctex

3）推薦 latexmk：自動按需調用（pdfLaTeX/XeLaTeX/Biber）：

tlmgr install latexmk
latexmk -pdf main.tex           # 走 pdfLaTeX
latexmk -xelatex main.tex       # 強制走 XeLaTeX（中文更穩）

4. “Hello, LaTeX（中文）” 自檢

main.tex：

\documentclass{ctexart}  % 中文友好：自動啟用 xeCJK，建議配合 XeLaTeX
\begin{document}
你好，\LaTeX！這是一次成功的國內鏡像安裝與編譯自檢。
\end{document}

編譯（推薦 XeLaTeX）：

xelatex main.tex
# 或 latexmk -xelatex main.tex

5. 版本與安裝選型：full / scheme / 最小

  • scheme-full（全量）：最省心，磁盤占用最大。

  • scheme-small / basic：體積小、首次裝包快，但用到沒裝的宏包需要再 tlmgr install。

  • 大版本 按年維護（如 TeX Live 2025）。跨年重裝更干凈；同年內滾動更新靠 tlmgr。官方指南對 scheme、集合與包的關系有完整說明。(TeX 用戶組)

6. Android/編輯器補充（可選）

  • 編輯器：VS Code + LaTeX Workshop、TeXstudio、TeXworks 均可。一旦 PATH 正確，編輯器只負責調用 latexmk/xelatex。

  • minted 高亮：需要 Python pygments，并在編譯命令加 -shell-escape。

  • BibLaTeX + Biber：建議采用現代工具鏈，中文文獻支持更好。

7. 常見問題與避坑

Q1：install-tl 報“找不到 texlive.tlpdb / repository 無效”？
A：你可能把鏡像根地址當倉庫了——必須帶上 /systems/texlive/tlnet 子路徑，例如：
https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet。 (DEV Community)

Q2：tlmgr 切源命令到底是什么？臨時與永久怎么區分？
A：永久：tlmgr option repository <URL>；臨時：任何 tlmgr ... --repository <URL> 的本次調用。（官方用法）(TeX 用戶組, tug.ctan.org)

Q3（macOS）：xelatex 找不到 / VS Code 報錯？
A：把 /Library/TeX/texbin 放在 PATH 前列，重開終端/IDE；MacTeX 安裝器默認創建這個鏈接并擴展 PATH（必要時手動追加）。(TeX 用戶組)

Q4（Windows）：tlmgr 提示需要管理員權限？
A：如果安裝時選了“為所有用戶”，部分操作需在“以管理員身份運行”的終端執行。或為當前用戶單獨安裝 TeX Live（更易管控）。

Q5：版本切換/跨年升級
A：TeX Live 按年切版；跨年通常重裝一個新版本最干凈（Mac 用 MacTeX-當年版）。老版本可共存，新版會通過 /Library/TeX/texbin 指向最新（macOS）。(TeX 用戶組)

Q6：鏡像到底選誰？
A：就近、穩定、HTTPS——清華 TUNA / 北外 BFSU / 上交 SJTUG / USTC 都是常見選擇；遇到“鏡像未同步某新包”時，先臨時切回 mirror.ctan.org 或換另一個國內鏡像重試。(mirrors.tuna.tsinghua.edu.cn, mirrors.bfsu.edu.cn, mirrors.sjtug.sjtu.edu.cn)

8. 速查清單（復制即用）

安裝階段直接指定鏡像

# Windows（命令行）
install-tl-windows.exe -repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet# Linux/macOS
sudo perl install-tl --repository https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/tlnet

（不指定時默認走 mirror.ctan.org 自動分配。）(TeX 用戶組)

安裝后永久切源

tlmgr option repository https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/tlnet

（或換成你偏好的國內鏡像。）(mirrors.sjtug.sjtu.edu.cn)

僅本次臨時切源并更新

tlmgr update --self --all \--repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

(mirrors.tuna.tsinghua.edu.cn)

macOS PATH（若需手動）

echo 'export PATH="/Library/TeX/texbin:$PATH"' >> ~/.zshrc && source ~/.zshrc

(TeX 用戶組)

自檢

tex -v
tlmgr -v
latexmk -v
xelatex -version

9. 結語

TeX Live 的安裝“看上去很復雜”，但抓住三件事就會非常順滑：
1）選發行版（Windows 用 TeX Live，macOS 用 MacTeX）；
2）設鏡像（安裝時指定或安裝后 tlmgr option repository）；
3）會用 latexmk/XeLaTeX（中文/參考文獻一步到位）。

按這套流程，你基本可以在國內網絡下穩定、快速地裝好 LaTeX，并把后續“裝包慢/網抖/倉庫不通”的煩惱降到最低。祝排版順利，早日 \clearpage！

參考（精選）

  • TeX Live 官方安裝/鏡像與 install-tl 文檔：mirror.ctan.org 自動選擇、--repository 說明與示例。(TeX 用戶組)

  • tlmgr 官方：命令、option repository、使用示例與基礎指南（PDF）。(TeX 用戶組, tug.ctan.org)

  • CTAN 國內鏡像使用幫助與示例命令：清華 TUNA、BFSU、SJTUG。(mirrors.tuna.tsinghua.edu.cn, mirrors.bfsu.edu.cn, mirrors.sjtug.sjtu.edu.cn)

  • MacTeX：/Library/TeX/texbin 路徑與 PATH 擴展行為（FAQ、ReadMe）。(TeX 用戶組)

  • CTAN 鏡像站列表（如需自行挑選/切換）：(CTAN)

本文來自互聯網用戶投稿，該文觀點僅代表作者本人，不代表本站立場。本站僅提供信息存儲空間服務，不擁有所有權，不承擔相關法律責任。
如若轉載，請注明出處：http://www.pswp.cn/bicheng/96295.shtml
繁體地址，請注明出處：http://hk.pswp.cn/bicheng/96295.shtml
英文地址，請注明出處：http://en.pswp.cn/bicheng/96295.shtml

如若內容造成侵權/違法違規/事實不符，請聯系多彩編程網進行投訴反饋email:809451989@qq.com，一經查實，立即刪除！

相關文章

WhoisXML API再次榮登2025年美國Inc. 5000快速成長企業榜單

WhoisXML API再次榮登2025年美國Inc. 5000快速成長企業榜單

WhoisXML API非常自豪地宣布&#xff0c;我們再次榮登美國權威榜單——2025年Inc.5000全美成長最快的私營企業之一。今年&#xff0c;公司在地區排名中位列第119名&#xff0c;在全美總體排名中位列第4,271名。Inc. 5000榜單要求參評企業必須保持獨立運營&#xff0c;并在2021至…
閱讀更多...
Elasticsearch面試精講 Day 9：復合查詢與過濾器優化

Elasticsearch面試精講 Day 9：復合查詢與過濾器優化

【Elasticsearch面試精講 Day 9】復合查詢與過濾器優化 在Elasticsearch的搜索體系中&#xff0c;復合查詢&#xff08;Compound Queries&#xff09;與過濾器&#xff08;Filters&#xff09;優化是構建高效、精準搜索邏輯的核心能力。作為“Elasticsearch面試精講”系列的第…
閱讀更多...
Android使用ReactiveNetwork監聽網絡連通性

Android使用ReactiveNetwork監聽網絡連通性

引入庫 implementation com.github.pwittchen:reactivenetwork-rx2:3.0.8監聽網絡連接變更ReactiveNetwork.observeNetworkConnectivity(context).subscribeOn(Schedulers.io())// ... // anything else what you can do with RxJava.observeOn(Schedulers.computation()).subs…
閱讀更多...
基于阿里云部署 RustDesk 自托管服務器

基于阿里云部署 RustDesk 自托管服務器

基于阿里云部署 RustDesk 自托管服務器一、背景與需求場景二、什么是 RustDesk&#xff1f;為什么選擇自托管&#xff1f;2.1 RustDesk 是什么&#xff1f;2.2 為什么選擇自托管&#xff1f;三、環境準備與架構說明四、操作步驟4.1 在阿里云上安裝 RustDesk 服務端4.1.1 下載并…
閱讀更多...
細說分布式ID

細說分布式ID

針對高并發寫&#xff0c;分布式ID是其業務基礎&#xff0c;本文從一個面試題細細展開。面試官&#xff1a;1.對于Mysql的InnoDB引擎下&#xff0c;自增ID和UUID作為主鍵各自有什么優劣&#xff0c;對于一張表的主鍵你建議使用哪種ID&#xff1f;2.除了UUID是否還了解其他類型的…
閱讀更多...
2025年大數據專業證書報考指南：專科學歷必看的8大選擇?

2025年大數據專業證書報考指南：專科學歷必看的8大選擇?

對于大專學歷的同學來說&#xff0c;2025年進入大數據行業是一個充滿機遇的選擇。大數據領域發展迅速&#xff0c;各類證書能夠幫助求職者提升專業能力、增強就業競爭力。其中最推薦的是CDA數據分析師&#xff0c;這個證書適應了未來數字化經濟和AI發展趨勢&#xff0c;難度不高…
閱讀更多...
Python爬蟲實戰：研究Axis Artist模塊，構建電商數據采集和分析系統

Python爬蟲實戰：研究Axis Artist模塊，構建電商數據采集和分析系統

1. 引言 1.1 研究背景與意義 在大數據時代，互聯網上蘊藏著海量有價值的信息，這些信息涵蓋了社會、經濟、科技等各個領域。高效地從互聯網獲取數據并進行深度分析，對于企業決策、學術研究、市場分析等都具有重要意義。Python 作為一種功能強大的編程語言，憑借其豐富的庫支…
閱讀更多...
突破大語言模型推理瓶頸：深度解析依賴關系與優化策略

突破大語言模型推理瓶頸：深度解析依賴關系與優化策略

突破大語言模型推理瓶頸&#xff1a;深度解析依賴關系與優化策略當ChatGPT需要5秒才能生成一個回答&#xff0c;當企業級大模型每秒只能處理3個用戶請求——這些性能瓶頸的背后&#xff0c;隱藏著大語言模型推理計算中復雜的依賴關系網。在大語言模型推理過程中&#xff0c;依賴…
閱讀更多...
整理了幾道前端面試題

整理了幾道前端面試題

1. 若是有兩個數組ar1和ar2&#xff0c;求它們的并集和交集&#xff0c;要怎么做&#xff1f; const ar1 [1, 2, 3, 4]; const ar2 [3, 4, 5, 6];一、求并集 (Union) 目標&#xff1a; 把兩個數組合并成一個新數組&#xff0c;新數組包含所有出現過的元素&#xff0c;但每個…
閱讀更多...
Mac M4環境下基于VMware Fusion虛擬機安裝Ubuntu24.04 LTS ARM版

Mac M4環境下基于VMware Fusion虛擬機安裝Ubuntu24.04 LTS ARM版

Mac M4環境下基于VMware Fusion虛擬機安裝Ubuntu24.04 LTS ARM版 1 下載Ubuntu鏡像 在Ubuntu官網下載Ubuntu24.04 LTS的arm版鏡像&#xff0c;這里選擇ubuntu-24.04-live-server-arm64.iso&#xff0c;支持arm的似乎沒有合適的desktop版本&#xff0c;Server版本默認是不帶圖…
閱讀更多...
開源與定制化對比：哪種在線教育系統源碼更適合教育培訓APP開發？

開源與定制化對比：哪種在線教育系統源碼更適合教育培訓APP開發？

如今&#xff0c;“在線教育系統源碼”已經成為許多教育培訓機構、創業者甚至傳統學校的高頻關鍵詞。無論是打造一款在線教育APP&#xff0c;還是開發企業內部培訓平臺&#xff0c;源碼選擇都決定了后續的開發效率、產品體驗與商業化潛力。 在實際開發中&#xff0c;常見的源碼…
閱讀更多...
中間件的日志分析

中間件的日志分析

將日志文件access.log復制到kali中進行分析使用命令查看文件中各IP的訪問次數&#xff0c;依次分析其行為awk { print $1 } access.log | sort | uniq -c |sort -nr172.16.3.189cat access.log | grep 172.16.3.198行為模式分析使用固定弱密碼進行身份驗證 幾乎所有請求都使用用…
閱讀更多...
【Big Data】云原生與AI時代的存儲基石 Apache Ozone 的技術演進路徑

【Big Data】云原生與AI時代的存儲基石 Apache Ozone 的技術演進路徑

目錄 一、Apache Ozone是什么&#xff1f; 二、Ozone的誕生背景 三、Ozone的架構設計 1. 分層架構設計 2. Ozone Manager (OM) 3. Storage Container Manager (SCM) 4. DataNode 5. Raft協議應用 四、Ozone解決的關鍵問題 1. 元數據管理瓶頸 2. 小文件性能問題 3. …
閱讀更多...
抖音直播禮物彈幕抓取工具：技術實現與功能解析

抖音直播禮物彈幕抓取工具：技術實現與功能解析

基于Python的直播間數據采集技術實踐一、項目概述基于Python開發的直播間數據采集方案&#xff0c;采用最新簽名算法(dysign)實現穩定連接&#xff0c;實時獲取直播間各類互動數據&#xff0c;為直播數據分析和互動應用開發提供技術支持。二、核心功能實時消息監控用戶進入提醒…
閱讀更多...
添加地址頁面，可以添加復制粘貼，自動識別地址的功能uniapp實現方式

添加地址頁面，可以添加復制粘貼，自動識別地址的功能uniapp實現方式

主要用uni.getClipboardData(OBJECT)&#xff0c;更多信息可以到uniapp官網查看以下實現方式 1利用api, 2針對判斷優化方案&#xff0c;在線APIhandleConfirm2(){let that this;promisRequest({url: https://wangzc.wang/smAddress,data: {"address": that.…
閱讀更多...
ESP32 驅動 PWM 舵機為什么必須共地？——從原理到實踐全解析

ESP32 驅動 PWM 舵機為什么必須共地？——從原理到實踐全解析

在使用 ESP32 控制 PWM 舵機 的過程中，新手經常遇到一個常見問題：舵機不動、亂動、甚至燒壞芯片。 其中最典型的原因，就是沒有正確共地。 很多初學者會疑惑：“外接電池只是給舵機供電，為什么還要把電池的地線接到 ESP32 的 GND 上呢？” 本文將從 信號邏輯、閉合回路、…
閱讀更多...
細菌基因組genome二代測序數據分析

細菌基因組genome二代測序數據分析

kraken2去除污染conda create -n kraken2 conda activate kraken2 conda install kraken2 -c bioconda mkdir kraken2_outputkraken2 --db ../../kraken2_db/k2_pluspf_20250402/ --threads 8 --paired 250811_HS67EV0804_R1.fastq.gz 250811_HS67EV0804_R2.fastq.gz --use-nam…
閱讀更多...
工業網絡架構的未來：智慧化工廠中的低延遲與高可靠性設計

工業網絡架構的未來：智慧化工廠中的低延遲與高可靠性設計

1. 引言工業網絡正經歷從傳統有線到無線、從低速到高速的全面升級。某鋁箔智慧工廠專注于新能源鋁箔的生產&#xff0c;依賴低延遲、高可靠的網絡支持實現生產控制與智能管理。本文將探討某鋁箔智慧工廠網絡架構設計的關鍵點及其實施策略。2. 某鋁箔智慧工廠的網絡挑戰多終端接…
閱讀更多...
Android14 init.rc中on boot階段操作4

Android14 init.rc中on boot階段操作4

Android14 init.rc中on early-init, init, late-init, early-fs, post-fs階段詳解1 Android14 init.rc的on late-fs, post-fs-data階段主要操作詳解2 Android14 init.rc中啟動Zygote詳解3 Android14 init.rc中on boot階段操作4 1 on boot和低內存設備的啟動優化 僅在ro.con…
閱讀更多...
CodeSandbox Desktop：零配置項目啟動工具，實現項目環境隔離與Github無縫同步

CodeSandbox Desktop：零配置項目啟動工具，實現項目環境隔離與Github無縫同步

你有沒有過為了跑一個簡單的 Demo&#xff0c;花半小時配置環境還失敗的經歷&#xff1f;比如想測試一個 Vue3 組件&#xff0c;先裝 Node.js&#xff0c;結果版本太高和項目依賴不兼容&#xff1b;換低版本又提示 “找不到 python 環境”&#xff1b;好不容易裝完依賴&#xf…
閱讀更多...
最新文章

Copyright @ 2022~2023