Skip to main content


¥Writing custom syntaxes

自定义语法是社区编写的 PostCSS 语法,用于支持其他样式语言,例如 SCSS 和容器,例如 HTML,使用 customSyntax 选项

¥Custom syntaxes are PostCSS syntaxes written by the community to support other styling languages, e.g. SCSS, and containers, e.g. HTML, using the customSyntax option.

要编写一个,请熟悉 PostCSS 的 如何编写自定义语法 指南。你可以使用 很棒的 Stylelint 中现有的自定义语法之一作为参考。

¥To write one, familiarize yourself with PostCSS's how to write custom syntax guide. You can use one of the existing custom syntaxes from Awesome Stylelint for reference.


¥For example:

import postcss from "postcss";

function parse(css, opts) {
const root = postcss.root();
// adding other nodes to root...
return root;

function stringify(node, builder) {
// just use the default stringifier
postcss.stringify(node, builder);

// or write custom stringifier...

export default { parse, stringify };


¥After publishing your custom syntax, we recommend creating a shared config that:

  • 延长 标准配置

    ¥extends the standard config

  • 打包你的自定义语法

    ¥bundles your custom syntax

  • 关闭任何不兼容的内置规则

    ¥turns off any incompatible built-in rules

所有内容都在 overrides 内,表示支持的文件扩展名。

¥All within an overrides for the supported file extensions.

例如,如果你要为名为 "foo" 的语言(使用文件扩展名 .foo)创建自定义语法,我们建议使用以下内容创建名为 "stylelint-config-standard-foo" 的共享配置:

¥For example, if you're creating a custom syntax for a language called "foo" (which uses the file extension .foo), we recommend creating a shared-config called "stylelint-config-standard-foo" with the following content:

import yourCustomSyntax from "postcss-your-custom-syntax";

export default {
overrides: [
files: ["*.foo", "**/*.foo"],
customSyntax: yourCustomSyntax,
extends: ["stylelint-config-standard"],
rules: {
"at-rule-no-unknown": null
// ..

我们建议在 PostCSS v7 不再流通之前要求使用自定义语法。

¥We recommended requiring the custom syntax until PostCSS v7 is no longer in circulation.