本文介绍如何在 Manifest V3 下，确保扩展脚本在目标页面 JavaScript 执行前完成运行，从而可靠地初始化 window 变量——关键在于利用 Chrome 111+ 新增的 "world": "MAIN" 配置，使内容脚本直接运行于页面主上下文。
本文介绍如何在 manifest v3 下，确保扩展脚本在目标页面 javascript 执行前完成运行，从而可靠地初始化 `window` 变量——关键在于利用 chrome 111+ 新增的 `"world": "main"` 配置，使内容脚本直接运行于页面主上下文。
在 Chrome 扩展开发中，若需向网页注入全局变量（如 window.someVar = true）并确保其在网站自身脚本执行前就位，传统“动态创建 <script> 标签注入外部 JS”的方式往往失效。原因在于：即使内容脚本设置为 "run_at": "document_start"，其注入的 <script> 仍被浏览器视为<strong>延迟解析资源，实际执行时机晚于内联或已声明的页面脚本，导致变量初始化滞后，应用逻辑读取到 undefined。</script>
✅ 正确方案：使用 "world": "MAIN"
自 Chrome 111 起，Manifest V3 支持为内容脚本显式指定执行环境 "world": "MAIN"。该配置使脚本直接在页面的主 JavaScript 上下文（即 window 所属的 realm）中执行，而非默认隔离的沙箱环境。这意味着：
- 脚本在 DOM 构建初期（document_start 阶段）即运行；
- 可直接读写 window 对象，无需 DOM 操作或跨上下文通信；
- 执行时机严格早于任何 <script> 标签解析与执行（包括内联脚本），满足“先初始化、后使用”要求。</script>
示例：精简可靠的实现
manifest.json（关键修改：添加 "world": "MAIN"）
{
"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: MAIN-world script executed at document_start");
window.someVar = true;
window.API_CONFIG = { endpoint: "https://dev.api.example.com" };
// ✅ 此时所有后续页面脚本均可立即访问 window.someVar⚠️ 注意："world": "MAIN" 下的内容脚本*无法访问 `chrome.API**（如chrome.runtime.sendMessage、chrome.storage` 等），因其运行于页面上下文，无扩展权限。若需混合能力（如读取存储 + 初始化 window 变量），应采用双脚本协作模式：
- 隔离脚本（默认 world）：负责调用 chrome.* API，获取数据；
- MAIN 脚本（"world": "MAIN"）：接收数据并写入 window；
- 二者通过 window.postMessage 或 CustomEvent 安全通信（参考 SO 示例）。
? 关键总结
- 不要动态注入 <script></script>：document.createElement('script') 的执行受 HTML 解析器调度，无法保证早于页面 JS。
- 务必指定 "run_at": "document_start" + "world": "MAIN"：这是 Manifest V3 下唯一能稳定达成“页面 JS 前执行”的原生方案。
- 验证执行时机：在 content.js 中添加 console.log，并与页面脚本日志对比；推荐使用 Chrome DevTools 的 “Network → Disable cache” + “Rendering → Paint flashing” 辅助调试加载顺序。
- 兼容性注意：该特性要求 Chrome ≥ 111。如需支持旧版，需降级至 Manifest V2 或采用 document.write() 等高风险兜底方案（不推荐）。
通过合理配置执行环境，开发者可彻底规避注入时机竞态问题，以简洁、健壮的方式完成页面上下文预初始化任务。
