SublimeLinter-eslint

此为 SublimeLinter 程序的代码检查插件，提供对 SublimeLinter 以及 ESLint 的接口。它将用于 "JavaScript" 文件，由于 eslint 是可插拔的，因此它实际上可以检查多种其他文件。

安装

为了使用此插件，必须安装 SublimeLinter。

请通过 Package Control 安装。

在使用此插件之前，确保您的系统已安装了 eslint。要安装 eslint，请在终端中输入以下命令

• 安装 Node.js （以及在 Linux 上安装 npm）。

• 通过以下命令在全局范围内安装 eslint

npm install -g eslint

• 或者在您的项目文件夹内（必须在该文件夹中有一个 package.json 文件）本地安装 eslint

npm install -D eslint

快速修复

eslint 提供了一些错误的快速修复方案。这些修复方案在 SublimeLinter 中作为快速操作可用。请参阅命令面板： SublimeLinter: Quick Action。（也请参考： https://github.com/SublimeLinter/SublimeLinter#quick-actionsfixers）

您可能需要定义一个快捷键

// To trigger a quick action
    { "keys": ["ctrl+k", "ctrl+f"],
      "command": "sublime_linter_quick_actions"
    },

与插件一起使用 eslint（例如 vue）

SublimeLinter 会检测一些已安装的 本地 插件，因此它应该可以自动处理例如 .vue 或 .ts 文件。如果在命令行上可以正常工作，那么在没有进一步操作的情况下，它可能在 Sublime 中也能正常工作。

• 确保插件与 eslint 本身安装在相同的目录下。也就是说，技术上，eslint 及其插件都在同一个 package.json 文件中描述。
• 本README文档不涉及插件配置。请务必阅读它们的README文档。（如果您只是安装了一个插件，没有进行适当的配置，eslint很可能会显示错误消息或错误的lint结果，而SublimeLinter则会直接将其传递给您。）

默认情况下，SublimeLinter可检测typescript、vue、svelte、html和json。请为重要的其他插件提交一个PR。请注意，但是，当您手动配置executable时，您也选择了退出自动插件检测并仅回退到“Javscript”的linting。

无论如何，如果您想控制SublimeLinter发送到eslint的文件，您总是可以手动更改"selector"设置，仅包含您显式想要的作用域。对于“JavaScript”，默认值为source.js - meta.attribute-with-value，确保将其包含在配置中。

示例

对于TypeScript的.ts文件，它会是

"linters": {
    "eslint": {
        "selector": "source.ts, source.js - meta.attribute-with-value"
    }
}

对于Vue.js的.vue文件，它会是

"linters": {
    "eslint": {
        "selector": "text.html.vue, source.js - meta.attribute-with-value"
    }
}

对于Svelte的.svelte文件，使用eslint-plugin-svelte和Svelte语法高亮，它会是

"linters": {
    "eslint": {
        "selector": "text.html.svelte, source.js - meta.attribute-with-value"
    }
}

要获取特定文件类型的selector值，请将光标放置在文件开头，然后使用工具 ➡️ 开发者 ➡️ 显示作用域名称命令。

使用eslint_d

如果存在，此插件将自动优先选择eslint_d安装。您可以通过全局或按项目设置prefer_eslint_d为false来更改此行为。例如，对于全局设置

"linters": {
    "eslint": {
        "prefer_eslint_d": false
    }
}

设置

• SublimeLinter设置：http://sublimelinter.com/en/latest/settings.html
• Linter设置：http://sublimelinter.com/en/latest/linter_settings.html

您可以使用具有.eslintrc文件的命令行方式配置eslint选项。有关更多信息，请参阅eslint文档。

常见问题解答和故障排除

eslint不再lint我的HTML文件。

从本插件的v4.2版本开始，eslint将仅针对没有进一步插件的标准、纯配置的'*'.js文件进行linting。您可以将设置selector为旧值以恢复旧行为

"linters": {
    "eslint": {
        "selector": "source.js - meta.attribute-with-value"
    }
}

当我尝试使用本地安装的eslint时，在ST控制台出现“SublimeLinter: ERROR: eslint cannot locate 'eslint'”。

如果您在本地上安装了eslint，您必须有一个package.json文件。此外，重新启动项目或Sublime Text本身，以确保SublimeLinter使用正确的eslint实例。

npm init -f
npm install eslint

当我在编辑JavaScript文件时，出现“SublimeLinter: eslint ERROR: ESLint couldn't find a configuration file”。

如果您使用的是SublimeLinter 4，lint器试图始终lint当前视图，即使项目或文件没有ESLint设置。您可以通过在您的家目录中创建一个空的.eslintrc文件来轻松修复此错误。当没有本地定义的ESLint配置时，linter会找到此文件。

使用您首选的编辑器创建此配置文件，或通过终端执行此操作

cd $HOME # or cd %HOMEPATH% on Windows
touch .eslintrc
echo '{ "rules": {} }' > .eslintrc

我使用eslint_d并且linter突然停止工作

如果您使用eslint_d并且linter突然停止工作，并显示类似于“Error: ENOENT: no such file or directory, open /../eslint/node_modules/globals/index.js”的错误消息，重新启动eslint_d可能会解决这个问题

eslint_d restart