无sudo权限Ubuntu服务器安装TeX Live全攻略-代码聚汇网

无sudo权限Ubuntu服务器安装TeX Live全攻略

孙玲的空间·2026-07-10·阅读 34 GEO检测（免费）

LaTeXTeX LiveUbuntu服务器

|难度：普通|阅读约 11 分钟

1. 项目背景与核心挑战

作为科研工作者或学术写作者，LaTeX环境几乎是刚需。但当你面对一台没有sudo权限的Ubuntu服务器时，传统的一键安装方式完全失效。上周我接手实验室一台公用服务器时就遇到这个典型场景——需要为团队配置完整的LaTeX环境（TeX Live 2023），同时要适配VS Code的LaTeX Workshop插件，还要考虑后续维护时的卸载问题。

这个需求背后涉及三个技术痛点：

权限限制：无法使用apt或sudo安装系统级软件包
路径隔离：用户级安装需要手动配置环境变量
远程操作：全程通过SSH连接完成，无法依赖图形界面

经过两天实测，最终摸索出一套稳定可靠的解决方案。以下是完整操作记录，包含路径选择策略、环境变量配置技巧，以及你可能遇到的坑点。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 前置准备与环境检查

2.1 远程连接配置

推荐使用VS Code的Remote - SSH插件连接服务器，比纯终端操作更方便文件管理：

bash复制# 本地VS Code安装插件后，按F1输入：
Remote-SSH: Connect to Host...

2.2 空间检查

TeX Live完整安装需要约5GB空间，先确认用户目录剩余容量：

bash复制df -h ~  # 查看可用空间
du -sh ~/texlive  # 检查是否已有旧版本

2.3 依赖项验证

即使没有sudo权限，部分基础依赖可能已预装：

bash复制which perl  # 需要5.24以上版本
python3 --version  # LaTeX Workshop依赖
wget --version  # 下载安装包用

重要提示：如果缺少perl等核心组件，可尝试从conda或源码编译安装用户级版本，这需要额外步骤。

3. TeX Live用户级安装全流程

3.1 获取安装包

选择清华镜像站下载（速度更快）：

bash复制mkdir -p ~/texlive && cd ~/texlive
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-2023*

3.2 定制安装配置

关键是要修改profile文件避免系统路径：

bash复制cp texlive.profile texlive.profile.bak
nano texlive.profile

修改以下参数：

ini复制TEXDIR ~/texlive/2023
TEXMFLOCAL ~/texlive/texmf-local
TEXMFSYSVAR ~/texlive/2023/texmf-var
TEXMFSYSCONFIG ~/texlive/2023/texmf-config
TEXMFVAR ~/.texlive2023/texmf-var
TEXMFCONFIG ~/.texlive2023/texmf-config
TEXMFHOME ~/texmf
option_doc 0  # 不安装文档节省空间
option_src 0  # 不安装源码

3.3 执行安装

运行安装脚本并指定配置文件：

bash复制perl install-tl --profile=texlive.profile

安装过程约30-60分钟（视网络情况），完成后出现：

code复制Welcome to TeX Live 2023!
...
Add /home/yourname/texlive/2023/bin/x86_64-linux to your PATH...

3.4 环境变量配置

编辑~/.bashrc（或对应shell配置文件）：

bash复制export PATH="$HOME/texlive/2023/bin/x86_64-linux:$PATH"
export MANPATH="$HOME/texlive/2023/texmf-dist/doc/man:$MANPATH"
export INFOPATH="$HOME/texlive/2023/texmf-dist/doc/info:$INFOPATH"

立即生效：

bash复制source ~/.bashrc

4. VS Code集成方案

4.1 LaTeX Workshop配置

在VS Code的settings.json中添加：

json复制{
  "latex-workshop.latex.tools": [
    {
      "name": "latexmk",
      "command": "latexmk",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "-pdf",
        "%DOC%"
      ]
    }
  ],
  "latex-workshop.latex.recipes": [
    {
      "name": "latexmk",
      "tools": ["latexmk"]
    }
  ],
  "latex-workshop.latex.outDir": "./out",
  "latex-workshop.view.pdf.viewer": "tab"
}

4.2 路径验证技巧

测试环境是否生效：

bash复制which pdflatex  # 应显示~/texlive下的路径
tex --version    # 确认版本号

如果VS Code仍报错，尝试在终端执行：

bash复制code --install-extension James-Yu.latex-workshop

5. 维护与卸载方案

5.1 更新包管理

用户级更新需要使用tlmgr：

bash复制tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet
tlmgr update --self --all

5.2 完全卸载

删除安装目录和环境变量即可：

bash复制rm -rf ~/texlive
rm -rf ~/.texlive2023
# 然后从.bashrc中移除相关环境变量

6. 常见问题排查

6.1 字体缺失问题

典型报错：LaTeX Font Warning: Font shape 'TU/lmr/m/n' undefined
解决方案：

bash复制mkdir -p ~/.fonts
cp /path/to/your/fonts/*.ttf ~/.fonts/
fc-cache -fv

6.2 权限拒绝错误

如果安装时出现Can't create 'xxx': Permission denied，检查：

目标目录是否属于当前用户
是否误用了sudo（在无权限环境下会失败）

6.3 VS Code找不到命令

在远程SSH会话中，可能需要显式加载环境变量：

json复制{
  "terminal.integrated.env.linux": {
    "PATH": "/home/yourname/texlive/2023/bin/x86_64-linux:${env:PATH}"
  }
}

7. 性能优化建议

空间节省：安装时添加--no-persistent-downloads选项避免缓存
最小化安装：使用--scheme=basic参数只安装核心包
按需安装：后续通过tlmgr install单独添加包

实测这套方案在AWS t2.micro实例（1GB内存）上也能流畅运行，编译10页含图的PDF约需3秒。对于团队协作场景，建议将texlive目录打包共享，其他人只需设置PATH即可复用。