LaTeX表格中调用Sage-Python查词API显示??，求解决方案

核心问题原因 #

1. 函数传参错误：调用\sage{define(request)}时，未将单词request作为字符串传入，Sage会把request当作未定义变量处理，导致API请求URL无效，最终返回错误，LaTeX无法解析显示为??。
2. 未处理LaTeX特殊字符：API返回的释义可能包含_、&、%等LaTeX特殊字符，直接插入会引发编译错误或显示异常。
3. 依赖缺失风险：若Sage环境未安装requests库，函数会抛出异常，同样导致LaTeX无法正常解析返回内容。

修复步骤与完整代码 #

1. 修正函数传参 #

将表格中的调用改为\sage{define("request")}，明确传入字符串形式的目标单词。

2. 添加LaTeX特殊字符转义函数 #

在Python代码中新增转义逻辑，处理返回释义中的特殊字符，避免LaTeX编译报错。

3. 确保Sage环境安装requests #

在Sage终端执行pip install requests，确保依赖库可用。

修改后的完整代码：

\documentclass{article}
\usepackage{tabularx}
\usepackage{textcomp} % 用于\textasciitilde{}等特殊字符命令

\begin{document}

\begin{sagesilent}
import requests

def escape_latex(s):
    # 转义LaTeX特殊字符
    special_chars = {
        '&': r'\&',
        '%': r'\%',
        '$': r'\$',
        '#': r'\#',
        '_': r'\_',
        '{': r'\{',
        '}': r'\}',
        '~': r'\textasciitilde{}',
        '^': r'\textasciicircum{}'
    }
    for char, replacement in special_chars.items():
        s = s.replace(char, replacement)
    return s

def define(word):
    url = f"https://api.dictionaryapi.dev/api/v2/entries/en/{word}"

    try:
        response = requests.get(url)
        data = response.json()

        if response.status_code == 200:
            # 提取释义并转义LaTeX特殊字符
            definition = data[0]['meanings'][0]['definitions'][0]['definition']
            return escape_latex(definition)
        else:
            return escape_latex(f"Failed to fetch definition. Status code: {response.status_code}")

    except requests.RequestException as e:
        return escape_latex(f"Error: {e}")
\end{sagesilent}

%\input{title} % 若你的title文件存在可保留

\section{Vocabulary}\label{sec:vocabulary}

\begin{tabularx}{\textwidth}{l|X}
    \toprule
    Word  & Definition \\ \midrule
    request & \sage{define("request")} \\
    example & \sage{define("example")} \\ % 可添加更多单词示例
    \bottomrule
\end{tabularx}

\end{document}

编译说明 #

需使用SageTeX编译流程：

1. 运行sage -latex yourfile.tex
2. 再用常规LaTeX编译器（如pdflatex）编译生成PDF

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