好的,这是一个非常常见的需求,被称为 "CSS Reset" 或 "Normalize"。目的是消除不同浏览器之间默认样式的差异,让你从一个干净、统一的起点开始编写样式。

在 SCSS 项目中,你可以选择几种不同的方法来实现。下面我将介绍三种最流行的方法,并告诉你如何在 electron-vite 项目中集成它们。


方法一:使用经典的 CSS Reset (简单粗暴)

这种方法的目标是移除几乎所有的浏览器默认样式(边距、填充、列表符号等),让你完全掌控。

1. 创建 Reset 文件

在你的样式文件夹 src/renderer/src/assets/styles/ 中,创建一个名为 _reset.scss 的文件。(下划线 _ 是 SCSS 的一个约定,表示这个文件是一个 "partial",只用于被导入,而不会单独编译成 CSS 文件)。

_reset.scss 代码: 这是一个非常流行且实用的 CSS Reset 代码段。

/* Box sizing rules */
*,
*::before,
*::after {
  box-sizing: border-box;
}

/* Remove default margin and padding */
body,
h1,
h2,
h3,
h4,
h5,
h6,
p,
figure,
blockquote,
dl,
dd,
ul,
ol,
pre {
  margin: 0;
  padding: 0;
}

/* Set core root defaults */
html:focus-within {
  scroll-behavior: smooth;
}

/* Set core body defaults */
body {
  min-height: 100vh;
  text-rendering: optimizeSpeed;
  line-height: 1.5;
}

/* Remove list styles on ul, ol elements */
ul,
ol {
  list-style: none;
}

/* Make images easier to work with */
img,
picture {
  max-width: 100%;
  display: block;
}

/* Inherit fonts for inputs and buttons */
input,
button,
textarea,
select {
  font: inherit;
}

/* Remove all animations and transitions for people that prefer not to see them */
@media (prefers-reduced-motion: reduce) {
  html:focus-within {
    scroll-behavior: auto;
  }
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
2. 在主 SCSS 文件中引入 Reset

打开你的主 SCSS 文件(例如 src/renderer/src/assets/styles/main.scss),在 文件的最顶部 导入 _reset.scss

main.scss 文件:

// 1. 必须首先导入 Reset 文件,以确保它最先生效
@import 'reset';

// 2. 导入你的全局变量(如果之前配置过)
@import 'variables';

// 3. 然后是你自己写的其他全局样式
body {
  font-family: 'Helvetica Neue', Arial, sans-serif;
  background-color: #f0f2f5;
  color: #333;
}

#app {
  // ... 你的应用样式
}

为什么顺序很重要? CSS 的规则是“后来者居上”。你必须先把默认样式清除掉,然后再应用你自己的新样式。所以 reset 必须在最前面。


方法二:使用 Normalize.css (现代推荐)

Normalize.css 不像 Reset 那样“暴力”地移除所有样式,而是致力于让所有浏览器的默认样式表现得 一致,并修复一些常见的浏览器 bug。这是目前更被推崇的做法。

1. 安装 Normalize.css
npm install normalize.css
2. 在主 SCSS 文件中引入

同样,在你的主 SCSS 文件 (main.scss) 的 最顶部 引入它。因为它是从 node_modules 安装的,所以可以直接用包名引入。

main.scss 文件:

// 1. 导入 Normalize.css
// ~ 符号告诉 Sass 在 node_modules 目录中查找
@import 'normalize.css/normalize.css';
// 或者,Vite 通常也支持直接写包名
// @import 'normalize.css';

// 2. 导入你的全局变量
@import 'variables';

// 3. 然后是你自己写的其他全局样式
body {
  // ...你的样式
}

// ...

提示:你也可以将 normalize.css 的内容复制到一个 _normalize.scss 文件中,然后像方法一那样 @import 'normalize';,效果是一样的,但通过 npm 安装和导入可以方便地进行版本管理和更新。


方法三:使用现代 CSS Reset (The New CSS Reset)

这是一个更新、更简洁的 Reset 方案,利用了现代 CSS 的一些新特性。

1. 创建 Reset 文件

创建 src/renderer/src/assets/styles/_reset.scss

_reset.scss 代码 (The New CSS Reset):

/*
  The New CSS Reset - v1.11.2
  https://www.joshwcomeau.com/css/custom-css-reset/
*/

/* Remove all the styles of the "User-Agent-Stylesheet", except for the 'display' property */
*:where(:not(iframe, canvas, img, svg, video, audio):not(svg *, symbol *)) {
  all: unset;
  display: revert;
}

/* Preferred box-sizing model */
*,
*::before,
*::after {
  box-sizing: border-box;
}

/* Reapply the pointer cursor for anchor tags */
a, button {
  cursor: revert;
}

/* Remove list styles (bullets/numbers) */
ol, ul, menu {
  list-style: none;
}

/* For images to not be able to exceed their container */
img {
  max-inline-size: 100%;
  max-block-size: 100%;
}

/* Removes spacing between cells in tables */
table {
  border-collapse: collapse;
}

/* Safari - solving issue with overlapping text */
p, h1, h2, h3, h4, h5, h6 {
  -webkit-hyphens: auto;
  hyphens: auto;
}

/* Revert back the spacing of headings */
h1, h2, h3, h4, h5, h6 {
  font-size: revert;
  font-weight: revert;
}

/* Revert inherit fonts for inputs and buttons */
input, textarea, select, button {
    font: revert;
}

/* Minimum textarea height */
textarea {
    min-height: 4rem;
}
2. 在主 SCSS 文件中引入

和方法一完全一样,在 main.scss 的顶部 @import 'reset';


总结与推荐

方法 优点 缺点 推荐场景
经典 Reset 提供一个完全空白的画布,控制力最强。 可能需要重新定义很多基础元素的样式(如标题 h1)。 设计系统或需要高度定制化 UI 的项目。
Normalize.css 保留有用的默认值,修复 bug,跨浏览器一致性好。 不会移除所有样式,可能有些默认样式你还是不想要。 绝大多数项目的首选,特别是内容型网站或标准应用。
现代 Reset 结合了 unset 等新特性,非常强大和简洁。 all: unset 可能对一些嵌入式第三方组件有未知影响。 适合喜欢尝试新技术、追求极致简洁的开发者。

对于大多数 electron-vite 项目,我推荐从 Normalize.css (方法二) 开始。它最稳妥,能帮你避免很多坑。如果你发现自己需要更多的控制权,再考虑使用 Reset 方法。

无论选择哪种,关键一步都是 在你的主样式文件的最顶端引入它

Logo

智能硬件社区聚焦AI智能硬件技术生态,汇聚嵌入式AI、物联网硬件开发者,打造交流分享平台,同步全国赛事资讯、开展 OPC 核心人才招募,助力技术落地与开发者成长。

更多推荐