# JavaScript 如何检测系统深色模式

URL: https://caijiao.org/how-to/javascript/prefers-color-scheme
Source: docs/how-to/javascript/prefers-color-scheme.md
Description: JavaScript 如何检测系统深色模式：用 prefers-color-scheme 媒体查询读取当前主题偏好。 示例可直接复制到浏览器或项目代码中，并附相关教程、工具入口。

## 快速答案

用 prefers-color-scheme 媒体查询读取当前主题偏好。

```js
const dark = matchMedia('(prefers-color-scheme: dark)').matches;
```

## 使用要点

- 先用最小数据跑通示例，再把字段名、选择器或函数名换成项目里的真实值。
- 接入后补一个失败分支，避免只覆盖演示中的成功路径。

## 相关内容

- [JavaScript / TypeScript 问题](/how-to/javascript/)
- [JavaScript 教程](/javascript/)
- [TypeScript 教程](/ts/)
- [JSON Formatter](/tool/json-formatter)
- [JSON Validator](/tool/json-validator)