如何在Overleaf中定义LaTeX自定义代码块命令解决fancy verb错误

问题 #

想要在Overleaf中创建\codewithcustom命令，期望用法如下：

\codewithcustom{cpp}{some caption}{
 int a[10];
}

但调用时频繁触发fancy verb error，尝试的自定义命令代码存在语法错误且无法正确解析代码块内容。

问题根源 #

minted属于动词类环境，普通\newcommand的参数解析逻辑无法处理包含换行、空格或特殊符号的代码内容，会破坏minted的语法结构，导致错误。

解决方法 #

利用xparse包的\NewDocumentCommand，配合+v参数类型（支持包含换行的逐字内容）来定义命令，同时修正语法错误：

正确的自定义命令 #

\NewDocumentCommand{\codewithcustom}{m m +v}{
  \begin{listing}[!ht]
    \begin{minted}{#1}
      #3
    \end{minted}
    \caption{#2}
  \end{listing}
}

参数说明：

• m：必填普通参数，指定编程语言（如cpp、python）
• m：必填普通参数，代码块的标题文本
• +v：接受包含换行、空格的逐字内容，对应代码块的代码部分

完整可编译示例 #

\documentclass{article}
\usepackage{minted}
\usepackage{xcolor}
\usepackage{caption}
\usepackage{xparse}
\definecolor{LightGray}{gray}{0.98}

% 全局minted配置
\setminted{frame=none, 
breaklines=true,
framesep=5mm,
fontsize=\large,
baselinestretch=1.2,
bgcolor=LightGray,
tabsize=2,
linenos}

% 自定义代码块命令
\NewDocumentCommand{\codewithcustom}{m m +v}{
  \begin{listing}[!ht]
    \begin{minted}{#1}
      #3
    \end{minted}
    \caption{#2}
  \end{listing}
}

\title{C++ & Python Personal Notes}
\author{Rakesh Shrestha}
\date{January 2025}
\begin{document}
\maketitle

\section{Vectors & raw Arrays}
\subsection{Initialization}

% 使用自定义命令插入代码块
\codewithcustom{cpp}{Initialize empty elements with specified size in vectors}{
vector<vector<int>> bucket(maxFreq + 1);
for(const auto& a: hmap){
    bucket[a.second].push_back(a.first);
}
}

\codewithcustom{cpp}{Initialize specified vectors with data}{
vector<vector<int>> bucket(10, 2);
}

\end{document}

注意事项 #

• +v是核心：确保命令能正确识别代码块中的换行和特殊字符，避免解析错误
• 保持代码格式：#3直接传递代码内容，不要额外添加空格，防止代码排版混乱
• 语法闭合：确保listing环境正确闭合，避免额外编译错误

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