油猴脚本使用JavaScript语言，由元数据块和主体代码组成，需定义@name、@namespace、@match等字段，通过@grant声明权限，@run-at控制执行时机，在沙箱环境中运行并可与页面通信。
如果您尝试开发或修改油猴脚本，但不清楚其语法基础和结构规范，可能会导致脚本无法正常注入或执行。以下是关于油猴脚本语言及其结构的详细说明：
本文运行环境：MacBook Pro，macOS Sonoma
一、油猴脚本使用的编程语言
油猴脚本本质上是运行在浏览器环境中的用户脚本，其核心语言为 JavaScript。该脚本通过浏览器扩展（如 Tampermonkey 或 Greasemonkey）加载，并在指定网页加载时自动执行。
JavaScript 是一种广泛用于前端开发的脚本语言，具备操作 DOM、监听事件、发送网络请求等能力。油猴脚本必须使用标准 JavaScript 语法编写，不支持其他编程语言直接运行。
二、油猴脚本的基本结构组成
一个合法的油猴脚本需包含元数据块（Metadata Block）和主体代码两部分。元数据块定义脚本的行为规则，如名称、匹配页面、权限等，由注释形式书写。
1、元数据以 // ==UserScript== 开始，以 // ==/UserScript== 结束。
2、在元数据中必须包含以下关键字段：@name（脚本名称）、@namespace（命名空间）、@match 或 @include（指定生效网址）。
3、可选字段包括 @description（描述）、@version（版本号）、@grant（权限声明）等。
三、常见的元数据指令说明
元数据指令控制脚本的运行条件和资源访问权限。正确配置这些指令可确保脚本在目标页面安全有效地执行。
1、使用 @match 指令精确匹配 URL，例如 https://example.com/*，支持通配符。
2、通过 @grant 声明所需特权，如需要调用 GM_xmlhttpRequest，则必须添加 @grant GM_xmlhttpRequest。
3、若脚本依赖外部库（如 jQuery），可通过 @require 引入，例如：// @require https://code.jquery.com/jquery-3.7.1.min.js。
四、油猴脚本的执行流程与作用域
油猴脚本在页面加载的不同阶段可选择性执行，开发者可通过配置控制脚本注入时机，并管理变量作用域以避免冲突。
1、使用 @run-at 指定执行时间点，常见值有 document-start、document-body、document-end。
2、脚本运行于独立沙箱环境中，默认情况下无法直接访问页面原始 JavaScript 变量。
3、若需与页面上下文交互，可通过 window.postMessage 或创建 script 标签动态注入代码实现通信。
