Python subprocess获取pdflatex路径失败问题分析及解决

问题现象 #

• 用Python自动生成.tex文档后，直接调用subprocess.run('pdflatex')无响应，必须指定完整路径才能正常执行
• 尝试用subprocess.run(['which', 'pdflatex'])获取路径失败，但系统终端执行which pdflatex能得到有效路径/usr/local/texlive/2023/bin/x86_64-linux/pdflatex
• 对比测试：用which git可通过subprocess正常获取到/usr/bin/git路径

原因分析 #

PyCharm运行Python脚本时使用独立的PATH环境变量，未包含/usr/local/texlive/2023/bin/x86_64-linux/这类/usr/local下的TeX相关路径，导致subprocess无法定位到pdflatex可执行文件。

解决方法 #

方法1：在脚本中手动添加路径 #

通过代码修改环境变量，将TeX Live的bin目录加入PATH：

import subprocess
import os

# 复制当前环境变量
env = os.environ.copy()
# 替换为实际的pdflatex所在路径
tex_bin_path = "/usr/local/texlive/2023/bin/x86_64-linux"
# 将TeX路径追加到PATH头部
env["PATH"] = f"{tex_bin_path}:{env['PATH']}"

# 调用pdflatex编译目标文档
compile_result = subprocess.run(
    ["pdflatex", "your_target_doc.tex"],
    env=env,
    capture_output=True,
    text=True
)

# 输出编译日志和错误信息
print("编译日志：")
print(compile_result.stdout)
print("\n错误信息：")
print(compile_result.stderr)

方法2：配置PyCharm运行环境变量 #

1. 打开PyCharm的Run/Debug Configurations
2. 找到对应脚本的配置项，点击Environment variables后的编辑按钮
3. 在PATH变量的末尾追加:/usr/local/texlive/2023/bin/x86_64-linux（根据实际路径调整）
4. 保存配置后重新运行脚本即可

内容的提问来源于stack exchange，提问作者user18184114