编程中的命名规则

核心哲学:清晰度 > 趣味性

“尊重他人的大脑,不要让人在凌晨两点查 Bug 时还要猜你的工具是做什么的。”

✅ 准则 1:功能直觉(Descriptive First)

✅ 准则 2:善用复合词与后缀

✅ 拥抱冗长(Embrace Verbosity):
- 在调试生产事故时,一个长而清晰的名字(如 auth-token-generator)远比一个短而可爱的名字(如 Pikachu)更有用。

🛠 命名三步决策法 (Decision Matrix)

  1. 它是什么? (例:一个处理 JSON 的库)
  2. 它在哪里用? (例:在 Go 语言里作为中间件)
  3. 最终命名方案:
    • 首选(工程级): go-json-middleware
    • 次选(缩写级): gjsm (需配合文档)
    • 拒绝(文青级): Sparkle

记住: 命名不是创作短篇小说,命名是编写索引。Boring is Professional. (枯燥即专业)