clean-code-javascript-es：西班牙语版的代码整洁之道

clean-code-javascript-es：西班牙语版的代码整洁之道

最近在 GitHub 上看到一个项目，把《Clean Code》这本书的 JavaScript 版本翻译成了西班牙语。Star 数有 3500 多，不算特别高，但内容质量确实不错。

这个项目叫 clean-code-javascript-es，作者是 andersontr15。原版是 ryanmcdermott 写的 clean-code-javascript，在圈子里挺有名的。西班牙语版基本把核心内容都翻译过来了，包括变量命名、函数设计、对象和类的使用、SOLID 原则这些。

项目结构

内容组织得很清晰，按主题分了几个大块：

• Variables（变量）
• Funciones（函数）
• Objetos y estructuras de data（对象和数据结构）
• Clases（类）
• SOLID
• Pruebas（测试）
• Concurrencia（并发）
• Resolver los errores（错误处理）
• Formatear（格式化）
• Comentarios（注释）

每个部分都是先给个"错误示范"，再给个"正确示范"，对比着看很直观。这种写法比干讲理论更容易理解。

具体内容

拿变量命名这部分来说，项目里举了不少例子。比如用yyyymmdstr这种看不懂的缩写，换成fechaActual这种一眼就知道意思的。还有把conseguirInfoUsuario()、conseguirDataDelCliente()这些不同叫法统一成conseguirUsuario()。

函数设计那块讲得更细。强调函数参数最好控制在两个以内，多了的话测试起来很麻烦。还建议用 ES6 的解构语法，让参数更清晰。

最有意思的是"单一职责"那部分。作者说如果一个函数做太多事，测试起来就很痛苦。举了个写客户列表的例子，原来一个函数又要查数据库又要判断状态又要输出，拆成三个函数后每个都好测试。

为什么值得看

对于学 JavaScript 的西班牙语开发者来说，这项目挺实用的。原版《Clean Code》虽然是经典，但全是英文，读起来费劲。这个翻译版把理论和代码示例都本地化了，理解起来更顺畅。

项目里有些细节处理得不错。比如把"moment"库的日期格式化例子改成西班牙语习惯，变量名用ubicacion而不是location。这种小地方能看出翻译者是认真考虑过语境的。

不过要说缺点，项目本身没什么原创代码，主要是翻译和整理。Star 数不高也说明受众相对小众。但如果你正好是西班牙语开发者，或者想对比不同语言的代码风格，看看这个项目还是有收获的。

总结

clean-code-javascript-es 是个扎实的翻译项目，把代码整洁的原理用西班牙语讲清楚了。内容组织得好，例子也实用。虽然不是那种会爆火的项目，但对目标用户来说确实有价值。

语讲清楚了。内容组织得好，例子也实用。虽然不是那种会爆火的项目，但对目标用户来说确实有价值。