Learn X in Y minutes 系列:CoffeeScript 核心语法与实践全览

原创2026-10-09 14:03:061,714 阅读
文章标签:文档教程

Learn X in Y minutes 系列:CoffeeScript 核心语法与实践全览

CoffeeScript 是一种"逐句编译为 JavaScript"的小型语言,运行时不做任何解释,其设计目标是生成可读、格式优美且运行流畅的 JavaScript 代码,并能在任何 JavaScript 运行时中工作。本文以本仓库荷兰语翻译版 nl/coffeescript.md(英文原版见 coffeescript.md)为骨架,完整梳理 CoffeeScript 的注释、赋值、条件、函数、区间、对象、Splats、存在性判断与数组推导等核心语法,并结合编译输出逐一剖析其底层 JavaScript 形态,帮助读者快速掌握这门语言并理解其编译原理。

文档定位与仓库背景

本仓库(learnxinyminutes-docs)是一套"用可运行、带注释的代码来讲解编程语言"的速览式教程集合,正如 README.md 所述,每篇文档都以"有效的、带注释的代码"为主体展开讲解。CoffeeScript 教程在仓库中拥有多个语言版本,包括英文原版 coffeescript.md、荷兰语版 nl/coffeescript.md,以及 de/coffeescript.md、es/coffeescript.md、fr/coffeescript.md、zh-cn/coffeescript.md 等十余种翻译。

以荷兰语版为例,其 YAML 头信息(frontmatter)采用本仓库统一的元数据格式:contributors 记录原作者,translators 记录译者(Jelle Besseling、D.A.W. de Waal、Sam van Kampen)。仓库的 lint/frontmatter.py 会对每篇 Markdown 的 frontmatter 做规范性校验,允许的键包括 name、where_x_eq_name、category、filename、contributors、translators,且要求 contributors/translators 为形如 ["姓名", "主页"] 的嵌套列表结构——这保证了每篇教程的署名与格式一致性。

CoffeeScript 的编译模型

荷兰语文档开篇即点明 CoffeeScript 的核心定位:

  • 它是一门小语言,逐句(one-to-one)编译为等价的 JavaScript;
  • 运行时不存在任何解释过程——浏览器或 Node.js 中执行的是编译产物,而非 CoffeeScript 源码;
  • 作为 JavaScript 的"后继者"之一,它力求输出可读、排版优美、运行流畅的 JavaScript,且能在任何 JavaScript 运行时中正常执行;
  • 同时它试图让 JavaScript 更贴合众多现代语言的趋势(如 Python、Ruby 的风格)。

这一设计意味着:学习 CoffeeScript 的前提是大致理解 JavaScript 语义(文档的块注释中明确提示了这一点),因为编译产物本质上就是手写风格良好的 JavaScript。掌握了这一模型,再看下面的语法示例及其 #=> 后的编译结果,就能直观感受到"源码即映射"的对应关系。

注释:# 与 ###

CoffeeScript 的注释风格与 Ruby、Python 一致:

# CoffeeScript is een taal voor hipsters.
# Het gaat mee met alle trends van moderne talen.
# Commentaar begint dus met een hekje, net zoals bij Python en Ruby.

###
Blokken commentaar maak je zo, ze vertalen naar JavaScripts */ en /*
in de uitvoer van de CoffeeScript-compiler.

Het is belangrijk dat je ongeveer snapt hoe JavaScript
werkt voordat je verder gaat.
###
  • 单行注释以 # 开头,编译时会被剔除;
  • 块注释以 ### 包裹,会直接转换为 JavaScript 的 /* ... */ 注释保留在输出中,适合书写需要随编译产物一起保留的说明文字。

赋值与后置条件

# Toewijzing:
getal         = 42 #=> var getal = 42;
tegengestelde = true #=> var tegengestelde = true;

# Voorwaarden:
getal = -42 if tegengestelde #=> if(tegengestelde) { getal = -42; }
  • 赋值语句就是普通的 =,编译后自动带上 var 声明,无需也不应写 var;
  • 条件语句支持后置 if(postfix condition)写法:动作 if 条件,编译后还原为标准的 if (cond) { ... }。这种语法让"先写主干动作、再补条件"的代码读起来非常自然,是 CoffeeScript 标志性的表达方式之一。

函数:->、隐式返回、默认参数与字符串插值

# Functies:
kwadraat = (x) -> x * x #=> var kwadraat = function(x) { return x * x; }

vul = (houder, vloeistof = "koffie") ->
  "Nu de #{houder} met #{vloeistof} aan het vullen..."
#=>var vul;
#
#vul = function(houder, vloeistof) {
#  if (vloeistof == null) {
#    vloeistof = "koffie";
#  }
#  return "Nu de " + houder + " met " + vloeistof + " aan het vullen...";
#};
  • 函数用 (参数) -> 表达式/语句体 定义,编译为 function 表达式;
  • 隐式返回:函数体最后一行表达式会自动成为返回值,kwadraat 中的 x * x 被编译为 return x * x;;
  • 默认参数:vloeistof = "koffie" 编译成 if (vloeistof == null) { vloeistof = "koffie"; }——注意 CoffeeScript 的默认值语义是"为 null 或 undefined 时才采用默认值",比 JavaScript 常见的 || 默认值更严谨,不会误伤 false、0、空字符串等合法值;
  • 字符串插值:"Nu de #{houder} met #{vloeistof} aan het vullen..." 中的 #{expr} 被编译为字符串拼接 "Nu de " + houder + " met " + vloeistof + " aan het vullen...",与 ES6 模板字符串的机制一脉相承。

区间(Ranges):[1..5]

# Reeksen:
lijst = [1..5] #=> var lijst = [1, 2, 3, 4, 5];

[1..5] 生成闭区间数组 [1, 2, 3, 4, 5]。这一语法糖让连续整数序列的表达极为简洁,常与数组推导、循环配合使用,避免手写循环填充数组。

对象字面量

# Objecten:
wiskunde =
  wortel:   Math.sqrt
  kwadraat: kwadraat
  derdemacht:   (x) -> x * kwadraat x
#=> var wiskunde = {
#  "wortel": Math.sqrt,
#  "kwadraat": kwadraat,
#  "derdemacht": function(x) { return x * kwadraat(x); }
#}
  • 对象使用**缩进 + 键: 值**的形式定义,省略了 JavaScript 的花括号与逗号;
  • 键值既可以是现成变量/函数(kwadraat: kwadraat),也可以是内联函数(derdemacht: (x) -> x * kwadraat x);
  • 注意 x * kwadraat x 展示了 CoffeeScript 的隐式函数调用:紧跟在函数名后的表达式即参数,kwadraat x 等价于 kwadraat(x),编译后补齐括号。

Splats:剩余参数 ...

# "Splats":
wedstrijd = (winnaar, lopers...) ->
  print winnaar, lopers
#=>wedstrijd = function() {
#  var lopers, winnaar;
#  winnaar = arguments[0], lopers = 2 <= arguments.length ? __slice.call(arguments, 1) : [];
#  return print(winnaar, lopers);
#};

Splats 是 CoffeeScript 对"可变参数"的优雅封装:lopers... 收集除 winnaar 之外的所有剩余实参。从编译结果可以看到,它通过 arguments 对象与 __slice.call 实现参数切片:

  • 首个实参绑定 winnaar;
  • 剩余实参(2 <= arguments.length ? __slice.call(arguments, 1) : [])被收集为数组 lopers;
  • 当实参不足时自动退化为空数组 [],不会报错。

这本质上就是现代 JavaScript 中 rest 参数(...args)的前身,读懂这段编译输出也就理解了其边界行为。

存在性判断:elvis?

# Aanwezigheid:
alert "Ik wist het!" if elvis?
#=> if(typeof elvis !== "undefined" && elvis !== null) { alert("I knew it!"); }

变数? 是 CoffeeScript 的存在性操作符(又称 "Elvis" 操作符),用于判断变量"既不是 undefined 也不是 null"。编译产物清晰地展示了其双重检查语义:

if (typeof elvis !== "undefined" && elvis !== null) { ... }
  • 先通过 typeof 检查变量是否已声明(避免直接访问未声明变量抛错);
  • 再检查值是否非 null。

这是 CoffeeScript 防御式编程的利器,尤其适合在浏览器全局环境中探测某个 API 或全局变量是否存在,配合后置 if 写法极为简练。

数组推导(Array Comprehensions)与 when 过滤

# Lijstabstracties:
derdemachten = (wiskunde.derdemacht num for num in lijst)
#=>derdemachten = (function() {
#	var _i, _len, _results;
#	_results = [];
# 	for (_i = 0, _len = lijst.length; _i < _len; _i++) {
#		num = list[_i];
#		_results.push(wiskunde.derdemacht(num));
#	}
#	return _results;
#  })();

etenswaren = ['broccoli', 'spinazie', 'chocolade']
eet eten for eten in etenswaren when eten isnt 'chocolade'
#=>etenswaren = ['broccoli', 'spinazie', 'chocolade'];
#
#for (_k = 0, _len2 = etenswaren.length; _k < _len2; _k++) {
#  eten = etenswaren[_k];
#  if (eten !== 'chocolade') {
#    eet(eten);
#  }
#}

数组推导(list comprehension)用 (表达式 for 变量 in 数组) 的形式批量生成新数组,其编译产物揭示了底层实现细节:

  • 外层被包裹为一个立即执行函数表达式(IIFE),内部维护 _results 结果数组;
  • 用 for 循环遍历源数组,逐个 _results.push(...) 收集结果,最后 return _results;
  • 这样的封装有效避免了污染外层作用域(循环变量 _i、_len 被限定在闭包内)。

第二段示例展示了带过滤的循环式推导:eet eten for eten in etenswaren when eten isnt 'chocolade',其中:

  • for ... in 遍历数组(区别于 for ... of 遍历对象属性);
  • when 子句编译为循环内的 if 条件,仅对满足条件的元素执行动作;
  • isnt 是 CoffeeScript 的"不相等"操作符,编译为 !==(严格不等),与 is(编译为 ===)相对,解决了 JavaScript 中 ==/!= 隐式类型转换的隐患。

完整示例:一份可运行的 CoffeeScript 速览

将上述语法整合为一份完整的速览代码(源自 nl/coffeescript.md 的主体示例,#=> 后为对应编译产物):

# Toewijzing:
getal         = 42 #=> var getal = 42;
tegengestelde = true #=> var tegengestelde = true;

# Voorwaarden:
getal = -42 if tegengestelde #=> if(tegengestelde) { getal = -42; }

# Functies:
kwadraat = (x) -> x * x #=> var kwadraat = function(x) { return x * x; }

vul = (houder, vloeistof = "koffie") ->
  "Nu de #{houder} met #{vloeistof} aan het vullen..."
#=>var vul;
#
#vul = function(houder, vloeistof) {
#  if (vloeistof == null) {
#    vloeistof = "koffie";
#  }
#  return "Nu de " + houder + " met " + vloeistof + " aan het vullen...";
#};

# Reeksen:
lijst = [1..5] #=> var lijst = [1, 2, 3, 4, 5];

# Objecten:
wiskunde =
  wortel:   Math.sqrt
  kwadraat: kwadraat
  derdemacht:   (x) -> x * kwadraat x
#=> var wiskunde = {
#  "wortel": Math.sqrt,
#  "kwadraat": kwadraat,
#  "derdemacht": function(x) { return x * kwadraat(x); }
#}

# "Splats":
wedstrijd = (winnaar, lopers...) ->
  print winnaar, lopers
#=>wedstrijd = function() {
#  var lopers, winnaar;
#  winnaar = arguments[0], lopers = 2 <= arguments.length ? __slice.call(arguments, 1) : [];
#  return print(winnaar, lopers);
#};

# Aanwezigheid:
alert "Ik wist het!" if elvis?
#=> if(typeof elvis !== "undefined" && elvis !== null) { alert("I knew it!"); }

# Lijstabstracties:
derdemachten = (wiskunde.derdemacht num for num in lijst)
#=>derdemachten = (function() {
#	var _i, _len, _results;
#	_results = [];
# 	for (_i = 0, _len = lijst.length; _i < _len; _i++) {
#		num = list[_i];
#		_results.push(wiskunde.derdemacht(num));
#	}
#	return _results;
#  })();

etenswaren = ['broccoli', 'spinazie', 'chocolade']
eet eten for eten in etenswaren when eten isnt 'chocolade'
#=>etenswaren = ['broccoli', 'spinazie', 'chocolade'];
#
#for (_k = 0, _len2 = etenswaren.length; _k < _len2; _k++) {
#  eten = etenswaren[_k];
#  if (eten !== 'chocolade') {
#    eet(eten);
#  }
#}

从以上编译输出可以归纳出 CoffeeScript 编译器的几条稳定行为,这也是它"输出可读 JavaScript"的具体体现:

  1. 自动 var 声明:所有赋值都会在函数/顶层作用域内补全 var,规避隐式全局变量;
  2. 默认参数防御式赋值:采用 == null 判断而非 ||,保留 falsy 值;
  3. 闭包隔离推导变量:数组推导生成的循环变量被 IIFE 封装,不泄漏到外层;
  4. 显式类型比较:is/isnt 编译为 ===/!==,杜绝宽松相等带来的坑;
  5. 参数切片封装:Splats 用 __slice.call(arguments, n) 实现,边界为空数组。

如何上手实践

如果你希望在本地亲手验证上述编译行为,常见做法是:通过 npm 安装 CoffeeScript 编译器(coffee 命令),将源码写入 .coffee 文件后执行 coffee -c 文件.coffee 生成对应的 .js 文件,或使用 coffee 的交互式 REPL 逐行观察编译结果。本文档中的所有 #=> 输出即来自这类编译验证,是理解"源码—产物"一一对应关系的直接途径。需要提醒的是,文档本身面向的是语法速览而非工程脚手架,实际项目落地时还涉及模块化、构建集成等议题,可作为后续深入的方向。

仓库内延伸阅读

  • 英文原版与各语言版本:对比阅读 coffeescript.md(含 name: CoffeeScript 与 filename: coffeescript.coffee 元数据)与 nl/coffeescript.md、zh-cn/coffeescript.md 等翻译,可同时熟悉术语的多语言表达;
  • 相关语言教程:livescript.md 讲解的 LiveScript 正是 CoffeeScript 的衍生分支(经由 Coco 分叉而来),延续了缩进语法、函数式风格,可作为进阶阅读;
  • 仓库规范:README.md 说明了本项目的定位与投稿方式,CONTRIBUTING.md 提供了详细的格式指南,lint/frontmatter.py 与 lint/encoding.sh 则分别校验各文档的 YAML 元数据与 UTF-8 编码,保证全仓库教程质量一致。
登录后查看全文
learnxinyminutes-docs