必须同时安装SublimeLinter（主框架）和SublimeLinter-eslint（适配器），否则插件无反应；配置文件需放在项目根目录并确保Sublime以该目录为项目打开；自动修复需通过构建系统或JsPrettier实现，非插件原生支持。

ESLint 插件装了但没反应？检查 SublimeLinter 和 SublimeLinter-eslint 是否共存

Sublime 本身不运行 ESLint，靠 SublimeLinter 这个通用框架调度具体检查器。只装 SublimeLinter-eslint 是不够的，必须同时安装 SublimeLinter（主框架）和 SublimeLinter-eslint（ESLint 适配器）。常见错误是只搜 “eslint” 装了后者就以为完事，结果保存后零提示、无波浪线。

• 用 Package Control 安装时，明确搜索并安装两个包：SublimeLinter 和 SublimeLinter-eslint
• 装完重启 Sublime，打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 SublimeLinter: Toggle Linting 确保已启用
• 如果仍不工作，终端执行 which eslint，确认 ESLint 是全局可执行的；否则在 SublimeLinter 设置里手动指定 executable 路径

为什么改了 .eslintrc.js 没生效？路径和作用域决定配置加载逻辑

SublimeLinter-eslint 默认从当前文件所在目录向上查找最近的 .eslintrc.*，不是项目根目录，也不是用户主目录。如果你在 src/components/Button.js 编辑，它会依次查 src/components/.eslintrc.js → src/.eslintrc.js → /.eslintrc.js，找到第一个就停。

• 确保配置文件放在项目根目录（比如 /my-project/.eslintrc.json），且该目录是 Sublime 打开的文件夹（即 Project → Add Folder to Project）
• 避免用 eslintConfig 字段写在 package.json 里——SublimeLinter-eslint 不读这个
• 如果用了 extends: "eslint:recommended" 却报错，大概率是本地没装对应版本 ESLint 包（npm install eslint --save-dev），而不是 Sublime 配置问题

eslint --fix 在 Sublime 里怎么自动跑？别依赖插件“一键修复”按钮

SublimeLinter-eslint 默认只做检查、标红，不自动修复。所谓“保存时自动 fix”其实是靠 ESLint 自身的 --fix 能力 + Sublime 的构建系统或保存钩子实现的，不是插件原生功能。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 最稳的方式：用 Sublime Text Build System 配一个 ESLint Fix 构建，内容为：

  { "cmd": ["eslint", "--fix", "$file"], "selector": "source.js" }

• 或者更轻量：装 JsPrettier 插件（它支持调用 ESLint 的 --fix），但注意它默认优先走 Prettier，需在设置里关掉 auto_format_on_save 并显式启用 eslint_fix
• 别信某些教程说“改 SublimeLinter 设置里的 fix\_on\_save”，这个选项属于旧版 SublimeLinter 3，新版已移除，设了也无效

Windows 下路径空格或中文导致 ESLint 启动失败？看 SublimeLinter 控制台日志

Sublime 底部状态栏左下角点开 SublimeLinter 日志（或按 Ctrl+` 调出控制台），真实错误往往藏在这里。典型如：Error: spawn eslint ENOENT（找不到命令）或 Cannot find module 'eslint'（路径含空格/中文时 Node 解析失败）。

立即学习“Java免费学习笔记（深入）”；

• Windows 用户若全局安装了 ESLint，但路径含空格（如 C:\Program Files\nodejs\），建议用 npm install -g eslint 重装到不含空格路径（如 C:\node-global\），再在 SublimeLinter 用户设置里指定：

  "executable": ["C:/node-global/node_modules/.bin/eslint.cmd"]

• Mac/Linux 用户遇到 EACCES 权限错误，不是 Sublime 问题，是 npm 全局 bin 目录权限不对，用 sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules 修复
• 所有平台都建议关闭 SublimeLinter 的 delay（默认 0.25s），大文件编辑时容易误判为“卡死”而跳过检查

实际用起来最麻烦的从来不是装插件，而是 ESLint 本身是否在当前上下文里能被正确定位、加载配置、执行规则——Sublime 只是管道，别让它背锅。