userscript元数据块中规则的顺序是否影响脚本行为？userscript元数据块（metadata block）中的注释指令顺序通常不影响解析结果，但`@require`等依赖性指令必须按执行依赖顺序排列，其余字段如`@name`、`@namespace`等顺序可自由调整。
在编写 Userscript（如通过 Tampermonkey、Violentmonkey、FireMonkey 或 Greasemonkey 运行）时，元数据块（即以 // @xxx 开头的注释区域）用于向用户脚本管理器声明脚本信息与运行要求。虽然这些行在 JavaScript 中本质上是普通单行注释，不会被 JS 引擎执行，但脚本管理器会专门解析它们，并据此配置运行环境。
✅ 绝大多数元数据字段顺序无关紧要：
例如以下两种写法完全等效，管理器均可正确识别：
// ==UserScript== // @name My Awesome Script // @namespace https://example.com // @version 1.0.0 // @description Adds dark mode toggle to GitHub // @author Alice // @match https://github.com/* // ==/UserScript==
与：
// ==UserScript== // @namespace https://example.com // @author Alice // @name My Awesome Script // @version 1.0.0 // @description Adds dark mode toggle to GitHub // @match https://github.com/* // ==/UserScript==
⚠️ 唯一关键例外：@require（及部分扩展指令）
@require 用于加载外部 JS 库（如 jQuery、Lodash），其加载顺序直接影响执行时的依赖关系。例如：
// @require https://code.jquery.com/jquery-3.6.0.min.js // @require https://cdn.jsdelivr.net/npm/moment@2.29.4/moment.min.js // @require ./my-utils.js
若 my-utils.js 内部依赖 moment，则 moment 必须在 my-utils.js 之前声明；否则运行时将报 ReferenceError: moment is not defined。FireMonkey 明确按顺序加载 @require 脚本，Tampermonkey 和 Violentmonkey 同样遵循该约定。
? 其他需注意的边界情况：
- @grant 指令虽无顺序依赖，但重复声明会被忽略（仅首次有效）；
- @run-at 与 @match / @include 的组合逻辑由管理器内部规则决定，与书写顺序无关；
- 某些旧版 Greasemonkey（v3.x）对 @updateURL 解析较敏感，建议置于靠前位置以提升更新检测稳定性（非强制，属最佳实践）。
? 推荐实践：
为提升可维护性与团队协作一致性，建议采用标准化顺序（如 Violentmonkey 官方示例 推荐）：
@name @namespace @version @description @author @match / @include / @exclude @run-at @require @resource @grant @updateURL @downloadURL
总结：元数据块不是普通代码，但也不是完全“自由排列”——它是一份被解析的配置契约。除 @require 等显式有序指令外，其余字段顺序纯属风格偏好；然而统一格式能显著降低协作成本，并避免未来因管理器升级引入的潜在解析差异。
