独立站技术规范手册LEYUN · SITE SPEC & COMPONENT LIBRARY

独立站资料文件命名与目录规范

栏目:PDF 资料页规范 · 核实更新:2026-11-20 · 模板资产

先说结论本节给出PDF 资料页规范中「独立站资料文件命名与目录规范」的结构模板、字段定义、适配要点与合规边界。模板仅作参考,上线前请自行核验当地法规与平台规则。

适用行业与场景

  • 产品型号多、文件数量增长后管理混乱的站点
  • 需要批量生成并维护下载页的模板站
  • 中文文件名导致海外买家下载后无法识别的问题
  • 希望文件可被检索、可被搜索引擎理解的站点
模板 / 代码片段html
<!-- 命名规范 -->
<!--
格式:  {type}-{model}-{lang}-{revision}.{ext}
示例:  datasheet-model-a-en-r3.pdf
        sds-model-a-en-r5.pdf
        cert-iso9001-en-r2.pdf
        dwg-model-a-en-r1.pdf

type    取值:datasheet / sds / tds / cert / dwg / manual / drawing
model   小写连字符,与 URL slug 一致
lang    ISO 639-1 两位代码:en / de / fr / es
revision 修订号 r + 数字,与文件内版本标记一致
-->

<!-- 目录规范 -->
<!--
/files/
  /files/datasheet/{model}/{lang}/
  /files/sds/{model}/{lang}/
  /files/tds/{model}/{lang}/
  /files/cert/{cert-id}/{lang}/
  /files/dwg/{model}/
-->

<!-- 生成命名:模板中统一走这一个函数 -->
<script type="text/template">
  function fileName(type, model, lang, revision, ext) {
    var t = String(type).toLowerCase();
    var m = String(model).toLowerCase()
      .replace(/[^a-z0-9]+/g, '-')
      .replace(/^-+|-+$/g, '');
    var l = String(lang).toLowerCase();
    var r = 'r' + String(revision);
    return [t, m, l, r].join('-') + '.' + ext;
  }
  // datasheet / model-a / en / 3 / pdf
  // → datasheet-model-a-en-r3.pdf
</script>
字段与参数说明
字段 / 参数类型说明与取值范围
type枚举datasheet / sds / tds / cert / dwg / manual
model文本小写连字符,与 URL slug 一致
lang文本ISO 639-1 两位代码
revision文本r + 数字,与文件内版本一致
扩展名文本小写,pdf / dwg / step
目录层级说明按类型/型号/语言三层

SEO 与结构化适配说明

SEO 与结构化适配要点
文件名全英文小写中文文件名在部分系统与浏览器上会乱码,海外买家拿到后也无法归档
型号与 URL slug 一致同一型号在页面、URL、文件名三处统一,便于检索与排查
修订号用 r + 数字比 "final" 或 "final2" 更有信息量,且排序天然正确
语言代码用两位en / de / fr / es,与 hreflang 标注体系可对应
类型前缀固定按前缀筛选文件,批量生成时不易出错
文件名不含空格空格在 URL 中需转义,也会在部分下载工具中出问题

合规风险提示

  • 不得在文件名中包含客户名称
  • 不得使用"最终版""最新"这类无法排序的命名
  • 不得让同一文件存在多个不同文件名副本
  • 文件名与文件内版本标记必须一致
  • 不得在文件名中暴露内部报价或成本信息

以下场景不可直接使用本模板,上线前请自行核验当地法规与平台规则。

修改示例

<!-- 修改示例:对比几种命名的问题 -->
<!-- 差:无法排序、无法检索、含中文 -->
<a href="/files/产品A规格书-最终版-最新版.pdf">下载</a>

<!-- 差:看似整齐但信息缺失,无法定位版本 -->
<a href="/files/datasheet-A-v2.pdf">下载</a>

<!-- 好:类型可筛选、型号可对应、语言可识别、版本可排序 -->
<a href="/files/datasheet/model-a/en/datasheet-model-a-en-r3.pdf"
   type="application/pdf">
  MODEL-A Datasheet (EN, rev.3)</a>

<!-- 文件 URL 本身携带完整语义:
     1. /datasheet/ 段 → 可按类型批量筛选
     2. /model-a/ 段 → 与产品页 slug 一致,可反查
     3. /en/ 段 → 与 hreflang 语言代码一致
     4. -r3.pdf → 排序即版本顺序

     同时页面上展示的文字也带上版本号,
     买家存档时不会混淆。 -->

FAQ 高频问题

文件放在子目录还是平铺?
按类型/型号/语言分层。型号多时平铺会导致单目录数千文件,难以管理。
URL 里的文件名必须和实际文件名一致吗?
建议一致。不一致时容易出现下载时找不到文件的错误。
历史版本要保留吗?
保留在归档路径下,但下载页只列当前版本。旧版本往往用于处理已成交订单的追溯。
改名后旧链接怎么办?
做 301 重定向。文件改名不影响文件内容,但外部引用会失效。
版本更新记录2026-11-20:首次发布,按 Google 官方公开文档与公开技术资料整理;后续随搜索引擎规则变化更新。涉及引擎行为的细节以 Google 官方最新文档为准。

声明:本页仅为公开技术规则的整理汇总,不构成优化承诺;涉及搜索引擎行为的描述以 Google 官方最新文档为准,具体站点请以 Search Console 实测数据为准。