如何在 CoffeeScript 中发表评论？ “/*这个*/”不起作用

Question

您可以通过哪些方式在 CoffeeScript 中进行评论？

文档说您可以使用三个哈希符号来启动和关闭注释块：

###
  Comments
  go
  here
###

我发现有时可以使用以下两种格式

`// backticks allow for straight-JavaScript,
 // but the closing backtick can't be on a comment line (I think?)
`

是否有更简单的方法在 CoffeeScript 中插入简短注释？

不要使用这种风格**

由于这种风格得到了很多浏览，我想强调的是，

/* Comment goes here */

当 /* 位于其自己的行上时，会产生数学错误。

正如 Trevor 在对该问题的评论中指出的那样，这是一个正则表达式，不是评论！

Answer 1

使用单个 # 符号

# like this

一个字符似乎很少;)

另外：

###
This block comment (useful for ©-Copyright info) also gets 
passed on to the browsers HTML /* like this! */
###

Answer 2

注释的主要方式是 sh/Perl/Ruby/... 风格的 # 注释：

# This comment goes to the end of the line
# and it won't appear in the "compiled"
# JavaScript version.

您使用 块样式 ### 注释 当您希望注释出现在 JavaScript 版本中时：

有时您希望将块注释传递给生成的 JavaScript。例如，当您需要在文件顶部嵌入许可标头时。块注释反映了heredocs的语法，并保留在生成的代码中。

因此，如果您从以下位置开始

###
PancakeParser is Public Domain
###

，您将在生成的 JavaScript 中看到以下 JavaScript 注释：

/*
PancakeParser is Public Domain
*/

Answer 3

小心###！如果您使用 ### 来分隔代码部分（就像我所做的那样），当该代码因此停止工作时，您会感到非常惊讶。

Answer 4

对于行中间的注释，请尝试：

if somecond `/* hi */` && some other cond, etc.

反引号使 CoffeeScript 将包含的文本按原样放入生成的 JavaScript 中。

Answer 5

不幸的是，CoffeeScript 与使用单个 # 字符引入的注释是否进入输出 JavaScript 不一致。例如：

# testme.coffee

fName = 'John'
lName = 'Smith'
fullName = "#{fName} #{lName}" # |||| $:
if true #comment
    console.log `/* hi */` 'Hello, World!'

编译为

// Generated by CoffeeScript 2.7.0
(function() {
  // testme.coffee
  var fName, fullName, lName;

  fName = 'John';

  lName = 'Smith';

  fullName = `${fName} ${lName}`;

  if (true) { //comment
    console.log(/* hi */`Hello, World!`);
  }

}).call(this);

注意分配给 fullName 的行上缺少的注释。