张雪峰数字媒体技术莱芜网站优化团队

🧾 1. 博客文章文件名该怎么取？

“文章标题可以长，但文件名必须短。”

如果你也在写博客，特别是使用 Markdown + Git 的方式进行内容管理，那么你一定碰到过一个问题：

“这篇文章的文件该叫什么名？”

别小看这个细节，它关乎博客的可维护性、项目的整洁性、以及协作时的阅读体验。

---

📌 2. 为什么文件名重要？

博客内容最终是以 Markdown 文件存在的。如果文件名混乱，比如：

• 这是我的第一篇博客.md
• k8s总结_v1最终版(2023).md
• 🧠小技巧(2).md

你将会遇到：

• Git 冲突时找不到头绪
• URL 地址乱码
• 排序混乱、不利归档
• 图片路径不好关联

所以，规范化文件名是提升内容质量的第一步。

---

✅ 3. 推荐命名规范

✅ 3.1 使用 小写英文 + 中划线（kebab-case）

比如：

kubernetes-intro.md
javascript-basic-guide.md
docusaurus-presets.md

中划线比下划线或驼峰更适合 URL 和命令行。

✅ 3.2 简短但具备语义

尽量控制在 3~6 个英文单词以内，避免写满整篇标题。

📌 示例对比：

文章标题	推荐文件名
Kubernetes 入门详解	kubernetes-intro.md
JavaScript 基础学习路线	javascript-basic-guide.md
解密 Docusaurus Presets	docusaurus-presets.md
用 Git 快速配置 SSH 与 GPG	git-ssh-gpg-setup.md
运维转前端的第 30 天	ops-to-frontend-day30.md

✅ 3.3 如果是系列文章，可加前缀序号或标识

frontend-01-html-basics.md
frontend-02-css-intro.md
frontend-03-js-beginner.md

✅ 3.4 文件夹结构建议搭配使用

为了防止图片、文章杂乱，可以搭配以下结构使用：

blog/
├── kubernetes-intro.md
├── javascript-basic-guide.md
├── ...
static/
└── img/└── blog/├── kubernetes-intro/│   └── cover.png└── javascript-basic-guide/└── example.png

---

🔍 4. 常见命名误区

| 错误示例                 | 原因                   |
| ------------------------ | ---------------------- |
| `K8S学习笔记（最终）.md` | 中文+特殊字符不规范    |
| `article123456.md`       | 无语义，无法区分       |
| `GITconfig入门.md`       | 大小写混杂，难记忆     |
| `final-last-edited.md`   | 意图不明确，混乱版本名 |

---

✨ 5. 小技巧：配合 Git 管理更高效

• Git commit message 中引用文章更清晰
• 跨设备同步后，文件名仍保持一致
• 写作流程统一，配合脚本、CI 更友好

---

🚀 6. 总结一下

✅ 你的博客文章文件名应该是：

• 英文小写 + 中划线
• 简短、语义清晰
• 与 URL 和图片目录兼容
• 可被自动脚本处理

命名即管理，命名即未来。

你给文章取的每一个文件名，其实就是给它贴的「身份证」——你未来一定会感谢当下认真命名的自己！

---

💬 7. 留言交流

如果你也在写技术博客，欢迎来 我的博客 交流你对内容结构、写作流程的理解与心得

Thanks for reading 🙏

Write blogs like code. Write file names like APIs.
—— ghostwritten