编码规范

以下是 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])。这里是相关的 讨论记录