1. IEEEtran 模板下 BibTeX 编译链路为什么总报错
如果你正在准备 IEEE 会议或期刊投稿，大概率已经下载了官方的 Manuscript Templates，把IEEEtran.cls、IEEEtran.bst、IEEEabrv.bib一股脑丢进项目目录，然后兴冲冲地写了一句\bibliography{references}，结果编译出来参考文献位置只有一个问号，或者干脆提示I couldn't open database file references.bib。这不是你 LaTeX 装得不对，而是 IEEEtran 这套模板对 BibTeX 的编译顺序和文件依赖有比较严格的要求。
先说清楚这套链路到底在干什么。IEEEtran 模板本身是一个文档类，它规定了论文的版式、字体、栏宽、标题样式；而 BibTeX 是一个独立的参考文献处理程序，它读取你的.bib数据库文件，按照IEEEtran.bst这个样式文件定义的规则，生成一个.bbl文件，最后 LaTeX 再把这个.bbl内容排版进正文。也就是说，一次完整的编译至少要跑四遍：pdflatex → bibtex → pdflatex → pdflatex。少跑任何一步，引用编号就会是问号，或者显示成[?]。
我见过太多人卡在第一步：.bib文件里写的是@article{key, ...}，正文里写的是\cite{key}，但编译时只跑了pdflatex，没跑bibtex，于是 LaTeX 找不到对应的.bbl，只能输出问号。还有人把IEEEtran.bst和IEEEabrv.bib放错了目录，BibTeX 在编译时找不到样式文件，直接报I couldn't open style file IEEEtran.bst。这些问题的根源都不是 LaTeX 本身，而是编译链路没有对齐。
另一个高频坑是\bibliography{}和\bibliographystyle{}的顺序。IEEEtran 要求先写\bibliographystyle{IEEEtran}，再写\bibliography{references}，而且这两行通常放在\end{document}之前、正文最后。如果你把\bibliographystyle写在\begin{document}之前，BibTeX 可能会读不到，导致样式不生效。还有人把\bibliography写成了\bibliography{references.bib}，多加了.bib后缀，BibTeX 会去找references.bib.bib，自然找不到。
再一个容易被忽略的点是.bib文件里的字段格式。IEEEtran 的样式对作者、标题、期刊名、年份、页码这些字段的解析比较严格。比如author = {John Smith and Jane Doe}，多个作者必须用and连接，不能用逗号；journal = {IEEE Transactions on Communications}这种长期刊名，IEEEtran 会自动缩写，但前提是你用了IEEEabrv.bib里的缩写定义。如果你没把IEEEabrv.bib放到同目录，或者没有在.bib里正确引用缩写，编译出来的期刊名可能就不符合 IEEE 要求。
所以，与其在报错里反复试错，不如把整条链路拆开：先确认文件放对位置，再确认.bib格式正确，然后按固定顺序编译，最后检查.bbl是否生成。下面我会按这个思路，把每一步都写成可以直接复制的配置和命令，并且顺带把从本地到统一 Key/API 通道的接入验证动作也串起来，方便你在投稿前做一次完整的编译验证。
2. TaoToken 前置准备：统一 Key 与 API 通道接入
在正式改 BibTeX 配置之前，先把 TaoToken 的接入通道准备好。这一步不是必须的，但如果你后续要用模型辅助检查.bib格式、批量生成引用条目，或者用 Coding Plan 跑一些自动化脚本，提前把 Key 和 Base URL 配好会省很多事。TaoToken 的官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api ，这两个地址建议先记下来。
先说 Key 怎么拿。打开 https://taotoken.net/api-keys ，登录后创建一个新的 API Key，复制出来保存好。这个 Key 就是后面所有请求的凭证，格式通常是一串以sk-开头的字符串。注意不要把它直接写进.tex或.bib文件里，更不要提交到公开仓库。如果你只是本地做编译验证，可以把它放在环境变量里，比如export TAOTOKEN_API_KEY="sk-xxxx"，然后在脚本里读取。
接下来是 Base URL 的配置。TaoToken 的 API 入口是 https://taotoken.net/api ，所有兼容 OpenAI 接口的客户端都可以把 Base URL 指向这个地址。比如你在用 Cline、Cursor 或者自己写的 Python 脚本，配置项通常长这样：
{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的Key", "model": "claude-3-5-sonnet" }如果你用的是 Claude Code 或者类似的 Anthropic 接口客户端，Base URL 同样指向 https://taotoken.net/api ，然后在环境变量里设置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。具体写法可以参考官方文档 https://taotoken.net/doc ，里面有不同客户端的配置示例。
这里要强调一点：TaoToken 是一个统一的 API 通道，不是让你替代 LaTeX 编辑器。你的.tex编译、BibTeX 运行还是在本地或者 Overleaf 上完成，TaoToken 只是在你需要模型辅助的时候提供一个稳定的接口。比如你可以写一个脚本，把.bib文件里的条目读出来，让模型检查字段是否完整、格式是否符合 IEEEtran 要求，然后把修正建议写回文件。这个流程和 BibTeX 编译是两条线，不要混在一起。
如果你打算长期做论文写作和代码辅助，可以考虑 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它适合需要频繁调用模型做代码生成、格式检查、文献整理这类任务的场景。模型对话入口在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，你可以先在那里试一下模型对.bib格式的理解，确认输出符合预期再接入脚本。
配置完成后，建议先做一次最简单的验证请求，确认 Key 和 Base URL 都能通。用 curl 发一个请求：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-3-5-sonnet", "messages": [{"role": "user", "content": "回复 OK"}] }'如果返回里能看到choices字段和正常的文本内容，说明通道已经通了。这一步做完，再回到 BibTeX 配置，就不会因为 Key 或 Base URL 的问题分心。
3. 可复制配置：.bib 文件与 IEEEtran 编译片段
现在进入正题。假设你的项目目录结构是这样的：
paper/ ├── main.tex ├── IEEEtran.cls ├── IEEEtran.bst ├── IEEEabrv.bib └── references.bibIEEEtran.cls、IEEEtran.bst、IEEEabrv.bib这三个文件必须和main.tex在同一目录。如果你是从 IEEE 官网下载的模板包，里面通常已经包含了这些文件，直接拷贝过来就行。注意不要只拷.cls而漏掉.bst和.bib，否则 BibTeX 编译时会报I couldn't open style file IEEEtran.bst。
接下来是main.tex里的关键配置。在\begin{document}之前，确保文档类声明正确：
\documentclass[conference]{IEEEtran} % 如果是期刊，用 \documentclass[journal]{IEEEtran}然后在正文最后、\end{document}之前，加上这两行：
\bibliographystyle{IEEEtran} \bibliography{references}注意\bibliography{references}里的references不带.bib后缀，BibTeX 会自动去找references.bib。如果你写成\bibliography{references.bib}，它会去找references.bib.bib，直接报错。
再来看references.bib的写法。一个符合 IEEEtran 要求的条目通常长这样：
@article{smith2023, author = {John Smith and Jane Doe}, title = {A Novel Approach to Wireless Communication}, journal = {IEEE Transactions on Communications}, year = {2023}, volume = {71}, number = {5}, pages = {1234--1245}, doi = {10.1109/TCOMM.2023.1234567} } @inproceedings{lee2024, author = {David Lee and Sarah Chen}, title = {Deep Learning for Signal Processing}, booktitle = {2024 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP)}, year = {2024}, pages = {567--571}, publisher = {IEEE} }几个关键点：多个作者之间用and连接，不要用逗号；页码用两个连字符--，不要用单个-；期刊名写全称，IEEEtran 会结合IEEEabrv.bib自动缩写；doi字段可选，但加上更规范。如果你在正文里引用，写\cite{smith2023}或\cite{lee2024}，编译后会生成[1]、[2]这样的编号。
如果你用的是 Overleaf，文件上传后目录结构是一样的，但要注意 Overleaf 默认可能不会自动跑 BibTeX。你需要在编译时选择pdfLaTeX作为编译器，然后手动执行 BibTeX 步骤，或者把编译命令改成latexmk。Overleaf 的菜单里有一个 "Recompile" 按钮，旁边可以切换编译模式，选 "pdfLaTeX" 后，再点一次 "Recompile"，它通常会自动跑 BibTeX。如果还是不行，就在项目设置里把 "Compile Mode" 改成 "Normal"，不要用 "Fast"。
对于本地编译，推荐用latexmk，它会自动处理 BibTeX 的编译顺序：
latexmk -pdf main.tex如果你不想用latexmk，就手动按顺序跑：
pdflatex main.tex bibtex main pdflatex main.tex pdflatex main.tex注意bibtex main里的main是你的.tex文件名去掉后缀，不是main.tex。跑完bibtex后，目录里会生成main.bbl和main.blg。.blg是 BibTeX 的日志文件，如果编译有问题，先看这个文件里的报错。
还有一个细节：如果你在.bib里用了IEEEabrv.bib里的缩写，比如journal = {IEEE Trans. Commun.}，那就不需要额外操作；但如果你写的是全称，IEEEtran 会自动去IEEEabrv.bib里找对应的缩写。前提是IEEEabrv.bib和references.bib在同一目录，并且\bibliography{references}能正确加载。如果你把IEEEabrv.bib放在了子目录里，需要在\bibliography{}里写相对路径，比如\bibliography{refs/references,refs/IEEEabrv}，多个.bib文件用逗号分隔。
4. 验证请求与成功结果：一次编译通过且引用编号正确
配置写完后，先别急着改内容，跑一次完整编译，确认链路是通的。打开终端，进入paper/目录，执行：
pdflatex main.tex bibtex main pdflatex main.tex pdflatex main.tex每一步的输出都要看一眼。第一遍pdflatex会生成main.aux，里面记录了所有\cite{}的引用键。bibtex main会读取main.aux和references.bib，按照IEEEtran.bst的规则生成main.bbl。如果这一步报错，终端会直接显示，比如：
I couldn't open database file references.bib这说明 BibTeX 找不到你的.bib文件，检查文件名和路径。如果显示：
I found no \citation commands说明你的.tex里没有任何\cite{}，或者\bibliography{}写错了位置。如果显示：
Warning--I didn't find a database entry for "smith2023"说明正文里引用了smith2023，但references.bib里没有这个键，检查拼写。
第二遍和第三遍pdflatex是为了把.bbl里的内容排版进正文，并解析交叉引用。跑完后打开main.pdf，翻到参考文献部分，应该能看到类似这样的输出：
[1] J. Smith and J. Doe, "A Novel Approach to Wireless Communication," IEEE Transactions on Communications, vol. 71, no. 5, pp. 1234-1245, 2023.正文里的\cite{smith2023}应该显示成[1]，而不是[?]。如果显示的是[?]，说明.bbl没有正确加载，或者\bibliography{}的位置不对。检查main.aux里是否有\bibdata{references}和\bibstyle{IEEEtran}，如果没有，说明\bibliographystyle和\bibliography没写对。
另外，检查main.blg文件，里面会记录 BibTeX 的详细处理过程。如果看到：
Database file #1: references.bib You've used 2 entries, 2118 wiz_defined-function locations, 579 strings with 5678 characters, and the built_in function-call counts, 1234 in all, are: ...说明 BibTeX 成功读取了 2 个条目，没有报错。如果看到error字样，就按提示去改.bib文件。
如果你在 Overleaf 上编译，点 "Recompile" 后看日志输出，找到 "BibTeX" 那一栏，确认没有红色报错。Overleaf 的日志里会显示bibtex的运行结果，如果成功，会看到Process started和Process exited normally。如果失败，日志里会直接给出错误行号，比如references.bib: line 12: syntax error，按行号去改就行。
验证通过后，你可以把编译命令写成一个脚本，比如build.sh：
#!/bin/bash pdflatex -interaction=nonstopmode main.tex bibtex main pdflatex -interaction=nonstopmode main.tex pdflatex -interaction=nonstopmode main.tex这样每次改完.bib或.tex，直接跑./build.sh就行，不用手动敲四遍命令。如果你用latexmk，更简单：
latexmk -pdf -interaction=nonstopmode main.texlatexmk会自动判断是否需要跑 BibTeX，省去手动顺序的麻烦。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
虽然 BibTeX 编译本身不涉及网络请求，但如果你在接入 TaoToken 做辅助检查时遇到报错，这里列几个高频问题，方便对照排查。
第一个是401 Unauthorized。这通常出现在你调用 TaoToken API 时，Key 没传对或者过期了。检查你的请求头里是否有Authorization: Bearer sk-xxxx，Key 是否复制完整，有没有多余的空格。如果你用的是环境变量，确认echo $TAOTOKEN_API_KEY能输出正确的值。如果 Key 刚创建，等几秒钟再试，有时候服务端同步需要一点时间。
第二个是local proxy failed。这个报错一般出现在客户端配置了本地代理，但代理没有启动或者端口不对。检查你的客户端设置里是否填了http://127.0.0.1:xxxx这样的代理地址，如果有，先关掉代理，直接用 Base URLhttps://taotoken.net/api请求。如果你在公司网络里，确认防火墙没有拦截对taotoken.net的访问。
第三个是reading choices相关的报错，比如Error reading choices field或者返回的 JSON 里没有choices。这通常是请求体格式不对，比如model字段写错了，或者messages数组为空。检查你的请求 JSON，确保model是 TaoToken 支持的模型 ID，messages里至少有一条role和content。如果你用的是 Claude Code 或 Anthropic 接口，注意请求路径可能是/v1/messages而不是/v1/chat/completions，具体看文档 https://taotoken.net/doc 。
第四个是OAuth相关的报错。如果你用的是 Claude Code 或者某些需要 OAuth 授权的客户端，可能会遇到OAuth token expired或invalid_grant。这时候需要重新走一遍授权流程，或者改用 API Key 方式接入。TaoToken 的 API Key 方式不需要 OAuth，直接填 Key 就行。如果你在 Claude Code 里配置，参考官方文档里的 ClaudeCodeAnthropic 接入说明，把ANTHROPIC_BASE_URL指向 https://taotoken.net/api ，ANTHROPIC_API_KEY填你的 Key。
还有一个和 BibTeX 直接相关的报错：I couldn't open style file IEEEtran.bst。这说明 BibTeX 找不到样式文件。检查IEEEtran.bst是否和main.tex在同一目录，文件名大小写是否一致。Linux 下文件名区分大小写，IEEEtran.bst和ieeetran.bst是两个不同的文件。如果你从官网下载的模板包里文件名是IEEEtran.bst，就不要改成小写。
另一个常见报错是Warning--empty journal in smith2023。这说明你的.bib条目里journal字段为空，但@article类型要求必须有期刊名。检查条目，补上journal = {IEEE Transactions on Communications}这样的字段。如果是@inproceedings，对应的字段是booktitle，不要写错。
如果你在.bib里用了中文或者特殊字符，比如author = {张三}，编译时可能会报Unicode character not set up。IEEEtran 默认不支持中文，建议把作者名写成拼音，比如author = {Zhang San}。如果必须用中文，需要额外引入ctex宏包，但这会改变模板的字体和版式，投稿前要确认期刊是否允许。
最后，如果你在 Overleaf 上遇到Emergency stop或者Fatal error occurred，先看日志里第一个!开头的错误行，那才是根因。后面的报错往往是连锁反应。比如! Undefined control sequence可能是因为你用了某个宏包但没引入，或者命令拼写错了。把第一个错误解决掉，后面的往往自动消失。
6. 语义一致 CTA：从编译验证到统一通道的下一步
编译通过、引用编号正确之后，你可以把整个流程固化下来。我的习惯是：每次改完.bib，先跑一遍latexmk -pdf main.tex，确认没有报错，再看main.blg里有没有 warning。如果一切正常，就把.bbl和.pdf一起归档，方便后续对比。
如果你打算用模型辅助检查.bib格式，可以写一个简单的 Python 脚本，把references.bib读进来，调用 TaoToken 的 API 让模型检查字段完整性。比如：
import os import requests api_key = os.environ["TAOTOKEN_API_KEY"] bib_content = open("references.bib", "r").read() response = requests.post( "https://taotoken.net/api/v1/chat/completions", headers={"Authorization": f"Bearer {api_key}"}, json={ "model": "claude-3-5-sonnet", "messages": [ {"role": "user", "content": f"检查以下 BibTeX 条目是否符合 IEEEtran 格式，指出缺失字段：\n{bib_content}"} ] } ) print(response.json()["choices"][0]["message"]["content"])这个脚本跑通的前提是你的 Key 和 Base URL 已经配好。如果返回 401，回到第 5 节检查 Key；如果返回的 JSON 里没有choices，检查请求体格式。模型给出的建议可以作为参考，但最终还是要以 IEEEtran 的编译结果为准，因为模型可能会漏掉一些样式细节。
如果你需要更稳定的模型调用通道，可以走 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它适合需要频繁做格式检查、文献整理、代码生成的场景。模型对话入口在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，你可以先在那里试一下模型对.bib的理解，确认输出符合预期再接入脚本。API Keys 管理在 https://taotoken.net/api-keys ，接入文档在 https://taotoken.net/doc ，这两个地址建议收藏，后续换 Key 或者查配置示例都用得上。
最后提醒一句：投稿前一定要用 IEEE 官方的模板包重新编译一次，确认.bst和.bib文件版本一致。有些期刊会要求你用最新的IEEEtran.bst，旧版本生成的参考文献格式可能不符合要求。编译通过后，把.tex、.bib、.bbl、.pdf一起打包，再检查一遍引用编号是否连续、作者名拼写是否正确、期刊名缩写是否符合 IEEE 规范。这些细节做完，基本就不会在格式审查阶段被退回了。