JavaScript replace() 使用方法

封面图 • 2025-11-02 • JavaScript

`JavaScript` 中的 `replace()` 方法用于在字符串中替换匹配的子字符串。它会返回一个**新字符串**，而不会修改原字符串（因为字符串是不可变的）。

---

## ✅ 语法

```javascript
str.replace(searchValue, replaceValue)
```

- `searchValue`: 要查找的字符串或正则表达式。
- `replaceValue`: 替换的内容（可以是字符串或函数）。

---

## 📌 示例说明

### 1. 简单字符串替换

```javascript
let str = "Hello world";
let newStr = str.replace("world", "JavaScript");
console.log(newStr); // 输出: "Hello JavaScript"
```

> 注意：默认情况下，`replace()` 只替换第一个匹配项。

---

### 2. 使用正则表达式替换所有匹配项

使用正则表达式时，加上 `/g` 标志可以全局替换：

```javascript
let str = "Hello world, hello everyone";
let newStr = str.replace(/hello/gi, "Hi");
console.log(newStr); // 输出: "Hi world, Hi everyone"
```

- `/g`：全局匹配
- `/i`：不区分大小写

---

### 3. 使用函数作为替换值

你可以将 `replaceValue` 设置为一个函数，该函数会在每次匹配时被调用：

```javascript
let str = "The price is $10 and $20";
let newStr = str.replace(/\$(\d+)/g, function(match, p1) {
    return "$" + (parseInt(p1) * 2);
});
console.log(newStr); // 输出: "The price is $20 and $40"
```

- `match` 是整个匹配的字符串（如 `$10`）
- `p1` 是第一个捕获组（如 `10`）

---

### 4. 替换多个匹配项（使用正则表达式）

```javascript
let str = "apple banana apple orange";
let newStr = str.replace(/apple/g, "fruit");
console.log(newStr); // 输出: "fruit banana fruit orange"
```

---

## ⚠️ 注意事项

- `replace()` **不会改变原始字符串**，而是返回一个新的字符串。
- 如果 `searchValue` 是字符串且没有找到匹配项，则返回原始字符串。
- 如果你希望替换所有匹配项，请务必使用带有 `/g` 标志的正则表达式。

---

## 🔍 总结

| 用法 | 示例 | 说明 |
|------|------|------|
| 字符串替换 | `str.replace("old", "new")` | 替换第一个匹配项 |
| 正则替换 | `str.replace(/old/g, "new")` | 全局替换 |
| 函数替换 | `str.replace(/(\d+)/g, func)` | 每次匹配调用函数 |

---

如果你有具体的例子或者想了解更复杂的用法（如捕获组、替换回调等），欢迎继续提问！