1. 先搞清楚你要的是显示链接还是可点击链接很多人第一次在 LaTeX 里碰 URL都是因为一个非常实际的场景写论文时要把项目主页、GitHub 地址、参考文献的 DOI 放进去。结果一编译发现地址里的下划线不见了或者整个地址变成了一坨黑色的方块点也点不动。然后就开始怀疑是不是宏包装错了其实多半是没分清两种截然不同的需求。第一种需求是把 URL 照原样排版出来让它看起来是个链接。比如你写一份技术文档、简历、或者课程作业需要把https://github.com/username/project这串字符完整地显示在页面上该换行时换行该等宽字体就等宽字体。这种情况下你只需要url宏包就够了它提供\url{}命令能把 URL 中的特殊字符处理得妥妥帖帖还不容易溢出页边距。第二种需求是让链接真正可以点击跳转。比如你希望读者在 PDF 里点一下链接就直接打开浏览器访问那个地址点一下参考文献编号就跳到文末的参考文献列表点一下图表编号就跳到对应的图或表。这需要hyperref宏包它会在编译时把 LaTeX 内部的各种引用、目录、URL 都转换成 PDF 的超链接注解。url宏包和hyperref宏包是两码事但又有千丝万缕的关系。hyperref内部其实会加载url宏包的能力来处理 URL 的排版只是它更进一层把这些排版好的 URL 加上了一层可点击的壳。所以我在实际项目里的做法是如果只是要在文档里展示一个链接地址不加跳转那就单独用url如果文档有交叉引用、目录跳转需求那就直接用hyperref它顺带把\url也升级为可点击版本一举两得。下面这张表能帮你快速定位自己的需求需求场景推荐宏包核心命令说明只排版 URL不需要点击url\url{}字体、断行处理完善加载轻量论文/报告中的交叉引用跳转hyperref\url{}、\href{}同时支持目录、引用、URL 跳转需要自定义链接显示文字hyperref\href{实际地址}{显示文字}点击地址不变页面只显示自定义文字只要 URL 样式不要点击功能url\nolinkurl{}也支持通过\urlstyle{}调整字体样式2. 基础语法拆解\href、\url 与 \nolinkurl 谁该用在哪儿我见过不少初学者把三个命令混着用结果排版效果和自己预期完全不一样。这里把它们的区别一次讲清楚。\url{http://example.com}是展示型命令。它会把 URL 原样输出并自动使用等宽字体通常是 typewriter 字体族。它的最大优势是你不用手动转义 URL 里的特殊字符比如_、#、%这些在 LaTeX 里有特殊含义的符号在\url{}里都可以直接写。这是一般文本模式里做不到的。因为\url本质上是按逐字读取verbatim的方式处理参数所以 URL 里的特殊字符不会被解释。\href{http://example.com}{示例站点}是跳转型命令。它有两个参数第一个是真实的 URL 地址第二个是页面上显示的文字。第二个参数可以是任意内容中文、加粗、普通文本都行。比如你在简历上想显示我的 GitHub这几个字但实际点击要跳转到https://github.com/xxx那就用\href{https://github.com/xxx}{我的 GitHub}。\nolinkurl{http://example.com}是两者之间的状态按 URL 的排版规则显示但不生成超链接。这个命令的使用场景比较特殊。我常用的一个场景是当某个链接已经被前面的文字完整说清楚了或者你希望打印出来的纸质版不显示任何可点击样式但排版又需要标准的 URL 效果时就会用它。另外在\footnote里如果用\url有时候会因为嵌套导致报错换用\nolinkurl能规避掉一部分奇奇怪怪的问题。下面是一个完整的示例你可以直接编译看看效果\documentclass{article} \usepackage[colorlinkstrue, urlcolorblue]{hyperref} \begin{document} 我的项目主页\url{https://github.com/username/latex-playground} 点击访问\href{https://github.com/username/latex-playground}{GitHub 项目仓库} 不可点击的样式\nolinkurl{https://github.com/username/latex-playground} \end{document}编译之后你会看到第一行是蓝色的可点击链接显示的实际就是 URL 字符串本身第二行显示的是GitHub 项目仓库这几个字点击同样能跳转第三行虽然看起来也是等宽字体的 URL但没有链接注解点击无效。这里有个我在实际使用中总结的选型原则如果页面显示的内容和 URL 地址完全一致用\url最省事如果显示文字需要美化、加中文、或者为了版面整洁只显示一部分信息那就用\href。在正式投稿论文中多数学会模板默认推荐的行为是参考文献里的 DOI 用\href{...}{...}包起来正文里出现的网址直接用\url即可因为审稿人更在意可读性和跳转的可靠性而不是花哨的显示效果。3. 超长 URL 的断行问题最容易被忽视的排版事故说实话写 LaTeX 加了hyperref之后最常见的翻车现场不是链接不可用而是页边距被撑爆。尤其是你往参考文献列表里塞了一长串 GitHub 链接或者某个 API 文档的地址长得离谱编译出来直接溢出页边丑得没法看。为什么会这样因为 LaTeX 在排版 URL 时默认只在极少数友好断行点处允许换行比如斜杠/后面、点号.后面。而现代 URL 经常是一长串字母数字连在一起没有这些符号就宁死不断。hyperref宏包提供了breaklinks选项但它对 PDF 模式下有效并且只能说明允许断开具体断在哪还得靠url宏包内部的断行规则。我试过几种方案逐个说效果。最直接的方法是加载xurl宏包。这个宏包是在url宏包基础上重新设计了断行逻辑允许在 URL 任意字符处断行同时会插入一个连字符hyphen提示读者这里断开了。用法非常简单\usepackage{xurl} \usepackage{hyperref}注意顺序xurl要在hyperref之前加载。实测下来这个方案对绝大多数超长链接都有效尤其是那些不带斜杠的长参数地址。缺点也很明显断行点太自由有些地方断开后看起来不太自然比如在数字中间断开。但对于别溢出页面这个底线需求来说完全够用。如果不想引入xurl只想在url宏包基础上做微调可以修改断行点的优先级。url宏包内部定义了\UrlBreaks和\UrlBigBreaks两个命令分别对应低优先级和高优先级的断行位置。你可以手动往里面加字符\usepackage{url} \def\UrlBreaks{\do\.\do\\do\\\do\/\do\!\do\_\do\|\do\;\do\}\do\-}% \def\UrlBigBreaks{\do\:\do\do\\\do\/\do\!\do\_\do\|\do\;\do\}\do\-}%这一串\do的意思是把.、、/、_这些字符都标记为允许断行的位置。但说实话这种手动配置比较折腾而且不同文档类、不同字体下效果差异很大我不太推荐新手直接上手改。你先用xurl解决 95% 的问题剩下的 5% 用\sloppy或者局部调整文本宽度来处理。还有一个容易被忽略的点是否允许在 URL 内部断行和你使用的编译引擎也有关。我用的比较多的是pdflatex断行处理相对稳定如果你换成xelatex或lualatex有些宏包选项会失效比如breaklinks在某些引擎组合下支持得并不好。我的实际建议是如果文档主要面向 PDF 输出且包含大量链接优先选择pdflatexhyperrefxurl的组合这是我踩坑踩出来最省心的一套配置。4. 链接外观定制颜色、边框、下划线学术论文到底该怎么设链接排好了能断行了接下来就是外观。这里提醒一句默认情况下的 hyperref 链接样式在投稿论文里几乎一定会被毙掉。因为默认显示是高亮红色边框在 PDF 阅读器里表现为彩色线框或者色块打印出来黑乎乎一团非常不专业。hyperref宏包提供了几个批量控制链接外观的选项最常用的是colorlinks、hidelinks和一组合法颜色配置。如果你希望链接文字带有颜色而不要边框可以这样设置\usepackage[colorlinkstrue, urlcolorblue, citecolorblue, linkcolorblue]{hyperref}其中urlcolor控制\url和\href的显示颜色citecolor控制引用参考文献编号的颜色linkcolor控制目录、交叉引用、页码等内部链接的颜色。这三个颜色尽量统一要么全蓝要么全黑通过hidelinks实现不要搞成赤橙黄绿青蓝紫。我自己的偏好是用深蓝色作为链接色因为深蓝在黑白打印时表现为灰色不太影响阅读而纯蓝色在打印出来时经常显得发灰发浅某些老式打印机还会糊成一片。推荐几个稳妥的 RGB 组合\usepackage[colorlinkstrue, urlcolorblue!50!black, citecolorgreen!50!black, linkcolorred!50!black]{hyperref}这里用了xcolor的颜色混合语法。blue!50!black表示蓝色和黑色各取 50% 混合出来的效果是藏青色比纯蓝色耐看。不过注意citecolor用绿色并不适合所有场景如果你是投计算机方向的期刊绿色引用编号在印刷版上不够醒目如果只是自己看或者投某些偏好传统印制的期刊红色或者黑色反而更稳妥。如果你完全不想让链接有任何视觉特征只保留点击功能用hidelinks选项\usepackage[hidelinks]{hyperref}这个选项会把所有链接的边框和颜色都去掉链接文字和普通文本完全一样但点击依然有效。我写工作笔记和内部报告时就用这个选项页面干净不会分散注意力。还有一个容易踩的细节colorlinks模式下PDF 里的链接文字会被染色但如果你把 PDF 拿去印刷颜色会被转成灰度有些颜色在灰度下几乎没有区分度。所以在投稿之前建议用hidelinks或者保守颜色跑一版确保打印出来的纸质稿不混乱。5. 特殊字符转义URL 里带 #、%、_、~、 怎么处理才不翻车URL 里经常混着一堆在 LaTeX 文本模式下有特殊含义的字符比如_下标、^上标、#宏参数、%注释符、表格对齐符、~不断行空格。如果你直接在普通文本里写这些 URL一定会报错或者显示乱码。这时候就体现出\url{}和\href{}{}的区别了。在\url{}内部绝大部分特殊字符可以直接写不需要手动加反斜杠。比如\url{https://example.com/search?qlatexlangzh#section}这种带和#的链接在\url{}里可以原样放进去编译不会报错。但在\href{}{}的第一个参数里情况就没这么宽松了。因为\href的第一个参数本质上还是普通宏参数特殊字符会被 LaTeX 解释。我曾经在写一个带查询参数的链接时直接在\href里写了#结果编译直接挂掉。后来查清楚了\href{URL}{文本}中的 URL 部分#需要写成\#%需要写成\%需要写成\_需要写成\_~需要写成\string~或者\textasciitilde{}。下面是一份我整理的对照表方便你写的时候直接查字符普通文本模式\url{}内部\href{}{}的 URL 参数_\_可直接写\_#\#可直接写\#%\%可直接写\%\可直接写\~\~{}可直接写\string~^\^{}可直接写\^{}这里再补充一个实战里很容易翻车的场景URL 里含有%20这类百分号编码的空格。你在\href的参数里如果写%20那 LaTeX 会把%20当作注释的开始然后这一行剩下的内容全部被吞掉导致后文格式错乱。解决方式就是写成\%20。在\url{}里则可以直接写%20因为 URL 参数是逐字读取的不会再解析%为注释符。还有一种情况是链接本身很长你想在\href的显示文本里折行显示它的一部分但 URL 地址参数不要折行。比如显示项目主页点击访问实际链接是完整的一长串。这种场景直接用\href{...}{项目主页点击访问}就行显示文本是普通文本可以自由断行不需要考虑 URL 断行规则。最后提醒一点~在 URL 里经常代表路径或用户目录在\url里可以直接写~但在\href里必须写成\string~否则会被当作 LaTeX 的不换行空格轻则排版异常重则编译报错。我当年第一次写 Bitbucket 链接时在这儿卡了十分钟后来记住这个表就再也没出过问题。6. 场景组合拳参考文献 DOI、脚注链接、邮件地址与文档内部跳转链接玩法不止是往正文里贴一个网址。实际论文写作里有四个高频率场景值得单独拿出来说。6.1 参考文献里的 DOI学术论文中参考文献条目里通常要放 DOI。现在主流期刊要求 DOI 必须是可点击跳转的链接而且显示出来的最好还是doi:10.xxxx/xxxx的格式而不是又长又难看的https://doi.org/10.xxxx/xxxx。标准的写法是\href{https://doi.org/10.1000/xyz123}{doi:10.1000/xyz123}这样页面上显示的是doi:10.1000/xyz123但点击后会跳到https://doi.org/10.1000/xyz123。这个写法的好处是版面看起来干净符合期刊排版习惯而且跳转逻辑非常直接。如果你用的是 BibTeX通常是在.bib文件里的note或url字段里写这条链接。不同模板处理doi字段的方式不一样有的模板会自动加https://doi.org/前缀有的不会。稳妥做法是直接在url字段里写好完整的\href命令。6.2 脚注里的 URL论文正文里不适合把一长串 URL 直接铺在文字中尤其是双栏排版动不动就溢栏。我一般推荐把访问链接放到脚注里数据下载地址见脚注\footnote{\url{https://example.com/dataset/long/path/2024}}。这里有个坑\url在脚注里有时候断行判断会失效特别是当脚注区域太窄时。我的解决方案是用\href配合短文本把长 URL 隐藏到链接背后\footnote{数据集下载\href{https://example.com/dataset/long/path/2024}{点击这里}。}这样脚注里只出现点击这里几个字整个链接被隐藏在超链接注解里不会再触发断行问题。不过要注意有些 PDF 阅读器对脚注区域内的超链接支持不好读者不一定能点到所以我在正式文档里会同时把完整 URL 以普通文本形式放在\nolinkurl{}里再写一遍兼顾可用性和排版。6.3 邮件地址邮件地址本质上是 URL 的一种变体协议是mailto。写法如下联系方式\href{mailto:zhangsanexample.com}{zhangsanexample.com}这里同样推荐显示文本和真实地址一致的写法因为 PDF 里点击后会调用默认邮件客户端写新邮件收件人地址就是mailto后面的那部分。如果你把显示文本写成联系我读者虽然可以点击但在纸上阅读时看不到实际邮箱内容是没有意义的。所以邮件地址我从来不用自定义显示文本一律显示真实地址。6.4 文档内部交叉引用hyperref最核心的杀手级功能其实是让 LaTeX 的交叉引用全部变成可点击链接。你正常用\label和\ref之后在hyperref生效的前提下引用编号会自动被加上超链接注解点一下就能跳到对应的图表、公式或章节。这里有一个必须注意的坑如果你在\caption或者\section里直接放了\url{}再对这个章节或图表做交叉引用链接可能会出现错位。解决办法是用\texorpdfstring把 LaTeX 版本和 PDF 书签版本的显示内容分开\section{项目主页\texorpdfstring{\url{https://example.com}}{https://example.com}}\texorpdfstring第一个参数是排版显示的内容第二个参数是生成 PDF 书签时使用的纯文本。这样书签里不会出现\url命令也不会报错目录里的跳转也正常。7. 我的 LaTeX 链接配置模板直接抄作业版写了一整个项目之后我总结了一套可以直接复制粘贴的配置模板兼顾了可点击、断行、配色和打印版的兼容性\documentclass[11pt]{article} \usepackage[UTF8]{ctex} \usepackage{xurl} \usepackage[colorlinkstrue, urlcolorblue!60!black, citecolorblue!60!black, linkcolorblue!60!black, bookmarkstrue, pdftitle{我的文档标题}, pdfauthor{作者姓名} ]{hyperref} \begin{document} 正文里直接这样写 项目主页\url{https://github.com/username/latex-link-example} 自定义显示文字的跳转 \href{https://github.com/username/latex-link-example}{GitHub 仓库} 参考文献 DOI \href{https://doi.org/10.1000/xyz123}{doi:10.1000/xyz123} 脚注链接 \footnote{详细说明见\href{https://example.com/faq}{FAQ 页面}} \end{document}几点补充说明第一xurl和hyperref的顺序千万不能反了。xurl必须在hyperref之前否则断行优化不会生效。第二colorlinkstrue之后所有颜色尽量统一我用同一款藏青色贯穿全部链接类型页面非常整洁。第三如果你要导出 PDF/A 格式提交存档记得加\usepackage{pdfx}或者用模板自带的 PDF/A 配置否则超链接注解可能不符合存档标准。这一套配置我在写课程报告、期刊投稿稿和内部技术文档时都在用从未出现过链接显示异常或断行溢出问题。唯一一次例外是某个非常老的模板内部自己加载了url宏包但没有声明breaklinks导致冲突那次我直接在模板文件里找到那一行注释掉了改用xurl补齐。最后再分享一个我实际操作中的体会写 LaTeX 链接最忌讳的是临到提交前才加 hyperref。因为hyperref会改变很多内部行为包括目录格式、引用样式、PDF 书签结构越晚加入越容易和模板的既定设置冲突。我一般从一开始就带着链接配置写文档这样后期改动成本最低。如果你是在写完论文之后才想起来加链接记得把文档里所有\url、\href的使用位置检查一遍尤其是图表标题和章节标题内部的 URL百分之百需要\texorpdfstring兜底别偷懒。