> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQL 字符串函数

> MySQL 字符串函数参考指南：CONCAT、SUBSTRING、TRIM、REPLACE、UPPER、LOWER、LENGTH、LIKE、REGEXP、FORMAT，以及常见的字符串处理模式。

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

MySQL 的字符串函数涵盖文本的拆分、拼接、搜索、格式化和比较。大多数函数遵循相同的约定：从 1 开始的索引、NULL 传播（任何 NULL 参数都返回 NULL），以及默认不区分大小写的比较。

## 拼接与拆分

**CONCAT**：把多个字符串连接在一起：

```sql theme={null}
SELECT CONCAT(first_name, ' ', last_name) AS full_name FROM users;

-- CONCAT_WS: join with a separator, skipping NULLs
SELECT CONCAT_WS(', ', city, state, country) AS address FROM locations;
```

`CONCAT` 的参数中只要有一个为 NULL，结果就是 NULL。`CONCAT_WS` 会跳过 NULL 值，但会为非 NULL 的值保留分隔符。

**SUBSTRING / SUBSTR / MID**：提取字符串的一部分：

```sql theme={null}
-- SUBSTRING(string, start, length)  — 1-based indexing
SELECT SUBSTRING('Hello, World!', 1, 5);   -- 'Hello'
SELECT SUBSTRING('Hello, World!', 8);      -- 'World!'  (to end of string)
SELECT SUBSTRING('Hello, World!', -6);     -- 'World!'  (from the right)
```

**SUBSTRING\_INDEX**：按分隔符拆分：

```sql theme={null}
-- Get everything before the second comma
SELECT SUBSTRING_INDEX('a,b,c,d', ',', 2);   -- 'a,b'

-- Get everything after the last dot (domain from email)
SELECT SUBSTRING_INDEX('user@example.com', '@', -1);  -- 'example.com'
```

## 在字符串中搜索

**LOCATE / POSITION / INSTR**：查找子字符串：

```sql theme={null}
SELECT LOCATE('World', 'Hello, World!');       -- 8  (1-based position)
SELECT LOCATE('world', 'Hello, World!');       -- 8  (case-insensitive by default)
SELECT LOCATE('xyz', 'Hello, World!');         -- 0  (not found)

-- LOCATE with start position
SELECT LOCATE('o', 'Hello, World!', 6);        -- 9  (skips first 'o')
```

**LIKE**：使用通配符进行模式匹配：

```sql theme={null}
-- % matches zero or more characters, _ matches exactly one
SELECT * FROM products WHERE name LIKE 'Widget%';       -- starts with Widget
SELECT * FROM products WHERE name LIKE '%Pro%';         -- contains Pro
SELECT * FROM products WHERE code LIKE 'SKU-___-2024';  -- three chars in middle
```

**REGEXP / RLIKE**：正则表达式匹配：

```sql theme={null}
SELECT * FROM users WHERE email REGEXP '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$';
SELECT * FROM products WHERE name REGEXP 'Pro|Plus|Max';
```

`REGEXP` 使用 POSIX 正则表达式语法。如需函数形式，请使用 `REGEXP_LIKE()`（MySQL 8.0 及以上版本）。

## 修改字符串

**REPLACE**：替换子字符串的所有出现位置：

```sql theme={null}
SELECT REPLACE('Hello, World!', 'World', 'MySQL');  -- 'Hello, MySQL!'
UPDATE articles SET content = REPLACE(content, 'old_term', 'new_term');
```

**TRIM / LTRIM / RTRIM**：去除空白或指定字符：

```sql theme={null}
SELECT TRIM('  hello  ');                    -- 'hello'
SELECT TRIM(LEADING '0' FROM '007');         -- '7'
SELECT TRIM(BOTH 'x' FROM 'xxhelloxx');      -- 'hello'
```

**UPPER / LOWER**：转换大小写：

```sql theme={null}
SELECT UPPER('hello');   -- 'HELLO'
SELECT LOWER('HELLO');   -- 'hello'
```

**LPAD / RPAD**：填充到固定长度：

```sql theme={null}
SELECT LPAD('42', 6, '0');    -- '000042'
SELECT RPAD('hello', 10, '.');  -- 'hello.....'
```

**REPEAT**：将字符串重复 N 次：

```sql theme={null}
SELECT REPEAT('ab', 3);   -- 'ababab'
```

**REVERSE**：反转字符串：

```sql theme={null}
SELECT REVERSE('hello');  -- 'olleh'
```

## 长度与比较

MySQL 有两个长度函数，对多字节字符会产生不同的结果：

| 函数 | 度量内容 |
| :- | :- |
| `LENGTH(s)` | 字节长度 |
| `CHAR_LENGTH(s)` / `CHARACTER_LENGTH(s)` | 字符长度 |

```sql theme={null}
SELECT LENGTH('café');      -- 5  (the é is 2 bytes in UTF-8)
SELECT CHAR_LENGTH('café'); -- 4  (4 characters)
```

当您关心的是字符数而不是字节数时，请始终使用 `CHAR_LENGTH`。

**STRCMP**：比较两个字符串，返回 -1、0 或 1：

```sql theme={null}
SELECT STRCMP('abc', 'abc');   -- 0
SELECT STRCMP('abc', 'abd');   -- -1
SELECT STRCMP('abd', 'abc');   -- 1
```

## 格式化

**FORMAT**：用千位分隔符格式化数字：

```sql theme={null}
SELECT FORMAT(1234567.891, 2);    -- '1,234,567.89'
SELECT FORMAT(1234567.891, 2, 'de_DE');  -- '1.234.567,89'  (German locale)
```

**LEFT / RIGHT**：从开头或结尾取 N 个字符：

```sql theme={null}
SELECT LEFT('Hello, World!', 5);   -- 'Hello'
SELECT RIGHT('Hello, World!', 6);  -- 'World!'
```

## 常见模式

从电子邮件地址中提取域名：

```sql theme={null}
SELECT SUBSTRING_INDEX(email, '@', -1) AS domain FROM users;
```

截断长字符串以便显示：

```sql theme={null}
SELECT CASE
    WHEN CHAR_LENGTH(description) > 100
    THEN CONCAT(LEFT(description, 97), '...')
    ELSE description
END AS short_description
FROM products;
```

规范化空白字符：

```sql theme={null}
UPDATE users SET name = TRIM(REGEXP_REPLACE(name, '\\s+', ' '));
```

## 常见问题

#### MySQL 的字符串比较区分大小写吗？

默认不区分。字符串比较使用列的排序规则，而大多数常用的排序规则都不区分大小写（例如 `utf8mb4_general_ci`，其中 `ci` 表示不区分大小写）。如需区分大小写的比较，请使用 `_cs` 排序规则或 `BINARY` 运算符：

```sql theme={null}
SELECT * FROM users WHERE BINARY username = 'Alice';
-- or: WHERE username COLLATE utf8mb4_bin = 'Alice'
```

#### CHAR\_LENGTH 和 LENGTH 有什么区别？

`LENGTH` 返回字节数；`CHAR_LENGTH` 返回字符数。对于 ASCII 字符串，两者相同。对于包含多字节字符（带重音的字母、表情符号、中日韩文字）的 UTF-8 字符串，两者不同。对于用户可见的字符串长度限制，请使用 `CHAR_LENGTH`。

## 故障排除

| 问题 | 解决方案 |
| :- | :- |
| `CONCAT` 返回 NULL | 有一个参数为 NULL。在拼接前使用 `COALESCE(col, '')` 替换 NULL，或改用 `CONCAT_WS` |
| `LIKE '%pattern%'` 很慢 | 前导通配符使索引无法使用。对于大规模文本搜索，请考虑 FULLTEXT 索引 |
| 字符串比较没有匹配到预期的行 | 大小写敏感性或排序规则不匹配。使用 `SHOW CREATE TABLE` 检查列的排序规则 |
| `REPLACE` 没有匹配到 `LIKE` 匹配的内容 | `REPLACE` 逐字节比较，并忽略连接的排序规则，因此即使在 `_ci` 列上它也*区分*大小写，这一点与 `=`、`LIKE` 或 `LOCATE` 不同 |
| `SUBSTRING` 返回空字符串而不是 NULL | 位置越界时，SUBSTRING 返回空字符串，而不是 NULL |

## 另请参阅

* [MySQL 字符集与排序规则](https://villagesql.com/docs/zh/guides/character-sets.md)：字符串函数在不同排序规则下的行为不同
* [MySQL 全文搜索](https://villagesql.com/docs/zh/guides/full-text-search.md)：超越 LIKE 的大规模字符串搜索
* [MySQL 列别名](https://villagesql.com/docs/zh/tutorial/column-aliases.md)：为字符串表达式生成的列命名
* [MySQL LIKE](https://villagesql.com/docs/zh/tutorial/like.md)：经常与这些函数一起使用的模式运算符
* [MySQL GROUP\_CONCAT](https://villagesql.com/docs/zh/tutorial/group-concat.md)：把一组中的值拼接成一个字符串


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.