编码规范
以下是 Electron 项目中代码书写规范的指导方针。
C++ 和 Python
对于 C++ 和 Python,我们追随 Chromium 的Coding
Style。你可以通过 script/cpplint.py
来检验所有文件是否符合要求。
我们使用的 Pyhton 版本是 Python 2.7。
其中 C++ 代码中用到了许多 Chromium 的抽象和类型,我们希望你对其有所熟悉。一个好的去处是 Chromium 的重要的抽象和数据结构。这个文档提到了一些特殊的类型、域内类型(当超出作用域时会自动释放内存)、日志机制等等。
CoffeeScript
对于 CoffeeScript,我们追随 GitHub 的Style Guide 及如下规则:
- 文件不应该以换行结尾,因为我们要匹配 Google 的规范。
- 文件名应该以
-
作连接而不是_
,等等。file-name.coffee
而不是file_name.coffee
,因为在 github/atom 模块名通常都是module-name
的形式。这条规则仅应用于.coffee
文件。
API 名称
当新建一个API时,我们应该倾向于 getters 和 setters 的方式,而不是
jQuery 的单函数形式。例如,.getText()
和 .setText(text)
优于 .text([text])
。这里是相关的
讨论记录。