宙斯浏览器自定义JS脚本编写入门教程

打开宙斯浏览器想用脚本自动填表、关弹窗、给页面加点超能力，结果脚本没反应。控制台一片寂静，这种挫败感很常见。问题往往出在几个最容易被忽略的环节。按下面的步骤排查，基本能解决。

在宙斯浏览器中运行用户脚本，需要完成三个核心步骤：为脚本赋予合法身份、在正确时机注入页面、用工具挂载。听起来简单，但每个步骤都有关键细节。

确认JavaScript执行环境已启用

脚本无法执行的首要原因：浏览器默认禁用了第三方JavaScript。宙斯浏览器默认会限制第三方脚本，若不开启，后续所有操作均无效。

操作步骤如下三步：

1. 点击右上角菜单 → 设置 → 左侧栏“隐私与安全” → “网站设置” → “JavaScript”； 2. 将开关拨至开启状态，勾选【允许所有网站运行JavaScript】； 3. 关闭设置页后务必重启当前标签页。这一步是关键，否则新设置对已加载页面不生效。

创建第一个.user.js脚本文件

用户脚本必须使用.user.js扩展名，并在文件顶部包含完整的元数据声明块。这是Tampermonkey识别脚本作用域和权限的唯一凭证。缺少元数据，脚本无法运行。

方法一：手动编写基础模板

打开记事本，新建文件，将以下代码完整粘贴（注意每行冒号后保留一个空格，这会影响元数据解析）：

// ==UserScript==
// @name 我的第一个宙斯脚本
// @namespace http://zeus.browser/user-scripts
// @version 0.1
// @description 在页面标题前添加【已启动】标记
// @author You
// @match *://*/*
// @grant none
// ==/UserScript==

document.title = "【已启动】" + document.title;

2. 保存时选择UTF-8（无BOM）编码，文件名命名为hello-zeus.user.js。此时文件结构完整，即可导入Tampermonkey。

通过Tampermonkey导入并启用脚本

导入时需确保元数据块完整。许多新手导入后无反应，原因通常是元数据被编辑器自动格式化，或脚本默认被禁用。

第一步：确认Tampermonkey已安装并启用

在地址栏输入zeus://extensions并回车，检查右上角是否显示猴子图标。若没有，前往扩展中心搜索Tampermonkey并安装授权。

第二步：导入本地脚本文件

1. 点击工具栏猴子图标 → “创建新脚本”； 2. 全选编辑器默认模板内容并删除； 3. 将之前保存的hello-zeus.user.js文件内容（从// ==UserScript==开始）完整粘贴； 4. 按Ctrl+S保存，此时脚本名称会自动显示为“我的第一个宙斯脚本”，状态显示“启用”； 5. 打开任意网页，观察标签页标题。若出现【已启动】前缀，则脚本执行成功——这是最直观的验证方法。

调试脚本执行时机与DOM可用性

很多脚本语法无误却无效果，根本原因在于代码执行过早。DOM尚未构建完成时，querySelector等方法会返回null，导致脚本静默失效。

方法1：使用Tampermonkey内置的@run-at指令

在元数据块中添加一行：
// @run-at document-idle

该指令指示脚本在DOM树基本构建完成、图片等资源仍在后台加载时执行。既不影响速度，又能确保元素可访问，是实践中的首选方案。

方法2：手动封装DOMContentLoaded监听

if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', () => { /* 你的代码 */ });
} else {
/* 你的代码 */
}

这一步不可省略。在绝大多数动态渲染页面中，若不处理执行时机，脚本几乎必然失效。

验证脚本是否真正运行

仅凭视觉判断标题变化并不可靠。当脚本逻辑复杂时，视觉反馈不明显，容易误判。正确的做法是使用控制台日志验证脚本是否执行。

1. 在脚本末尾添加一行：console.log("脚本已执行，当前URL：" + location.href);

2. 刷新目标网页；

3. 按F12打开开发者工具，切换到Console标签页；

4. 若看到对应日志输出，则说明脚本的加载、解析、执行三个环节均正常；

5. 若日志未出现，检查猴子图标右下角是否有红色数字——那是错误提示，点击可定位语法问题或权限缺失。出错不可怕，知道错误位置就解决了问题的一半。

来源：互联网