如何将Org Mode代码块导出为tcolorbox环境而非lstlisting？

要将Org文档中的#+begin_src代码块导出为tcolorbox环境的tcblisting格式，解决浮动脱节和长代码分页问题，可按以下步骤操作：

1. 加载必要的LaTeX宏包 #

在Org文档开头添加LaTeX头部配置，确保tcolorbox和minted功能正常：

#+latex_header: \usepackage[most]{tcolorbox}
#+latex_header: \usepackage{minted}
#+latex_header: \tcbuselibrary{minted}

2. 自定义代码块导出模板 #

方式一：文档内局部设置 #

在Org文档中添加以下配置，覆盖默认的代码块导出规则：

#+latex_src_block_backend: tcolorbox
#+latex_src_block_template: ("\\begin{tcblisting}{breakable, minted language=%l, minted options={breaklines=true, breakanyware=true, linenos=true}}" "%s" "\\end{tcblisting}")

• %l会自动替换为代码块指定的语言（如python）
• breakable参数开启跨分页支持
• minted options中的参数控制代码换行、任意位置换行和行号显示

方式二：全局Emacs配置 #

如果希望所有Org文档都采用此格式，可在Emacs配置文件中添加：

(setq org-latex-src-block-backend 'tcolorbox)
(setq org-latex-src-block-template
      '("\\begin{tcblisting}{breakable, minted language=%l, minted options={breaklines=true, breakanyware=true, linenos=true}}"
        "%s"
        "\\end{tcblisting}"))

3. 编译注意事项 #

编译导出的LaTeX文件时，需要添加-shell-escape参数以支持minted的代码高亮功能，例如：

pdflatex -shell-escape your_document.tex

内容的提问来源于stack exchange，提问作者Nobody-86