max-len

强制执行最大行长度

此规则在 ESLint v8.53.0 中已**弃用**。请在相应的规则中使用@stylistic/eslint-plugin-js。

任何语言中非常长的代码行都可能难以阅读。为了帮助提高可读性和可维护性，许多程序员已经制定了一种约定，将代码行限制为 X 个字符（传统上为 80 个字符）。

var foo = { "bar": "This is a bar.", "baz": { "qux": "This is a qux" }, "difficult": "to read" }; // very long
1

规则详情

此规则强制执行最大行长度以提高代码的可读性和可维护性。行的长度定义为行中 Unicode 字符的数量。

选项

此规则最多可以有两个数字作为位置参数（用于code和tabWidth选项），后跟一个对象选项（提供的位置参数具有优先级）

• "code"（默认值为80）强制执行最大行长度
• "tabWidth"（默认值为4）指定制表符字符的字符宽度
• "comments"强制执行注释的最大行长度；默认为code的值
• "ignorePattern"忽略与正则表达式匹配的行；只能匹配单行，并且在 YAML 或 JSON 中编写时需要双重转义
• "ignoreComments": true忽略所有尾随注释和单独一行的注释
• "ignoreTrailingComments": true仅忽略尾随注释
• "ignoreUrls": true忽略包含 URL 的行
• "ignoreStrings": true忽略包含双引号或单引号字符串的行
• "ignoreTemplateLiterals": true忽略包含模板字面量（template literal）的行
• "ignoreRegExpLiterals": true忽略包含正则表达式字面量（RegExp literal）的行

code

使用默认{ "code": 80 }选项时，此规则的**错误**代码示例

/*eslint max-len: ["error", { "code": 80 }]*/

var foo = { "bar": "This is a bar.", "baz": { "qux": "This is a qux" }, "difficult": "to read" };
1
2
3

使用默认{ "code": 80 }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "code": 80 }]*/

var foo = {
  "bar": "This is a bar.",
  "baz": { "qux": "This is a qux" },
  "easier": "to read"
};
1
2
3
4
5
6
7

tabWidth

使用默认{ "tabWidth": 4 }选项时，此规则的**错误**代码示例

/*eslint max-len: ["error", { "code": 80, "tabWidth": 4 }]*/

		var foo = { "bar": "This is a bar.", "baz": { "qux": "This is a qux" } };
1
2
3

使用默认{ "tabWidth": 4 }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "code": 80, "tabWidth": 4 }]*/

		var foo = {
				"bar": "This is a bar.",
				"baz": { "qux": "This is a qux" }
		};
1
2
3
4
5
6

comments

使用{ "comments": 65 }选项时，此规则的**错误**代码示例

/*eslint max-len: ["error", { "comments": 65 }]*/

/**
 * This is a comment that violates the maximum line length we have specified
**/
1
2
3
4
5

ignoreComments

使用{ "ignoreComments": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreComments": true }]*/

/**
 * This is a really really really really really really really really really long comment
**/
1
2
3
4
5

ignoreTrailingComments

使用{ "ignoreTrailingComments": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreTrailingComments": true }]*/

var foo = 'bar'; // This is a really really really really really really really long comment
1
2
3

ignoreUrls

使用{ "ignoreUrls": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreUrls": true }]*/

var url = 'https://www.example.com/really/really/really/really/really/really/really/long';
1
2
3

ignoreStrings

使用{ "ignoreStrings": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreStrings": true }]*/

var longString = 'this is a really really really really really long string!';
1
2
3

ignoreTemplateLiterals

使用{ "ignoreTemplateLiterals": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreTemplateLiterals": true }]*/

var longTemplateLiteral = `this is a really really really really really long template literal!`;
1
2
3

ignoreRegExpLiterals

使用{ "ignoreRegExpLiterals": true }选项时，此规则的**正确**代码示例

/*eslint max-len: ["error", { "ignoreRegExpLiterals": true }]*/

var longRegExpLiteral = /this is a really really really really really long regular expression!/;
1
2
3

ignorePattern

使用ignorePattern选项时，此规则的**正确**代码示例

/*eslint max-len:
["error", { "ignorePattern": "^\\s*var\\s.+=\\s*require\\s*\\(" }]*/

var dep = require('really/really/really/really/really/really/really/really/long/module');
1
2
3
4

相关规则

• 复杂度
• 最大深度
• 最大嵌套回调
• 最大参数
• 最大语句

版本

此规则在 ESLint v0.0.9 中引入。

资源

• 规则源代码
• 测试源代码