配置postcss.config.js（主要是tailwndcss）的规则到底是什么？

Question

用于展示如何配置

postcss.config.js

的变体数量非常令人困惑。有一些使用此的示例（例如

tailwindcss

文档中的示例）：

// Example 1:
module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
  },
}

还有那些需要库的：

// Example 2:
module.exports = {
  plugins: {
    require('tailwindcss'),
    require('postcss-preset-env')({
      stage: 0,
      'nesting-rules': true
    })
  },
}

其他人在配置之前需要外部库

module.exports

：

// Example 3:

const tailwindcss = require('tailwindcss');
const postcssPresetEnv = require('postcss-preset-env');


module.exports = {
  plugins: {
    tailwindcss,
    postcssPresetEnv
  },
}

当必须合并未根据默认值命名的配置文件时，还有更多必要的内容。

今天，当使用 postcss.config.js 运行

yarn dev

时，我收到此错误，如示例 2 所示：

Syntax Error: /[path]/_pod-test/postcss.config.js:3
    require('tailwindcss'),
             ^^^^^^^^^^^

SyntaxError: Unexpected string

当我删除带有“tailwindcss”的行时，“postcss-preset-env”也会发生同样的情况：

Syntax Error: /Volumes/_III_/Z_WWW/_ZZZ PoD/_pod-test/postcss.config.js:3
    require('postcss-preset-env')({
            ^^^^^^^^^^^^^^^^^^^^

SyntaxError: Unexpected string

当我切换到示例 1 中所示的设置时，我收到此错误：

Syntax Error: Error: PostCSS plugin tailwindcss requires PostCSS 8.
Migration guide for end-users:
https://github.com/postcss/postcss/wiki/PostCSS-8-for-end-users

我使用 postcss 8.3.9！

这一切都发生在一个使用

vue-cli

设置为 Vue2 项目的项目中。

我必须应用哪种巫术才能使此设置生效？

Answer 1

我发布的示例 1 和 2 之间有一个微妙但非常重要的区别。

示例2实际上是错误的！

示例 1 使用 objects 来配置插件的参数，而第二个示例则使用函数调用。这些必须放在 ARRAY 中（意思是：用方括号代替大括号）。

这将是示例 2 的正确版本：

// Example 2 fixed:

module.exports = {
  plugins: [  // <= here we MUST use brackets!
    ... [function calls] ...
  ],
}

我还没有测试示例 3 是否也是如此（但我假设是这样）。

希望这对某人有帮助！

Answer 2

在

package.json

我有：

  "postcss": {
    "plugins": [
      "postcss-import",
      "tailwindcss",
      "postcss-preset-env",
      "autoprefixer",
      "cssnano"
    ]
  }

这是我的完整生产设置。我有顺风

3.0.23

，但它可能适用于任何版本。

如果您使用

cssnano

，则无需为

tailwindcss/nesting

设置

postcss-preset-env

，这是 tailwind 在其文档中推荐的：https://tailwindcss.com/docs/using-with-preprocessors#nesting

为什么？因为

cssnano

合并了它们都产生的重复代码。 Tailwind 团队成员之一推荐了使用

cssnano

的解决方法：https://github.com/tailwindlabs/tailwindcss/issues/4634#issuecomment-861392246

Answer 3

在终端中运行以下命令以通过 npm 安装 tailwind css 及其依赖项。

npm install tailwindcss postcss autoprefixer

当您尝试运行项目时，可能会收到您提到的错误消息

Error: PostCSS plugin tailwindcss requires PostCSS 8.

运行以下代码卸载以前的安装并修复错误

npm uninstall tailwindcss postcss autoprefixer 
npm install tailwindcss@npm:@tailwindcss/postcss7-compat@tailwindcss/postcss7-compat postcss@^7 autoprefixer@^9

接下来，您需要生成 Tailwind 和 PostCSS 配置文件

npx tailwindcss init -p

你的配置文件应该是这样的

postcss.config 文件

module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
  },
};

tailwindcss.config 文件

module.exports = {
  future: {
    // removeDeprecatedGapUtilities: true,
    // purgeLayersByDefault: true,
  },
  purge: [],
  theme: {
    extend: {},
  },
  variants: {},
  plugins: [],
};

最后，打开 main.js 文件并导入包含 tailwind 指令的 tailwind.css 文件，即

import './css/tailwind.css'

Answer 4

对我来说这个配置可以正确运行：

// Example 3:

const tailwindcss = require('tailwindcss');
const postcssPresetEnv = require('postcss-preset-env');


module.exports = {
  plugins: {
    tailwindcss,
    postcssPresetEnv
  },
}

以及此版本的库：

"postcss": "^8.4.6",
"postcss-cli": "^9.1.0",
"tailwindcss": "^3.0.18",

我此时不会尝试 postcss 的所有功能，但 CLI 中的基本流程文件可以正确运行...

Answer 5

我还没有找到任何指定配置文件格式的官方文档。不过，我们可以参考 postcss-loader 文档，其中提到了几种可能的格式。