用 Webpack 打包 CSS 時發現一個怪現象:打包後的 z-index 值與原始檔不一致。
如下圖,左側是原始檔,右側是打包後的結果:

更奇怪的是,即使加上 !important,經過 OptimizeCssAssetsPlugin 呼叫 cssnano 處理之後,最終仍然變成 z-index: 2。
由此推斷,是 cssnano 執行了重新計算(cssnano 稱之為 rebase),而這個計算並不夠準確。

因為打包後的檔案裡有兩處 z-index,圖中這段是第二處,所以被改寫成 2。
cssnano 把 z-index rebase 歸類為 unsafe 而非 bug。它的邏輯是:只有在「整個網站的 CSS 全部寫在同一個檔案、且不透過 JavaScript 動態改動」的前提下,這個最佳化才安全。
參考:https://cssnano.co/optimisations/zindex/
而本專案抽出了共用的 CSS,layout 的 z-index 本來就設得很小,於是正好撞上這個假設,被重新計算後打亂了層級關係。
由於 cssnano 預設就會進行 z-index rebase,關掉它才是正確做法。把 safe 選項打開即可跳過這類帶有潛在風險的最佳化:
new OptimizeCssAssetsPlugin({
cssProcessor: require('cssnano'),
cssProcessorOptions: {
discardComments: {removeAll: true},
// 避免 cssnano 重新計算 z-index
safe: true
},
canPrint: false
})
這類問題的排查線索其實很清楚:值被改動、加上 !important 也無效,就該往「後製工具改寫」的方向查,而不是繼續在樣式規則上打轉。凡是被工具標記為 unsafe 的最佳化項目,在多檔拆分或 JS 動態操作樣式的專案中,都建議明確關閉。