STUFF函数执行“删除+插入”操作,语法为STUFF(string,start,length,replacement),start从1开始,length为0时仅插入;需配合CHARINDEX定位,与REPLACE的全文匹配有本质区别。

STUFF函数的基本用法和参数含义
SQL Server 的 STUFF 函数不是“替换”,而是“删除 + 插入”:它从源字符串指定位置开始删掉一定长度的字符,再把新字符串插进去。理解这点是避免逻辑错误的关键。
语法为 STUFF(string, start, length, replacement),四个参数必须全给,且 start 从 1 开始(不是 0),length 为 0 时等效于纯插入(不删任何字符)。
-
start小于 1 或大于原字符串长度 → 返回NULL -
length为负数 → 报错:Argument data type int is invalid for argument 3 of stuff function. -
length超过剩余字符数 → 删到末尾,不报错
常见误用场景:想“替换子串”但没先定位起始位置
很多人以为 STUFF 能像 REPLACE 那样按内容匹配替换,其实不能。它只认位置,不认内容。若要基于文本内容做替换(比如把第一个 "abc" 换成 "xyz"),得先用 CHARINDEX 找位置:
SELECT STUFF('hello abc world', CHARINDEX('abc', 'hello abc world'), 3, 'xyz');
上面返回 'hello xyz world'。漏掉 CHARINDEX 直接硬写位置,一旦源数据变动就失效。
- 多个匹配时,
CHARINDEX默认只找第一个;要替换第 n 次出现,需嵌套调用或用STRING_SPLIT+ROW_NUMBER辅助 - 区分大小写?取决于数据库排序规则;如需强制大小写敏感,可在
CHARINDEX中加COLLATE SQL_Latin1_General_CP1_CS_AS
与REPLACE函数的本质区别和选型建议
REPLACE 是全文本匹配替换,不关心位置;STUFF 是定点手术式编辑,适合已知偏移量的场景(比如统一修正固定格式字段中的某几位)。
- 要替换所有 "old" 为 "new" → 用
REPLACE(col, 'old', 'new') - 要将第 5–7 位强制改为 "XXX",不管原来是什么 → 用
STUFF(col, 5, 3, 'XXX') - 性能上,
STUFF更轻量(无字符串扫描),但前提是位置可确定;否则叠加CHARINDEX反而更慢
在UPDATE语句中安全使用STUFF的注意事项
直接在 UPDATE 中用 STUFF 很常见,但容易因位置计算错误导致整列变 NULL 或截断。
- 务必用
WHERE过滤掉CHARINDEX返回 0 的行(即子串不存在),否则STUFF(..., 0, ...)会出错 - 对可能为
NULL的列操作前,加IS NOT NULL判断,或用ISNULL(col, '')包裹 - 执行前先用
SELECT验证效果,例如:SELECT col, STUFF(col, 10, 4, '****') FROM users WHERE id = 123;
最常被忽略的是 start 参数越界——尤其当字段长度不固定时,别假设所有值都够长。加个 CASE WHEN LEN(col) >= 13 THEN STUFF(col, 10, 4, '****') ELSE col END 更稳妥。

















