npm 包 clever-coffeescript-style-guide 使用教程

阅读时长 4 分钟读完

简介

clever-coffeescript-style-guide 是一个用于检测和格式化 CoffeeScript 代码的 npm 包,它根据开发者社区的最佳实践规则进行修改和选择。

它提供了一组经过精心设计的规则(准确来说已经有 56 条规则),使得调试和代码审查更加有效和简单。

安装

在终端运行以下命令来安装 clever-coffeescript-style-guide

使用

配置

在项目的 package.json 中添加以下代码实现配置方式:

  • extends:基于这个规则集执行代码约束限制。
  • globals:在这里定义全局变量,以便 linter 不会将此类变量标识为未定义。

执行

运行以下命令以开始检查和修复 CoffeeScript 文件:

  • npx:在不全局安装包的情况下为其创建一个别名。
  • coffeelint:命令行工具。
  • -f:指定使用的 CoffeeLint 配置文件。
  • node_modules/clever-coffeescript-style-guide/chosenRuleSetConfig.coffee:配置文件的位置。
  • myfile.coffee:您要检查和修复的文件的名称。

规则

下面列出了 clever-coffeescript-style-guide 中可用的规则:

  1. 缩进
  2. 行长度
  3. 空白行
  4. 函数括号空格
  5. 嵌套空格
  6. 变量命名
  7. 对象键和值
  8. 可读性命名
  9. 特殊赋值语句
  10. 注释
  11. 空格 or 星号
  12. 字符串引号
  13. 逗号位置
  14. 数组访问符
  15. 错误处理
  16. 代码块
  17. Unicode
  18. if 判断
  19. 新建行 after
  20. 逗号前有空格
  21. 尾随空格
  22. 一些子句中的尾随逗号
  23. 带节奏的代码
  24. 函数调用与参数
  25. 禁用指定的方法 / 属性
  26. 自定义代码库
  27. buildChainReturn
  28. 返回语句
  29. 这些关键字后没有空格
  30. 赋值
  31. 括号
  32. 模板字符串
  33. 循环
  34. 不允许使用双冒号操作符
  35. 操作符
  36. 变量初始化值
  37. 模块引入
  38. 全局变量
  39. 防止滥用 this
  40. function 标识符和括号之间有空格
  41. 空块
  42. 二进制和八进制文字
  43. switch
  44. 参数数量约束
  45. For 循环
  46. 常量命名
  47. 函数返回值
  48. if else if else
  49. 用 == 而不是 unless
  50. 一些 else 分支没有 if
  51. 数组切片
  52. 隐式返回值
  53. 定义多个变量
  54. while 循环
  55. 访问控制
  56. 过度使用 else

示例代码

以下是 clever-coffeescript-style-guide 所规定的格式化后的示例代码:

-- -------------------- ---- -------
- -----------

----- ------
  ------------ ------- ----- --

  ------- --
    ----

  - -------- ----------------- --- --------- -----
  --------- --
    --- ----- --------- ---- --------

- --- -----------
--- - --- -- --
  ------ - - -

- -----------
--- - --- -- -- - - -

总结

使用 clever-coffeescript-style-guide 来检查和格式化您的 CoffeeScript 代码是一个非常好的想法,因为它可以帮助您遵循最佳开发实践,并避免一些常见的错误。 请按照本文提供的步骤安装、配置和使用这个 npm 包,以确保您的 CoffeeScript 代码具有高质量、可读性和可维护性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/79101

纠错
反馈