使用minted包编译LaTeX时pdflatex返回`system returned with code 1`错误

minted 依赖 Python 的 Pygments 库完成代码高亮，该报错90%以上的情况是 Pygments 未正确安装或调用链路异常，按以下优先级排查即可解决：

• 验证Pygments安装状态
  打开系统终端/命令提示符，执行命令：

  pygmentize -V
  

  如果提示「命令不存在/找不到该程序」，按以下步骤修复：
  1. 安装官方Python发行版，安装时务必勾选「Add Python to system PATH」选项
  2. 安装完成后执行命令安装Pygments：pip install pygments（Python3环境下如果pip报错可替换为pip3 install pygments）
  3. 重启终端（必要时重启电脑）让环境变量生效，再次执行pygmentize -V验证，出现版本号即为安装成功
• 验证shell-escape参数生效
  如果你使用TeXstudio、VS Code等编辑器编译，不要仅手动在命令行加参数，需要在编辑器的编译配置中给pdflatex命令固定加上-shell-escape参数，避免编辑器调用时自动忽略该参数。
• 排除缓存/路径异常
  加载minted包时临时关闭缓存，或指定全英文的缓存路径，排除缓存损坏、路径含中文/特殊字符导致的报错：

  % 关闭缓存
  \usepackage[cache=false]{minted}
  % 或指定全英文缓存路径
  % \usepackage[cachedir=C:/temp/minted_cache]{minted}
  

• 排查安全软件拦截
  Windows Defender、第三方杀毒软件可能会拦截pdflatex调用pygmentize生成临时文件的操作，可临时关闭安全软件，或将工作目录加入安全软件白名单后重试编译。
• 单独验证Pygments功能
  新建test.py文件写入测试代码，执行命令直接测试Pygments的LaTeX输出功能：

  pygmentize -f latex -l python test.py
  

  如果该命令正常输出LaTeX格式代码，则Pygments本身无问题，问题出在LaTeX调用链路，否则重新安装Pygments即可解决。

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