火狐中通过tampermonkey导入本地.user.js脚本有四种合规方式:一、手动复制粘贴代码至新建脚本;二、拖放文件至管理面板;三、临时加载含脚本的定制xpi包;四、启用about:config调试模式后直接打开本地文件。

如果您已在火狐浏览器中安装了 Tampermonkey(Greasemonkey 的现代平替插件),但尚未将本地保存的 .user.js 格式脚本导入运行,则需通过合规方式将脚本文件加载至管理器中。Greasemonkey 已停止维护,火狐自版本 78 起不再支持其新版安装,因此所有操作均基于 Tampermonkey 实现本地脚本导入。以下是多种可行的本地导入路径:
一、从本地 .user.js 文件手动导入
该方式适用于已下载或自行编写的用户脚本文件,无需联网访问脚本平台,全程离线完成,且能精确控制脚本内容与元数据完整性。
1、点击火狐浏览器右上角 Tampermonkey 橙色猴子图标,选择“管理面板”或直接在地址栏输入 about:debugging#/runtime/this-firefox 后点击左侧“Tampermonkey”进入脚本管理页。
2、在管理面板左上角点击“创建新脚本”,此时编辑器将打开一个空白 .user.js 模板。
3、全选并删除模板内容,将本地 .user.js 文件中的全部代码(含头部元数据块,如 // @name、// @match 等)复制粘贴至编辑器中。
4、点击编辑器右上角“文件”→“保存”,或使用快捷键 Ctrl+S(Windows/Linux)/Cmd+S(macOS)。
5、保存后脚本自动启用,状态栏图标旁将显示当前脚本数量,鼠标悬停可查看已启用脚本列表。
二、拖放 .user.js 文件至 Tampermonkey 管理面板
此方法利用浏览器原生拖放 API 实现零配置快速加载,仅需一次物理操作即可完成识别、解析与注册,适合批量导入多个脚本文件。
1、确保 Tampermonkey 已启用,并打开其管理面板(可通过右键工具栏图标 → “管理面板”,或地址栏输入 moz-extension://[ID]/options.html 并替换为实际扩展 ID)。
2、将本地存储的 .user.js 文件(例如 bilibili-ad-skip.user.js)直接拖拽至管理面板空白区域。
3、松开鼠标后,Tampermonkey 将自动读取文件头元数据,弹出确认窗口,显示脚本名称、匹配域名及请求权限。
4、核对 @match 域名是否符合预期(如 https://www.bilibili.com/*),确认无误后点击“安装”。
5、安装成功后,脚本立即出现在列表中,右侧开关默认为开启状态(蓝色)。
三、通过“从文件安装”功能加载已签名 XPI 包(含嵌入脚本)
该方式适用于将脚本与 Tampermonkey 打包为自定义 XPI 的高级场景,常用于企业内网分发或脚本预置部署,可绕过逐个导入步骤实现一键初始化。
1、使用第三方工具(如 web-ext)将 Tampermonkey 源码与目标 .user.js 文件合并构建为定制 XPI,其中脚本需置于 content_scripts 或通过 resources 注册。
2、在火狐地址栏输入 about:debugging#/runtime/this-firefox,点击“临时载入附加组件”按钮。
3、在文件选择对话框中定位并选中已构建的定制 XPI 文件(如 tampermonkey-plus-scripts.xpi)。
4、加载成功后,扩展列表中将出现新条目,其 ID 后缀包含“temp-id”,表示为临时加载模式。
5、刷新任意匹配域名页面,验证嵌入脚本是否按 @match 规则自动执行。
四、使用 about:config 强制启用本地脚本调试模式
此方法激活 Firefox 内置开发者脚本加载通道,允许 Tampermonkey 直接读取本地文件系统中的 .user.js,适用于开发测试阶段频繁修改脚本内容的场景。
1、在地址栏输入 about:config,回车后点击“接受风险并继续”。
2、搜索 devtools.chrome.enabled,双击将其值设为 true。
3、再搜索 security.fileuri.strict_origin_policy,双击设为 false。
4、重启浏览器,打开 Tampermonkey 管理面板,点击“创建新脚本”,在编辑器中使用 File → Open File 直接打开本地 .user.js 文件。
5、编辑器将完整载入文件内容,包括 BOM 头与注释行,保存后即生效。











