content_scripts 的 css 字段必须是字符串数组，如["style.css"]；禁止单字符串、对象、绝对路径或跨根目录引用，路径须相对于manifest.json，且按顺序加载以控制样式覆盖。
content_scripts 的 css 字段必须是字符串数组
直接写 "css": "style.css" 会静默失败——Chrome 完全忽略该字段，既不报错也不注入。合法写法只有一种："css": ["style.css"]，哪怕只有一个文件也必须是数组。常见错误还包括用对象（{"file": "style.css"}）、绝对路径（["/css/style.css"]）或混合写法（["style.css", null]），这些都会导致 CSS 不加载。
路径必须相对于 manifest.json，且只能是本地文件
css 数组里的每个字符串，都是从 manifest.json 所在目录开始计算的相对路径。比如 manifest.json 在项目根目录，而 CSS 文件放在 src/css/main.css，那就要写 ["src/css/main.css"]。不能用协议前缀（https://）、不能用 Chrome API URL（如 chrome-extension://.../style.css）、也不能用 ../ 跨出扩展包根目录——后者会被 Chrome 拒绝加载，并在控制台报 Refused to load the stylesheet 错误。
注入时机不影响 CSS 生效，但影响样式是否被覆盖
CSS 注入本身不依赖 run_at 配置（该字段只对 js 有效），所有 CSS 总是在 DOM 构建早期、样式表解析阶段注入。但顺序很重要：css 数组内文件按顺序加载，后加载的样式会覆盖先加载的同名规则。如果你发现自定义样式没生效，大概率是被页面原有 CSS 的权重或加载顺序盖过了。这时可：
- 检查浏览器开发者工具的 Computed 面板，确认你的 CSS 是否被加载、是否被标记为
inactive - 在
css数组里把关键样式文件放最后 - 必要时加
!important（不推荐长期使用，但调试时有效） - 避免依赖 JS 动态插入
标签——这绕过 content script 隔离机制，反而容易被页面脚本干扰
Manifest V3 下没有例外，css 不能动态注入
和 JS 不同，chrome.scripting.insertCSS 只接受字符串或对象形式的样式规则，不支持传入本地 CSS 文件路径。如果你需要按条件加载不同 CSS，只能提前在 content_scripts 中声明多组配置，用不同的 matches 匹配规则区隔。例如：
{
"content_scripts": [
{
"matches": ["https://example.com/*"],
"css": ["css/example-theme.css"]
},
{
"matches": ["https://other-site.com/*"],
"css": ["css/other-theme.css"]
}
]
}
想运行时切换主题？得用 JS 操作 document.styleSheets 或增删 标签——但注意，这些操作发生在页面上下文，不再受 content script 的 DOM 隔离保护，变量冲突风险上升。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
