1. 无 sudo 权限下 Ubuntu 远程装 TeX Live 到底难在哪先说结论在无 sudo 权限的 Ubuntu 远程服务器上装 TeX Live本身并不难难的是「路径隔离」和「环境变量不打架」。我见过太多人卡在install-tl默认往/usr/local/texlive写、结果权限被拒或者装完了 VS Code 里点编译按钮一直报command not found。这篇就把这套流程从头到尾走一遍适配 VS Code LaTeX Workshop Remote-SSH含路径选择和卸载方案。核心检索词先摆出来无 sudo 权限 Ubuntu 远程服务器安装 TeX Live能做什么它让你在多人共用一个 SSH 账号、没有 root 的环境里拥有一套只属于自己的 LaTeX 编译环境支持 VS Code 里点按钮编译、本地预览 PDF。适合谁科研党、写论文的学生、需要远程协作写文档但服务器权限受限的开发者。场景还原一下服务器是 Ubuntu无可视化界面多人共用一个 SSH 账号你的个人专属文件夹是~/tp。本地用 VS Code已经装好 Remote - SSH 和 LaTeX Workshop 两个插件。需求很明确——装一套仅自己可用的 LaTeX 环境不和其他用户的文件、环境变量冲突。这里有个关键前提必须先讲清楚安装路径选个人文件夹~/tp还是主目录~。主目录~是当前 SSH 账号的全局共享目录所有共用这个账号的人都能读写。你把 TeX Live 装到~别人可能误删你的安装文件、覆盖你的环境变量、甚至编译命令冲突。个人文件夹~/tp是专属私有空间装在这里能完全隔离后续卸载迁移也方便不影响别人。补充一句无论装到tp还是主目录操作逻辑完全一致只要全程统一路径就行——安装路径、环境变量、VS Code 编译路径三者必须严格对应。本文以~/tp为例单人使用的话直接装主目录~即可后面会标注修改点。2. TaoToken 前置远程环境里先把模型能力接上装 LaTeX 环境的过程中你大概率会遇到各种报错——install-tl卡住、tlmgr找不到包、VS Code 编译路径写错。这时候如果有个能随时问的模型助手排障效率会高很多。TaoToken 就是干这个的它是一个大模型 API 聚合平台把 Claude、GPT 这类模型的调用统一成一个入口你在远程服务器上也能通过 API 直接调。为什么在「无 sudo 装 TeX Live」这个场景里要提它因为整个流程里最耗时的不是敲命令而是排错。比如install-tl交互界面里TEXDIR改错了、x86_64-linux架构目录名对不上、LaTeX Workshop 的settings.json里command字段路径写错这些坑一个个搜太慢。接上模型对话能力后你可以把终端报错直接贴进去问省掉大量翻文档的时间。TaoToken 的接入方式很简单官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。如果你只是偶尔问问题用模型对话就行如果长期在远程服务器上写代码、跑 Agent可以考虑 Coding Plan额度更划算。具体到配置你需要在服务器上拿到 API Key然后把它写进你用的工具里。比如用 Claude Code 的话配置里要填三件套Base URL、Key、Model ID。Base URL 填https://taotoken.net/apiKey 从控制台的 API Keys 页面生成Model ID 按你选的模型填。这三样缺一不可少一个就会报 401 或者local proxy failed。这里插一句踩过的坑很多人以为把 Key 填进去就完事了结果请求一直失败。排查下来发现是 Base URL 写成了带 UTM 的官网地址而不是纯 API 地址。记住API 调用只认https://taotoken.net/api不要带任何查询参数。另外如果你在 VS Code 里用 Cline 或者 CC Switch 这类插件配置逻辑是一样的都是 Base URL Key Model ID 三件套只是填的位置不同。拿到 Key 之后你可以先在终端里用 curl 测一下通不通curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: TeX Live 安装到用户目录后 pdflatex 找不到怎么办}] }返回里有choices字段就说明通了。这一步验证完后面装 TeX Live 遇到问题就能随时问。3. 可复制配置从 install-tl 到 settings.json 全流程这一节是核心全程在远程 Ubuntu 服务器终端执行通过 VS Code 的 Remote - SSH 连上后打开终端即可。核心思路创建目录 → 下载安装包 → 私有目录配置安装 → 环境变量配置 → VS Code 编译路径适配 → 测试验证。3.1 创建专属目录并下载安装包先进入个人tp文件夹创建临时安装目录确保所有操作都在私有空间内cd ~ mkdir -p tp cd tp mkdir -p texlive_install cd texlive_install wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/install-tl-unx.tar.gz tar -xzf install-tl-unx.tar.gz cd install-tl-*国内服务器优先用清华源下载快。国外服务器可以换官方源https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz但速度慢。3.2 交互式配置并安装执行./install-tl进入主配置菜单。关键操作顺序输入D进入目录配置子界面输入1选中TEXDIR终端提示New value for TEXDIR [/usr/local/texlive/2025]:直接输入~/tp/texlive回车。路径确认后终端会刷新TEXDIR变成/home/ubuntu/tp/texliveTEXMFLOCAL、TEXMFSYSVAR、TEXMFSYSCONFIG会自动适配为子目录。确认无误后输入R返回主菜单输入S进入安装方案选择默认a [X] full scheme完整版约 9G按需选a/b/c/d选完输入R返回最后输入I开始安装。基础版约 10-30 分钟完整版约 1-2 小时看到TeX Live installation complete即成功。3.3 环境变量配置编辑~/.bashrczsh 用~/.zshrc在末尾追加export PATH$HOME/tp/texlive/bin/x86_64-linux:$PATH export MANPATH$HOME/tp/texlive/texmf-dist/doc/man:$MANPATH export INFOPATH$HOME/tp/texlive/texmf-dist/doc/info:$INFOPATH保存后source ~/.bashrc然后pdflatex --version验证。如果报command not found进~/tp/texlive/bin看架构目录名arm64 服务器可能是aarch64-linux替换掉x86_64-linux即可。3.4 VS Code LaTeX Workshop 配置在远程窗口按Ctrl,打开设置搜LaTeX Workshop: Latex Tools点「编辑 in settings.json」写入以下片段{ latex-workshop.latex.tools: [ { name: xelatex, command: $HOME/tp/texlive/bin/x86_64-linux/xelatex, args: [-synctex1, -interactionnonstopmode, -file-line-error, %DOC%] }, { name: pdflatex, command: $HOME/tp/texlive/bin/x86_64-linux/pdflatex, args: [-synctex1, -interactionnonstopmode, -file-line-error, %DOC%] }, { name: bibtex, command: $HOME/tp/texlive/bin/x86_64-linux/bibtex, args: [%DOCFILE%] } ], latex-workshop.latex.autoBuild.run: onSave, latex-workshop.view.pdf.external.enable: true, latex-workshop.view.pdf.external.command: { command: open, args: [%PDF%] } }注意command字段必须写完整路径不要依赖系统环境变量否则多人共用账号时容易被别人的环境覆盖。保存后立即生效。4. 验证请求编译一个中文测试文档配置完别急着写正式文档先建个test.tex验证。在~/tp下新建文件粘贴\documentclass{article} \usepackage{ctex} \title{TeX Live 安装测试个人文件夹 tp} \author{远程 Ubuntu 服务器编译测试} \date{\today} \begin{document} \maketitle 这是无 sudo 权限下远程连接 Ubuntu 服务器安装到 ~/tp 个人文件夹的 TeX Live 测试文档。 支持 VS Code 通过 LaTeX Workshop 点击按钮编译本地预览 PDF中文显示正常。 \end{document}点 VS Code 右上角的运行按钮选XeLaTeX。底部状态栏显示Build successful同时~/tp下生成test.pdf就说明整条链路通了。点左侧 LaTeX Workshop 面板的View PDF可以本地预览支持代码与 PDF 跳转。如果你在终端里想直接验证也可以跑cd ~/tp xelatex -synctex1 -interactionnonstopmode test.tex输出里有Output written on test.pdf就成功了。这一步同时验证了三件事TeX Live 装好了、环境变量生效了、VS Code 配置路径对了。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排错这块我按真实报错来对照你遇到哪个直接对号入座。command not found最常见。原因是安装路径、环境变量、VS Code 编译路径三者不一致或者架构目录名写错。执行which pdflatex看系统识别的路径和settings.json里的command对比不一致就改。如果which无输出说明环境变量没生效重新检查~/.bashrc里的路径。401 Unauthorized如果你在远程环境里接了模型 API 来辅助排障这个报错说明 Key 不对或没带上。检查Authorization: Bearer后面的 Key 是否完整Base URL 是否是https://taotoken.net/api而不是带 UTM 的官网地址。Key 要去控制台的 API Keys 页面重新生成确认。local proxy failed通常是 Base URL 写错或者网络请求被本地代理拦截。确认你填的是纯 API 地址不要带任何查询参数。如果你在 Cline 或 CC Switch 里配置检查三件套是否齐全Base URL、Key、Model ID缺一个都会出这个错。reading choices相关报错这个一般出现在解析 API 返回时说明返回体里没有choices字段。大概率是 Model ID 填错了或者请求体格式不对。对照官方文档检查model字段的值以及messages数组格式。OAuth报错如果你用 Claude Code 这类工具OAuth 流程失败通常是回调地址或 token 过期。重新走一遍授权流程或者改用 API Key 方式接入填 Base URL Key Model ID 三件套绕开 OAuth。中文编译乱码编译方式选XeLaTeX别用PDFLaTeX。文件里加\usepackage{ctex}。还乱码就tlmgr install ctex补装中文包无需 sudo。安装中途终端断开重新连上服务器进cd ~/tp/texlive_install/install-tl-*重新./install-tl按步骤重配路径继续装已下载的文件不会重复下。6. 卸载清理与长期使用建议卸载就三步全程无残留不影响其他用户。第一步删核心安装目录rm -rf ~/tp/texlive第二步删临时安装目录可选省磁盘rm -rf ~/tp/texlive_install第三步删环境变量。编辑~/.bashrc把之前加的三行export删掉或注释然后source ~/.bashrc。执行pdflatex --version提示command not found就说明卸干净了。长期使用有几个建议。多人共用账号时VS Code 配置里务必写完整路径别依赖系统环境变量。如果后续要装额外宏包用tlmgr install 包名不需要 sudo。如果服务器架构是 arm64记得把配置里的x86_64-linux换成aarch64-linux。最后说个实用技巧如果你经常在远程服务器上写 LaTeX又需要模型辅助排障或润色可以把 TaoToken 的 API 接进你的工作流。模型对话适合临时问问题Coding Plan 适合长期在远程环境里跑 Agent 和代码补全。接入文档在 https://taotoken.net/api-keys 和 https://taotoken.net/doc 配置逻辑就是 Base URL Key Model ID 三件套填对就能用。整套 TeX Live 环境加上模型辅助远程写论文的体验和本地基本没差别。