0

0

Sublime开发Chrome浏览器扩展程序_manifest.json配置与内容脚本编写

尼克

尼克

发布时间:2025-12-15 13:37:03

|

866人浏览过

|

来源于php中文网

原创

Sublime Text 可高效开发 Chrome 扩展,关键在于掌握 manifest.json(V3 必含 manifest_version、name、version、content_scripts)和内容脚本的沙箱机制;content.js 运行于网页 DOM 环境但隔离扩展上下文,需通过 chrome.runtime 通信,调试依赖 Chrome DevTools 的 Content Scripts 面板与 console.log 定位。

sublime开发chrome浏览器扩展程序_manifest.json配置与内容脚本编写

用 Sublime Text 开发 Chrome 扩展并不需要特殊插件,关键是理解 manifest.json 结构和内容脚本(content script)的加载逻辑。Sublime 只是高效编辑器,真正起作用的是 Chrome 的扩展机制。

manifest.json 必须字段与常见配置

manifest.json 是每个 Chrome 扩展的“身份证”,Chrome 加载扩展前会严格校验它。最低可用版本(Manifest V3)需包含以下字段:

  • manifest_version:必须为 3(V2 已废弃)
  • name:扩展名称,显示在 chrome://extensions 页面
  • version:语义化版本号,如 "1.0.0",每次更新必须升级
  • content_scripts:定义哪些 JS/CSS 在哪些页面注入,核心配置项

一个典型示例:

{
  "manifest_version": 3,
  "name": "我的高亮助手",
  "version": "1.0.0",
  "description": "自动高亮页面中的关键词",
  "permissions": ["activeTab"],
  "content_scripts": [{
    "matches": [""],
    "js": ["content.js"],
    "run_at": "document_idle"
  }]
}

注意:"" 表示匹配所有网页,生产环境建议精确到域名(如 "https://example.com/*"),更安全也更易调试。

内容脚本(content.js)编写要点

内容脚本运行在网页上下文中,能直接操作 DOM,但无法访问扩展后台页变量或直接调用 chrome.* API(除少数如 chrome.runtime)。常见误区:

Elser AI Comics
Elser AI Comics

一个免费且强大的AI漫画生成工具,助力你三步创作自己的一出好戏

下载
  • 不能直接使用 console.log 查看输出?错——它会出现在目标网页的 DevTools Console 中(选中对应 tab)
  • 不能访问页面已有的全局变量?对——内容脚本有独立执行环境,但可通过 document.createElement('script') 注入内联脚本间接通信
  • DOM 尚未加载就执行?用 run_at: "document_idle"(推荐)或监听 DOMContentLoaded

简单示例(content.js):高亮当前页所有 “Sublime” 文本

const highlights = document.body.innerHTML.match(/Sublime/gi);
if (highlights) {
  const re = /Sublime/gi;
  document.body.innerHTML = document.body.innerHTML.replace(re, 'Sublime');
}

Sublime 中提升开发效率的小技巧

虽无官方 Chrome 扩展插件,但可借助 Sublime 原生能力加速流程:

  • 安装 JSON Schema 插件 + Chrome Manifest V3 Schema,实现 manifest.json 字段自动补全与校验
  • SideBarEnhancements 右键快速刷新已加载的扩展(先在 chrome://extensions 开启开发者模式,再点击「重新加载」)
  • 设置自定义构建系统(Tools → Build System → New Build System),一键打开 Chrome 并加载扩展目录(需命令行参数 --load-extension=/path/to/your/ext

调试内容脚本的实用路径

不依赖外部工具也能高效定位问题:

  • content.js 开头加 console.log('content loaded', location.href);,确认是否注入成功
  • 打开目标网页 → F12 → 切换到「Sources」→ 左侧「Content Scripts」下找到你的 content.js,设断点调试
  • 检查「Application」→ 「Content Scripts」列表,确认匹配规则是否生效;若没出现,多半是 matches 写错或扩展未启用

基本上就这些。写好 manifest、理清 content script 的沙箱边界、配合 Chrome 自带工具调试,Sublime 完全胜任 Chrome 扩展开发。不复杂但容易忽略细节。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

75

2025.09.10

css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

524

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

263

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

758

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

539

2023.08.01

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
AngularJS教程
AngularJS教程

共24课时 | 2.8万人学习

C++教程
C++教程

共115课时 | 12.9万人学习

XML教程
XML教程

共142课时 | 5.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号