独立站资料文件命名与目录规范
先说结论本节给出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 与结构化适配说明
| 文件名全英文小写 | 中文文件名在部分系统与浏览器上会乱码,海外买家拿到后也无法归档 |
|---|---|
| 型号与 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 官方最新文档为准。
相关阅读
独立站产品手册下载页模板独立站认证证书下载页模板独立站 TDS / MSDS 资料下载页模板独立站工程图纸下载页模板PDF 文件元信息设置规范(Title / Author / Subject / Keywords)声明:本页仅为公开技术规则的整理汇总,不构成优化承诺;涉及搜索引擎行为的描述以 Google 官方最新文档为准,具体站点请以 Search Console 实测数据为准。