Ubuntu系统下apt安装的ESLint项目初始化及文档咨询

兄弟，我太懂你想用apt装ESLint图省事的心态了，但Ubuntu软件仓库里的ESLint版本往往偏旧，和官方最新的交互式初始化流程不兼容，这才会出现你碰到的Promise未处理报错问题。下面给你一步步解决这些问题：

一、手动初始化apt安装的ESLint项目 #

既然eslint --init交互式命令报错，咱们直接手动创建配置文件就行，步骤很简单：

1. 先进入你的项目目录，如果还没初始化npm项目，先跑：npm init -y（生成基础的package.json，方便后续管理）
2. 创建ESLint的核心配置文件.eslintrc.js，可以先写个基础版的配置，后续按需调整：

   module.exports = {
     // 指定代码运行的环境，避免对浏览器/Node环境的API报错
     env: {
       browser: true,
       es2021: true,
       node: true
     },
     // 启用ESLint推荐的基础规则集
     extends: 'eslint:recommended',
     // 指定JS语法版本
     parserOptions: {
       ecmaVersion: 'latest'
     },
     // 自定义规则，比如禁止console输出、缩进要求等
     rules: {
       'no-console': 'warn',
       'indent': ['error', 2]
     }
   };
   

3. 创建.eslintignore文件，用来告诉ESLint忽略哪些不需要检查的文件/目录：

   node_modules/
   dist/
   build/
   *.config.js
   

4. 测试一下配置是否生效：随便写个有问题的JS文件，比如test.js，然后跑eslint test.js，如果能正常输出规则提示，就说明配置成功了。

二、让官方文档适配你的apt版本ESLint #

apt装的ESLint版本一般是v7.x甚至更早，而现在ESLint官方文档默认是最新的v8+版本，很多功能和初始化流程都不一样，所以直接看会踩坑：

• 首先用eslint -v查清楚你本地安装的具体版本号，比如v7.32.0
• 去ESLint官方文档里找到版本切换入口，选择和你本地一致的版本，这样文档里的初始化步骤、规则配置、API说明就完全适配你的环境了，不会出现照着做却报错的情况。

如果你实在想完全跟着最新官方文档走，其实更推荐在项目里用npm本地安装ESLint（npm install eslint --save-dev），然后用npx eslint --init，这样就能避开apt版本老旧的问题，直接用官方最新的流程。

三、适配apt版本的文档选择 #

• 最靠谱的还是对应版本的ESLint官方文档，毕竟规则和配置项在不同版本里变化挺大，官方文档是最权威的参考。
• 你也可以参考Ubuntu官方的软件包说明文档，但内容比较简略，主要是安装卸载相关的，配置细节还是得看ESLint的版本专属文档。

备注：内容来源于stack exchange，提问作者DannyNiu