《replace命令行工具技术文档》

1. 安装指南

replace 是一个用于文件搜索和替换的命令行工具，与 sed 类似但存在一些差异。要使用该工具，首先需要安装 Node.js 和 npm。

安装步骤如下：

npm install replace -g

执行上述命令后，即可在命令行中使用 replace 和 search 命令。

2. 项目使用说明

本项目支持多种搜索和替换操作，以下是一些常见用法：

• 替换当前目录下所有文件中的 "foo" 为 "bar"：

replace 'foo' 'bar' *

• 递归替换当前目录下所有文件中的 "foo" 为 "bar"：

replace 'foo' 'bar' . -r

• 仅替换指定文件中的 "foo" 为 "bar"：

replace 'foo' 'bar' test/file1.js test/file2.js

• 替换所有包含下划线的单词对中间的 "_" 为 "-"：

replace '(\w+)_(\w+)' '$1-$2' *

• 仅在以 .js 结尾的文件中替换 "foo" 为 "bar"：

replace 'foo' 'bar' . -r --include="*.js"

• 排除以 .min.js 和 .py 结尾的文件进行替换：

replace 'foo' 'bar' . -r --exclude="*.min.js,*.py"

• 预览替换结果而不实际修改文件：

replace 'foo' 'bar' . -r --preview

• 查看所有可用选项：

replace -h

3. 项目API使用文档

本项目还支持在 JavaScript 程序中使用 replace：

var replace = require("replace");

replace({
  regex: "foo",
  replacement: "bar",
  paths: ['.'],
  recursive: true,
  silent: true,
});

4. 项目安装方式

请参考上文 "安装指南" 中的步骤，使用 npm 进行全局安装。

---

以上为本项目的技术文档，希望对您使用 replace 命令行工具有所帮助。