LaTeX与Python代码高亮实战：解决minted包跨平台配置难题

第一次在LaTeX文档中插入Python代码时，我被那个红色的编译错误吓得不轻。屏幕上赫然显示着"Package minted Error: You must invoke LaTeX with the -shell-escape flag."，而谷歌搜索给出的解决方案却让我在TeXStudio、VS Code和命令行之间反复切换。更糟的是，当我终于搞定shell-escape参数后，中文文档又出现了乱码。这就是技术写作中最真实的困境——每个看似简单的功能背后，都藏着无数个可能让你抓狂的"坑"。

1. 环境准备：避开Pygments安装的常见陷阱

1.1 Python环境与Pygments安装

在开始使用minted包之前，确保Python环境正确配置是首要任务。不同于纯LaTeX宏包，minted需要Python的Pygments库作为后端支持，这带来了跨平台兼容性的第一道门槛。

对于Python环境，我强烈建议使用最新稳定版的Python 3.x（目前3.8+版本最佳）。在终端中运行以下命令检查版本并安装Pygments：

bash复制python --version  # 检查Python版本
pip install pygments  # 基础安装命令

国内用户可能会遇到下载速度慢的问题，这时可以使用清华镜像源加速：

bash复制pip install pygments -i https://pypi.tuna.tsinghua.edu.cn/simple

注意：如果你同时使用Anaconda，建议在base环境外创建专门用于LaTeX的conda环境，避免包冲突。

1.2 LaTeX发行版的选择与配置

不同的LaTeX发行版对minted的支持程度有所差异。以下是主流发行版的对比：