如何3分钟上手vite-vue3-chrome-extension-v3?从安装到第一个扩展的完整指南 📅 2026/6/24 6:26:25 如何3分钟上手vite-vue3-chrome-extension-v3从安装到第一个扩展的完整指南【免费下载链接】vite-vue3-chrome-extension-v3Another vite powered web extension (chrome, firefox, etc.) starter template.项目地址: https://gitcode.com/gh_mirrors/vi/vite-vue3-chrome-extension-v3想要快速构建现代化的Chrome扩展吗vite-vue3-chrome-extension-v3 是一个基于 Vite 和 Vue 3 的浏览器扩展开发模板专为 Manifest V3 设计让你在3分钟内就能开始创建功能丰富的浏览器扩展。这个终极开发模板集成了现代前端技术栈提供完整的开发体验支持 Chrome、Firefox 和 Edge 等主流浏览器。 为什么选择这个模板vite-vue3-chrome-extension-v3 是一个完整的浏览器扩展开发解决方案它解决了传统扩展开发中的诸多痛点现代化技术栈基于 Vue 3 Composition API TypeScript Vite 构建多上下文支持原生支持背景脚本、弹出窗口、选项页面、内容脚本等多种扩展组件开箱即用内置国际化、状态管理、UI组件库等企业级功能开发体验优秀支持热重载、类型检查、代码格式化等现代开发工具 快速安装步骤第一步克隆项目模板git clone https://gitcode.com/gh_mirrors/vi/vite-vue3-chrome-extension-v3 my-extension cd my-extension npm install第二步启动开发服务器启动 Chrome 扩展开发环境npm run dev:chrome或者同时支持 Chrome 和 Firefoxnpm run dev第三步加载扩展到浏览器Chrome/Edge 用户打开chrome://extensions启用右上角的开发者模式点击加载已解压的扩展程序选择项目中的dist/chrome文件夹Firefox 用户打开about:debugging#/runtime/this-firefox点击加载临时附加组件选择dist/firefox文件夹中的任意文件️ 项目结构解析vite-vue3-chrome-extension-v3 采用清晰的项目结构让开发更加直观src/ ├── background/ # 背景脚本服务工作者 ├── components/ # 共享Vue组件 ├── composables/ # Vue组合式函数 ├── content-script/ # 内容脚本 ├── ui/ # 用户界面入口 │ ├── action-popup/ # 弹出窗口界面 │ ├── options-page/ # 选项页面 │ ├── side-panel/ # 侧边栏面板 │ └── */pages/ # 基于文件的路由页面 ├── stores/ # Pinia状态管理 └── utils/ # 工具函数✨ 核心功能特性多上下文架构设计这个模板支持浏览器扩展的所有上下文类型包括背景脚本(src/background/index.ts)处理扩展的生命周期和后台任务弹出窗口(src/ui/action-popup/)用户点击扩展图标时显示的界面选项页面(src/ui/options-page/)扩展的设置页面内容脚本(src/content-script/)注入到网页中的脚本开发者工具面板(src/ui/devtools-panel/)Chrome开发者工具中的面板基于文件的自动路由项目采用创新的文件路由系统只需在src/ui/*/pages/目录下创建.vue文件即可自动生成路由!-- src/ui/action-popup/pages/about.vue -- template div关于页面/div /template完整的现代化UI组件内置了完整的UI组件库包括Nuxt/UI v3现代化的UI组件Tailwind CSS 4实用的CSS框架Lucide图标精美的图标库暗色/亮色主题完整的主题支持国际化支持项目内置了多语言支持配置文件位于 src/locales/支持中文和英文// src/locales/zh.json { welcome: 欢迎使用扩展, settings: 设置 }️ 创建你的第一个扩展1. 修改扩展信息编辑 manifest.config.ts 文件配置你的扩展信息export default defineManifestConfig({ name: 我的第一个扩展, description: 一个基于Vite和Vue 3的浏览器扩展, version: 1.0.0, // ... 其他配置 })2. 添加新页面在src/ui/action-popup/pages/目录下创建新页面!-- src/ui/action-popup/pages/my-page.vue -- template div classp-4 h1 classtext-2xl font-bold我的页面/h1 p这是我的第一个扩展页面/p /div /template3. 添加背景脚本功能编辑 src/background/index.ts 添加后台逻辑// 监听扩展安装事件 chrome.runtime.onInstalled.addListener(() { console.log(扩展已安装) })4. 构建和发布完成开发后构建生产版本npm run build:chrome生成的扩展文件位于dist/chrome目录可以直接打包发布到 Chrome 应用商店。 开发工具和命令vite-vue3-chrome-extension-v3 提供了一系列开发命令命令描述npm run dev同时启动 Chrome 和 Firefox 开发环境npm run dev:chrome仅启动 Chrome 开发环境npm run build构建 Chrome 和 Firefox 版本npm run lint代码检查和自动修复npm run typecheckTypeScript 类型检查npm run format代码格式化 最佳实践建议状态管理最佳实践使用 Pinia 进行状态管理配置文件位于 src/stores/// src/stores/counter.store.ts export const useCounterStore defineStore(counter, () { const count ref(0) const increment () count.value return { count, increment } })跨上下文通信使用webext-bridge进行不同扩展上下文之间的通信// 发送消息 import { sendMessage } from webext-bridge await sendMessage(message-type, { data: hello })浏览器存储操作使用内置的组合式函数进行浏览器存储操作import { useBrowserStorage } from /composables/useBrowserStorage const storage useBrowserStorage() await storage.set(key, value) 进阶功能探索内容脚本开发内容脚本可以直接操作网页DOM配置文件位于 src/content-script/index.ts// 注入样式 import ./index.css // 操作页面元素 document.body.style.backgroundColor #f0f0f0侧边栏面板开发侧边栏是 Manifest V3 的新特性项目已完整支持!-- src/ui/side-panel/pages/dashboard.vue -- template div侧边栏仪表板/div /template开发者工具集成创建自定义的开发者工具面板// src/devtools/index.ts chrome.devtools.panels.create( 我的面板, icon.png, devtools-panel.html ) 学习资源官方文档详细的技术文档位于 docs/DEVELOPMENT.md包含项目架构设计文件夹结构说明编码规范最佳实践指南类型安全支持项目使用 TypeScript 提供完整的类型安全类型定义位于 src/types/。社区支持虽然项目本身不包含外部链接但基于 Vue 3 和 Vite 的丰富生态系统你可以轻松找到相关资源Vue 3 官方文档Vite 官方文档Chrome 扩展开发文档 总结vite-vue3-chrome-extension-v3 是一个功能完整、现代化的浏览器扩展开发模板。通过这个指南你已经学会了快速安装3分钟完成环境搭建项目结构理解多上下文架构设计核心功能掌握文件路由、状态管理等关键特性开发流程从创建页面到构建发布的完整流程无论你是要开发简单的工具扩展还是复杂的企业级应用这个模板都能为你提供坚实的基础。现在就开始使用 vite-vue3-chrome-extension-v3 创建你的第一个浏览器扩展吧记住浏览器扩展开发的关键在于理解不同上下文的工作方式而这个模板已经为你处理了所有的复杂性让你可以专注于业务逻辑的实现。扩展开发小贴士始终在开发过程中测试不同浏览器的兼容性使用npm run dev同时启动多个浏览器环境进行测试确保你的扩展在所有目标浏览器上都能完美运行【免费下载链接】vite-vue3-chrome-extension-v3Another vite powered web extension (chrome, firefox, etc.) starter template.项目地址: https://gitcode.com/gh_mirrors/vi/vite-vue3-chrome-extension-v3创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考