在 Gatsby 静态站点中，直接通过 链接 PDF 文件虽可实现下载，但可能导致搜索引擎抓取并索引文件内容。本文介绍两种可靠方案：为链接添加 rel="nofollow" 属性，或在 robots.txt 中屏蔽文件路径。
在 gatsby 静态站点中，直接通过 `` 链接 pdf 文件虽可实现下载，但可能导致搜索引擎抓取并索引文件内容。本文介绍两种可靠方案：为链接添加 `rel="nofollow"` 属性，或在 `robots.txt` 中屏蔽文件路径。
当您使用 Gatsby 的文件导入语法（如 import file from '../files/file.pdf'）并在 <a></a> 标签中引用时，Webpack 会将该 PDF 构建为静态资源（例如 /static/file-abc123.pdf），并生成一个可直接访问的 URL。虽然该资源不属于 React 页面路由范畴，但它仍是一个可通过 HTTP 访问的公开资源——这意味着搜索引擎爬虫只要发现指向它的链接，就可能抓取、解析甚至索引其文本内容（尤其是 PDF 中含可读文字时）。
✅ 推荐方案一：添加 rel="nofollow" 到下载链接
这是最直接、语义清晰且符合规范的做法。rel="nofollow" 明确告知搜索引擎“不要追踪此链接”，从而避免爬虫跳转至 PDF 文件：
import file from '../files/report.pdf'; <a classname="hover:underline hover:text-black" href="%7Bfile%7D" download="annual-report.pdf" rel="nofollow"> 下载年度报告（PDF） </a>
⚠️ 注意：
-
rel="nofollow"应与download属性共存，二者互不冲突； - 不要误用
rel="noindex"（该值仅适用于<meta name="robots">标签，不可用于<a></a>）； - 若链接同时开放在线预览（如移除
download），建议额外增加rel="noopener noreferrer nofollow"以兼顾安全与 SEO。
✅ 推荐方案二：在 robots.txt 中屏蔽文件路径
若站点存在多个需屏蔽的静态文件（如 PDF、DOCX、ZIP），统一通过 robots.txt 管理更高效。在 Gatsby 项目根目录创建或修改 static/robots.txt：
User-agent: * Disallow: /static/*.pdf Disallow: /files/ # 或精确匹配（推荐用于关键文件） Disallow: /static/report-abc123.pdf
Gatsby 会在构建时自动将 static/robots.txt 复制到发布目录（public/robots.txt），确保生产环境生效。您可通过访问 https://yoursite.com/robots.txt 验证内容是否正确部署。
? 补充说明：
-
robots.txt是“建议性协议”，遵守依赖爬虫自觉性（主流引擎如 Googlebot 尊重该规则），但无法完全阻止恶意抓取； - 若 PDF 含敏感信息，应结合服务端权限控制（如迁至私有 CDN 并签名 URL），而非仅依赖
robots.txt或nofollow； - 对已收录的 PDF，可在 Google Search Console 中提交临时移除请求，并确认
robots.txt规则生效后，其索引将在数天至数周内逐步清除。
综上，对于单个下载链接，优先使用 rel="nofollow"；对于批量或长期管理需求，配合 robots.txt 实现双重保障——二者结合，即可有效防止静态文件被意外索引。
