Learn X in Y minutes 系列:CoffeeScript 核心语法与实践全览
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"的具体体现:
- 自动
var声明:所有赋值都会在函数/顶层作用域内补全var,规避隐式全局变量; - 默认参数防御式赋值:采用
== null判断而非||,保留 falsy 值; - 闭包隔离推导变量:数组推导生成的循环变量被 IIFE 封装,不泄漏到外层;
- 显式类型比较:
is/isnt编译为===/!==,杜绝宽松相等带来的坑; - 参数切片封装: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 编码,保证全仓库教程质量一致。