需启用toolkit.legacyUserProfileCustomizations.stylesheets为true，将userChrome.css置于配置文件夹的chrome子目录下，保存为UTF-8无BOM编码，插入测试CSS后彻底重启浏览器并检查控制台报错。
如果您已编写或下载了 userChrome.css 文件，但浏览器界面未发生任何变化，则很可能是由于火狐默认禁用用户样式表支持，或文件未放置在正确路径下。以下是使 userChrome.css 生效的完整操作流程：
一、启用 toolkit.legacyUserProfileCustomizations.stylesheets 选项
该首选项是火狐加载 userChrome.css 的开关，关闭状态下所有自定义 CSS 均被忽略，必须设为 true 才能激活样式解析能力。
1、在火狐地址栏输入 about:config 并回车，点击“接受风险并继续”。
2、在页面顶部搜索框中输入 toolkit.legacyUserProfileCustomizations.stylesheets。
立即学习“前端免费学习笔记（深入）”；
3、找到该条目后，双击其值列，由 false 改为 true。
二、准确定位并创建 chrome 文件夹与 userChrome.css 文件
userChrome.css 必须严格位于用户配置目录下的 chrome 子目录中，路径错误、大小写偏差或扩展名残留（如 .txt）均会导致加载失败。
1、在火狐地址栏输入 about:support，在“应用程序概要”区域找到“配置文件夹”，点击右侧“显示文件夹”按钮。
2、在打开的文件资源管理器窗口中，确认当前目录为以 .default-release 结尾的子文件夹（若存在多个，请优先选择修改日期最新的一个）。
3、在此目录下新建文件夹，命名为 chrome（全小写，无空格，无标点）。
4、进入 chrome 文件夹，新建文本文档，重命名为 userChrome.css；若系统隐藏扩展名，请在文件夹选项中启用“显示文件扩展名”，确保最终文件名不含 .txt。
三、验证 userChrome.css 内容格式与编码
文件内容需符合 CSS 语法规范，且必须保存为 UTF-8 编码（无 BOM），否则火狐将拒绝解析并静默跳过该文件。
1、用记事本、VS Code 或 Notepad++ 打开 userChrome.css 文件。
2、确认首行不含任何不可见字符（如 BOM 头），可使用编辑器“编码”菜单检查并转换为 UTF-8（无 BOM）。
3、插入一段最简测试代码，例如：
* { background-color: #ff0000 !important; }（此规则将使整个浏览器界面背景变为红色，用于快速验证生效状态）。
4、保存文件，关闭编辑器。
四、彻底重启火狐浏览器
火狐仅在启动时读取一次 userChrome.css，运行中修改文件不会自动刷新，且后台进程残留可能导致新样式不加载。
1、关闭所有火狐窗口，包括最小化到系统托盘的实例。
2、按 Ctrl+Shift+Esc 打开任务管理器，在“进程”页签中查找并结束所有名为 firefox.exe 的进程（Windows）或 Firefox（macOS/Linux）。
3、重新启动火狐浏览器，观察界面是否出现预期变化（如测试用红色背景）。
五、排查常见加载失败原因
即使上述步骤全部完成，仍可能因路径、权限或语法问题导致失效，需逐项验证。
1、检查配置目录权限：确保当前用户对 chrome 文件夹及 userChrome.css 具有 读取和执行 权限（Windows 右键属性 → 安全；macOS 使用 getfacl 或 Finder 显示简介）。
2、确认文件路径层级：必须为 Profiles/xxx.default-release/chrome/userChrome.css，不得多层嵌套或置于父级 Profiles 目录下。
3、检查控制台报错：在火狐中按 Ctrl+Shift+J 打开浏览器控制台，切换至“CSS”标签页，查看是否存在 userChrome.css failed to load 或类似警告信息。
