JavaScript 语言指南¶

linthis 使用 eslint 进行代码检查，使用 prettier 进行代码格式化。

支持的文件扩展名¶

.js
.jsx
.mjs
.cjs

必需工具¶

代码检查：eslint¶

# 全局安装
npm install -g eslint

# 或项目本地安装
npm install --save-dev eslint

# 验证安装
eslint --version

格式化：prettier¶

# 全局安装
npm install -g prettier

# 或项目本地安装
npm install --save-dev prettier

# 验证安装
prettier --version

配置¶

基本示例¶

# .linthis/config.toml

[javascript]
max_complexity = 15
excludes = ["dist/**", "node_modules/**", "*.min.js"]

禁用特定规则¶

[javascript.rules]
disable = [
    "no-console",
    "no-unused-vars",
    "no-undef"
]

自定义规则¶

[[rules.custom]]
code = "js/no-var"
pattern = "\\bvar\\s+"
message = "Use 'let' or 'const' instead of 'var'"
severity = "warning"
languages = ["javascript"]

[[rules.custom]]
code = "js/no-alert"
pattern = "\\balert\\s*\\("
message = "Avoid using alert()"
severity = "warning"
languages = ["javascript"]

CLI 用法¶

# 仅检查 JavaScript 文件
linthis -c --lang javascript

# 仅格式化 JavaScript 文件
linthis -f --lang javascript

ESLint 配置¶

创建 .eslintrc.json：

{
  "env": {
    "browser": true,
    "es2021": true,
    "node": true
  },
  "extends": "eslint:recommended",
  "parserOptions": {
    "ecmaVersion": "latest",
    "sourceType": "module"
  },
  "rules": {
    "no-unused-vars": "warn",
    "no-console": "off"
  }
}

常见问题¶

ESLint 未找到¶

Warning: No javascript linter available for javascript files
  Install: npm install -g eslint

压缩文件被检查¶

添加到排除项：

[javascript]
excludes = ["*.min.js", "dist/**", "build/**"]

最佳实践¶

使用 ES6+：在 ESLint 配置中启用现代 JavaScript 特性
与 TypeScript 一致：如果混合 JS/TS，使用相似的 ESLint 配置
JSX 支持：React 项目添加 "plugin:react/recommended" 到 extends