本文详解如何在 Manifest V3 下确保扩展脚本在网页自身 JavaScript 执行前注入并运行，利用 world: "MAIN" 机制直接操作全局 window 对象，规避传统动态注入时机过晚的问题。
本文详解如何在 manifest v3 下确保扩展脚本在网页自身 javascript 执行前注入并运行，利用 `world: "main"` 机制直接操作全局 `window` 对象，规避传统动态注入时机过晚的问题。
在 Chrome 扩展开发中，若需向网页注入初始化变量（如 window.someVar = true），关键在于执行时机——必须早于目标网站的任何脚本（包括 <script> 标签、内联脚本及模块加载）。Manifest V3 中，传统通过 document.createElement('script') 动态注入的方式存在固有延迟：即使 content script 设置为 "run_at": "document_start"，其本身仍运行在隔离的 <strong>Isolated World 中，而动态创建的 <script> 标签则在 <strong>Main World（即页面脚本所在环境）执行——但此时 HTML 解析可能已推进，导致网站 JS 先于注入脚本执行。</script>
✅ 正确解法：自 Chrome 111 起，Manifest V3 支持显式声明 "world": "MAIN"，使 content script 直接在页面主上下文中运行，从而实现真正意义上的“最早执行”。
配置步骤
- 移除冗余资源声明：删除 web_accessible_resources 和独立的 injected.js 文件；
- 修改 manifest.json：为 content script 添加 "world": "MAIN" 字段；
- 精简 content.js：直接编写需执行的全局赋值逻辑，无需 DOM 操作。
更新后的配置如下：
manifest.json
{
"name": "script-injector",
"manifest_version": 3,
"version": "0.0.1",
"content_scripts": [{
"matches": ["*://localhost:*/*", "*://127.0.0.1:*/*"],
"js": ["content.js"],
"run_at": "document_start",
"world": "MAIN"
}]
}content.js
console.log("CE: Script executed in MAIN world — before page JS");
window.someVar = true;
window.API_CONFIG = { endpoint: "https://dev.api.example.com" };
// ✅ 此时 window 已可被后续所有页面脚本访问⚠️ 重要注意事项
-
*`chrome.API 不可用**：运行在MAINworld 的脚本无法调用chrome.runtime,chrome.storage等扩展 API（会抛出ReferenceError`）。若需读取配置或发送消息，应采用双 content script 架构：
- Main-world script（world: "MAIN"）：仅负责初始化 window 变量；
- Isolated-world script（无 world 声明）：负责与扩展后台通信，通过 window.postMessage + CustomEvent 向 Main world 同步数据。
run_at: "document_start" 是必要前提：确保脚本在 DOM 构建初期介入，避免因 document_idle 或 document_end 导致时机失控。
兼容性提示：该特性要求 Chrome ≥ 111。可在 manifest.json 中添加 "minimum_chrome_version": "111" 明确声明。
总结
使用 "world": "MAIN" 是 Manifest V3 下实现「早于页面 JS 初始化全局变量」的官方、高效且简洁的方案。它消除了动态脚本注入的不确定性，将执行权交还给扩展开发者。对于需要混合能力（如既操作 window 又调用 chrome.*）的场景，推荐采用主从 content script 协作模式，并通过安全的跨 world 通信机制（如 postMessage + CustomEvent）桥接二者——这既符合安全沙箱设计，也保障了功能完整性。
