# chrome-page-find-replace

**Repository Path**: cc-2018_admin/chrome-page-find-replace

## Basic Information

- **Project Name**: chrome-page-find-replace
- **Description**: 一个支持网页正文与源码文本域高亮查找、大小写匹配和批量替换的 Chrome MV3 扩展。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chrome Page Find Replace

一个 Chrome MV3 浏览器扩展，用来在当前网页里做类似 VS Code 的查找替换：输入关键词后实时高亮匹配内容，并支持替换当前匹配或一键全部替换。

## 仓库信息建议

- 仓库名称：`chrome-page-find-replace`
- 仓库介绍：一个支持网页正文与源码文本域高亮查找、大小写匹配和批量替换的 Chrome MV3 扩展。

## 功能

- 实时高亮当前网页里的匹配文本。
- 支持普通网页正文内容搜索。
- 支持源码弹窗、普通 `textarea` 和常见单行文本输入框内容搜索。
- 支持区分大小写。
- 默认使用包含匹配。
- 支持整词匹配。
- 支持上一个、下一个、替换当前、全部替换。
- 支持通过扩展按钮打开，也支持默认快捷键 `Alt+Shift+F`。

## 安装

### 方式一：本地加载

1. 下载或克隆本仓库。
2. 打开 Chrome。
3. 访问 `chrome://extensions/`。
4. 打开右上角“开发者模式”。
5. 点击“加载已解压的扩展程序”。
6. 选择本仓库根目录。

### 方式二：修改后重新加载

如果已经加载过扩展，修改代码后需要：

1. 回到 `chrome://extensions/`。
2. 找到“页面查找替换”。
3. 点击“重新加载”。
4. 刷新正在使用扩展的网页。

## 使用

1. 打开任意普通网页。
2. 点击扩展图标，或按 `Alt+Shift+F` 打开查找替换面板。
3. 在“查找”输入框里输入关键词，页面会自动高亮匹配项。
4. 点击“上一个”或“下一个”切换当前匹配。
5. 需要区分大小写时，勾选“区分大小写”。
6. 需要只匹配完整单词时，勾选“整词匹配”。
7. 在“替换为”输入框里填写新文本。
8. 点击“替换当前”或“全部替换”执行替换。

## 适用场景

- 普通网页正文的临时查找替换。
- CMS 后台源码弹窗里的链接批量替换。
- 表单页里普通文本域内容的快速查找替换。

## 当前限制

- Chrome 原生 `Ctrl+F` 不能被扩展稳定接管，所以本扩展使用独立面板和可配置快捷键。
- 替换会直接修改当前页面 DOM 或当前输入区的值，刷新页面后普通网页正文会恢复原始内容。
- 不处理 `iframe`、Canvas、PDF、Chrome 内置页面。
- 富文本编辑器的可视化正文暂不处理；如果编辑器打开了“源代码”弹窗，通常会以 `textarea` 形式处理。
- `textarea` 的多处高亮通过覆盖层模拟，真实内容不会被插入高亮标签。

## 文件结构

```text
.
├── background.js
├── content.js
├── manifest.json
├── overlay.css
└── README.md
```

## 上传到 GitHub

如果你已经在 GitHub 新建了空仓库，可以在本仓库目录执行：

```bash
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin git@github.com:<你的用户名>/chrome-page-find-replace.git
git push -u origin main
```

如果使用 HTTPS 地址，把最后两行替换为 GitHub 页面给出的 HTTPS remote 地址即可。