CoffeeScript
借助 GoLand,您可以使用 CoffeeScript 编写代码并将其编译为 JavaScript。 GoLand 会识别 *.coffee 文件并使用 进行标记。 您可以直接在 CoffeeScript 代码中设置断点,GoLand 会使用编译期间生成的 source map 进行识别。
GoLand 通过为关键字、标识、变量、参数和函数提供补全建议来协助您编写 CoffeeScript 代码。 您可以使用 Ctrl+B 跳转到符号声明,使用 Ctrl+Alt+B 跳转到其实现,还可以使用 Ctrl+Alt+Shift+N 按名称查找任意符号。
GoLand 与 coffeescript 编译器集成,可将 CoffeeScript 代码转换为 JavaScript。 该工具还会生成 source map ,用于关联 CoffeeScript 代码与生成的 JavaScript 代码中的对应行,使得 GoLand 调试器能够识别并正确处理断点。
开始之前
下载并安装 Node.js。
按照 从 JetBrains Marketplace 安装插件 中的说明,在 设置 | 插件 页签 Marketplace 上安装并启用 CoffeeScript 插件。
请确保在设置中启用了 File Watchers 插件。 按下 Ctrl+Alt+S 打开设置页面,然后选择 。 点击 已安装 选项卡。 在搜索字段中输入 File Watchers。 有关插件的更多信息,请参阅 管理插件。
将 CoffeeScript 编译为 JavaScript
要自动编译代码,您需要配置一个 CoffeeScript File Watcher ,以跟踪文件更改并运行编译器。
当您打开文件时,GoLand 会检查当前项目中是否存在适用的 File Watcher。 如果已配置但未启用 File Watcher,GoLand 会显示提示,告知您已配置的 File Watcher 并建议启用它。
如果当前项目中已配置并启用了适用的 File Watcher,GoLand 会在 New Watcher dialog 中指定的事件发生时自动启动编译器。
如果选中了 自动保存已编辑文件以触发监视器 复选框,则每当源代码发生更改时,File Watcher 会立即被调用。
如果未选中 自动保存已编辑文件以触发监视器 复选框,则 File Watcher 会在保存(、 Ctrl+S )时或切换焦点离开 GoLand(即窗口失去焦点时)后启动。
可参阅 文件监视器 了解更多信息。
编译器将生成的输出文件存储为单独文件。 该文件名称与源 CoffeeScript 文件相同,根据编译器类型使用 .js 或 .js.map 扩展名。 生成文件的位置由 需刷新的输出路径 字段(在 New Watcher dialog 中)定义。 GoLand 会根据此设置识别编译器输出。 但是,在 项目 工具窗口 Alt+1 中,它们会显示在源 coffee 文件下方,该文件现在显示为一个节点。
安装 CoffeeScript 编译器
在嵌入式 终端 (Alt+F12 )中,键入以下命令之一:
用于全局安装的
npm install --global coffeescript。使用
npm install --save-dev coffeescript安装 CoffeeScript 作为 开发依赖项。请访问 CoffeeScript 官方网站了解更多信息。
创建 CoffeeScript File Watcher
按 Ctrl+Alt+S 打开设置,然后选择 。
点击
或按 Alt+Insert ,然后从列表中选择 CoffeeScript 预定义模板。 您的代码将被转换为 JavaScript,并附带生成的 source maps。
请按照 文件监视器 中所述进行操作。
自定义编译器行为
使用 GoLand 时,您可以通过向编译器传递参数来调整其行为,就像在命令行模式下操作一样。 以下是自定义 CoffeeScript compiler 默认输出位置的示例。
假设您有一个具有以下文件夹结构的项目:

使用默认的 File Watcher,生成的文件将作为原始文件的子项显示。

您可以更改该默认位置,并将生成的文件存储在单独的 JavaScript 文件夹中。
将所有生成的文件存储到输出 JavaScript 文件夹中

在 参数 字段中键入:
--map --compile -o $ProjectFileDir$/JavaScript $FileName$在 需刷新的输出路径 字段中键入:
$ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map
结果,项目结构如下所示:

您还可以将生成的文件存储在 app 节点下与原始结构相同的文件夹结构中。
在输出文件夹中保留原始文件夹结构
创建 CoffeeScript File Watcher。
在 参数 字段中键入:
--map --compile -o $ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$ $FileName$在 需刷新的输出路径 字段中键入:
$ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.js:$ProjectFileDir$/JavaScript/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.map:$FileNameWithoutExtension$.js.map
结果,项目结构如下所示:

无需运行编译器即可预览编译结果
GoLand 能够在不实际运行编译器的情况下对您的 CoffeeScript 代码执行静态分析,并在专用的只读查看器中显示预测的编译结果。
在编辑器中打开所需的 CoffeeScript 文件,并右击编辑器背景。
从上下文菜单中选择 。 预览将打开于专用的只读查看器中:左侧窗格显示原始的 CoffeeScript 源代码,右侧窗格显示编译器运行时生成的 JavaScript 代码。
运行 CoffeeScript
在 GoLand 中运行 CoffeeScript 的方式有两种:
手动编译 CoffeeScript 代码,然后像运行 Node.js 应用程序一样运行生成的 JavaScript 代码。
通过 Node.js 运行配置运行原始 CoffeeScript 代码,GoLand 将实时编译。
手动编译 CoffeeScript 并运行生成的 JavaScript 代码
开始创建 Node.js 运行配置 ,并设置以下必要选项:
要使用的 Node.js 引擎。 默认情况下,该字段显示在配置 Node.js 时的 Node.js 页面上指定的解释器路径。
在 工作目录 字段中,指定从起始 CoffeeScript 文件引用的文件的位置,例如 includes。 如果该文件不引用任何其他文件,只需将该字段留空。
在 Node 应用 JS 文件路径 字段中,指定在编译期间从原始 CoffeeScript 文件生成的 JavaScript 文件的完整路径。
保存配置,然后在对话框中点击 运行。
或者,在主工具栏中从列表中选择新建的运行配置,然后点击
。
操作方式与 运行 Node.js 应用程序 时相同。
运行时即时编译 CoffeeScript
该模式要求 register.js 文件(属于
coffeescript包的一部分)位于您的项目中。在编辑器中打开起始 CoffeeScript 文件,或在 项目 工具窗口中选择 Alt+1 并从上下文菜单中选择 。 GoLand 使用自动生成的运行/调试配置运行该文件。
或者,从上下文菜单中选择 ,并在打开的 Run/Debug Configuration: Node.js 对话框中检查下列必要设置:
保存配置,然后点击工具栏上的
。
或者,在主工具栏的列表中选择新建的运行配置,然后点击
。
操作方式与 运行 Node.js 应用程序 时相同。
调试 CoffeeScript
要在 GoLand 中调试 CoffeeScript,您需要在生成 JavaScript 代码的同时生成 source maps。 source maps 用于建立 CoffeeScript 代码与生成的 JavaScript 代码之间的行对应关系,否则断点将无法被识别和正确处理。 JavaScript 和 source maps 是通过使用类型为 CoffeeScript 的 File Watcher 手动编译 CoffeeScript 代码生成的。 之后,您可以像调试 Node.js 应用程序一样调试生成的 JavaScript 代码。
仅在 本地模式下支持调试 CoffeeScript。 这意味着 GoLand 本身会根据运行配置启动 Node.js 引擎和目标应用,并完全控制会话。
有关调试 Node.js 应用的更多信息,请参见 运行和调试 Node.js。
调试 CoffeeScript 代码
在需要位置的 CoffeeScript 代码中设置 breakpoints。
使用类型为 CoffeeScript 的 File Watcher 将 CoffeeScript 代码编译为 JavaScript。
开始创建 Node.js 运行配置 ,使用以下必需设置:
要使用的 Node.js 引擎。 默认情况下,该字段显示在配置 Node.js 期间于 Node.js 页面上指定的解释器路径。
在 工作目录 字段中,指定要运行的起始 CoffeeScript 文件中引用的文件的位置,例如 includes。 如果该文件未引用任何其他文件,则将此字段留空即可。
在 Node 应用 JS 文件路径 字段中,指定编译期间从原始 CoffeeScript 文件生成的 JavaScript 文件的完整路径。
保存配置并点击工具栏上的
。
如同 在本地启动调试器和 Node.js 应用时那样继续操作。
配置语法高亮
您可以根据自身的偏好和习惯配置 CoffeeScript 的语法高亮显示。
在 设置 对话框(Ctrl+Alt+S )中,转到 。
选择配色方案,接受继承自默认设置的高亮设置,或按照 颜色与字体 中所述进行自定义。