GeekIt

sd命令速查

安装与基础替换、正则捕获组、标志与次数限制、预览与安全、批量组合、与 sed/perl 对比、实战与报错排查等 115 条命令

共 115 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
sd --version查看版本,新版本才有 --preview 等参数
sd --help查看全部参数与标志说明
cargo install sdRust 工具链安装,版本最新
brew install sdmacOS 安装
apt install sd部分源提供的是 sd-find-replace,注意区分
snap install sdsnap 安装
cargo binstall sd直接下预编译二进制,省去编译时间
which -a sd确认执行的是 chmln/sd 而不是其他同名命令
sd 语法:sd FIND REPLACE [FILES...]三个位置参数,理解顺序是关键
sd 只认 Rust regex 语法没有前后顾与反向引用,与 PCRE 有差异
命令 / 片段说明复制
echo "hello world" | sd world there标准输入替换后输出到标准输出,源不动
sd foo bar file.txt直接就地修改文件,不需要 -i(与 sed 最大差异)
sd "foo" "bar" a.txt b.txt一次替换多个文件
sd "foo" "bar"不给文件时从标准输入读、写标准输出
cat file.txt | sd "foo" "bar" > new.txt不动源文件,另存一份
sd -F "a.b(c)" "x" file.txt固定字符串替换,关闭正则解析
sd "\s+" " " file.txt压缩多余空白
sd "^" "// " file.txt给每行开头加注释
sd "$" " ;" file.txt给每行结尾追加内容
sd "\t" " " file.txtTab 转 4 空格
sd -- "-old-" "new" file.txt模式以短横线开头时用 -- 结束参数解析
sd "" "x" file.txt空模式会插入内容,慎用,务必先 -p 预览
命令 / 片段说明复制
sd "v(\d+)\.(\d+)" "v$1-$2" file.txt位置捕获组用 $1/$2 引用
sd "(\w+)@(\w+)" "$2 at $1" file.txt交换两段内容,重构时常用
sd "(?P<name>\w+)=(?P<val>\d+)" "${name}: ${val}" file.txt命名捕获组用 ${name} 引用,可读性更好
sd "foo(\d+)" "bar$0" file.txt$0 表示整个匹配内容
sd "foo" "cost: $$10" file.txt$$ 输出字面量美元符号
sd -f i "error" "ERROR" file.txt忽略大小写替换
sd -f w "cat" "dog" file.txt整词匹配,避免改到 category
sd -f s "foo.*bar" "x" file.txt让点号匹配换行,做跨行替换
sd -f e "^" " " file.txt关闭多行模式,整份文件当一行处理
sd "[0-9]{4}-[0-9]{2}-[0-9]{2}" "YYYY-MM-DD" file.txt批量脱敏日期
sd "\b(\d{1,3}\.){3}\d{1,3}\b" "0.0.0.0" config.txt批量替换 IP 地址
sd "(?m)^#.*$" "" file.txt删除整行注释
sd "\r\n" "\n" file.txtCRLF 转 LF,注意跨行匹配需配 -f s
sd 不支持 (?=...)、(?<=...)、(\w)\1Rust regex 的硬限制,需要改用 perl 或两步替换
命令 / 片段说明复制
-f c区分大小写(默认行为,显式写出便于阅读)
-f i忽略大小写
-f m多行模式,^ 与 $ 匹配每行边界
-f e关闭多行匹配,把整个文件当单行
-f s点号匹配换行
-f w整词匹配
sd -f im "error" "ERR" file.txt标志可组合,按字母拼接
sd -n 1 "foo" "bar" file.txt只替换前 1 次,改配置首项时常用
sd -n 3 "todo" "TODO" file.txt限制总替换次数,防止误伤
sd -F -n 1 "a.b" "x" file.txt固定字符串与次数限制可叠加
参数顺序:标志在前,三个位置参数在后位置写错会被当成文件名,报找不到文件
命令 / 片段说明复制
sd -p "foo" "bar" file.txt只预览彩色差异,不落盘
sd -p "foo" "bar" src/目录递归预览,确认范围后再执行
sd -p "pattern" "x" $(fd -e go)先用 fd 限定文件集再预览
git status --short批量替换前确认工作区干净,随时可回滚
git commit -m "before sd refactor"动手前先提交一次,出问题直接 reset
git diff替换后立刻看改动,确认没有误伤
cp -a src src.bak没有版本控制时先整目录备份
sd 不会生成 .bak 备份文件安全责任在使用者,别指望它兜底
sd 直接改原文件且无二次确认所以 -p 预览与 git 是必须的前置动作
批量替换后跑一次构建或测试文本层面正确不代表语义正确
命令 / 片段说明复制
sd "old" "new" $(fd -e go)用 fd 生成文件列表,精准限定范围
fd -e yaml -x sd -p "replicas: 1" "replicas: 3"逐文件预览替换,-x 会为每个文件执行一次
fd -e md -x sd "http://" "https://"批量把 http 换成 https
rg -l "oldFunc" | xargs sd "oldFunc" "newFunc"用 rg 先定位再替换,范围最准
find . -name "*.conf" -exec sd "8080" "9090" {} +find 与 sd 组合
sd "foo" "bar" **/*.rsshell 开启 globstar 后可直接用通配符
sd "foo" "bar" .给目录会递归处理,注意排除二进制
fd -e go -x sd "errors.New" "fmt.Errorf"批量改造错误构造方式
rg --files -g "!vendor/**" | xargs sd "old" "new"排除依赖目录后再替换
sd "old" "new" $(git ls-files)只处理 Git 跟踪的文件
替换 + 格式化一起跑gofmt/prettier 能顺带修掉缩进与换行差异
被替换内容含空格时用引号包裹文件名配合 fd -0 与 xargs -0 更安全
命令 / 片段说明复制
sd "a" "b" file等价 sed -i "s/a/b/g",但不用写 s/// 与 -i
sed -i.bak "s/a/b/g" filesed 可留备份,sd 不支持,需自己 cp
sed -E "s/(a)(b)/\2\1/" filesed 用 \1 反向引用,sd 用 $1
perl -pi -e "s/a/b/g" file需要前后顾或反向引用时改用 perl
sd -F "a.b" "x" file固定字符串模式比 sed 转义元字符简单得多
sd 默认替换全部匹配sed 默认只替换每行第一次,需要 g 标志
sd 默认多行模式sed 逐行处理,跨行替换需要特殊技巧
sd 正则不支持 lookaround复杂断言场景 perl 更合适
sd 不处理编码转换GBK 文件要先 iconv 再替换
日常替换用 sd,复杂正则用 perl工具定位不同,别硬凑
命令 / 片段说明复制
sd "v1\.2\.3" "v1\.3\.0" $(rg -l "v1.2.3")版本号批量升级
fd -e yaml -x sd "image: app:1.2.3" "image: app:1.3.0"K8s 清单镜像版本统一更新
sd "old\.example\.com" "new.example.com" $(rg -l "old\.example\.com")域名迁移,批量改引用
sd "10\.0\.0\.5" "10\.0\.1\.5" $(fd -e conf)配置里 IP 变更
sd -F "TODO" "FIXME" -n 100 $(fd -e md)文档里标记批量改名
sd "localhost:8080" "api.internal:8080" $(rg -l localhost:8080)本地地址换成内网服务地址
sd "\s+$" "" file.txt清理行尾空白,提交前整理格式
sd "(?m)^\s*$\n?" "" file.txt删除空行,注意备份后确认效果
sd "createServer\(\)" "createApp()" $(fd -e js)函数调用批量重命名
sd -f w "util" "helpers" $(fd -e ts)整词替换避免改到 utilities
sd "import \{ (\w+) \} from \"lodash\"" "import { $1 } from \"lodash-es\""依赖包路径批量替换
替换后 rg 复查残留用原关键词再搜一遍,确认没有漏网
命令 / 片段说明复制
sd -p "old" "new" file || exit 1预览失败即退出,流水线里做前置校验
if rg -q "old" src/; then sd "old" "new" $(rg -l old src/); fi有匹配才执行,避免无谓改动
sd "old" "new" file && git diff --exit-code --quiet || echo changed判断替换是否真的产生改动
sd 无匹配时退出码仍为 0脚本里不能靠退出码判断是否替换成功
配合 git diff --stat 输出改动摘要CI 日志里能直接看出影响范围
把替换规则写进脚本文件团队复用与评审都更方便
替换脚本里固定 sd 版本不同版本正则在边界行为上可能有差异
CI 中避免对生成文件替换构建产物会被覆盖,替换等于白做
先小范围跑一次再全量单文件验证规则正确性,再放开目录
用 sd -p 输出贴进 PR 说明评审人一眼能看到改了什么
命令 / 片段说明复制
error: Found argument which was not expected参数顺序错或把模式写成了选项,必要时加 --
regex parse error: look-around is not supportedRust regex 不支持前后顾,改用 perl
error: The following required arguments were not provided: <FIND> <REPLACE_WITH>少传了模式或替换串
No such file or directory (os error 2)文件路径错误,注意通配符未展开的情况
Permission denied (os error 13)文件只读或无权限,检查属主
error: Invalid flags-f 后面只能跟 c/e/i/m/s/w 的组合
unknown flag: --preview版本过低,升级后才有预览功能
替换后出现 $1 原样文本替换串被 shell 展开了,用单引号包裹
想输出字面量 $ 却变成了分组引用用 $$ 转义
无匹配但命令返回 0正常行为,判断是否生效要看 diff
CRLF 文件替换后换行变乱跨行匹配需加 -f s,或先统一换行
二进制文件被改坏sd 不检测文件类型,替换前务必限定扩展名
中文替换后乱码源文件不是 UTF-8,先 iconv 转码
通配符没展开导致报错shell 未匹配到文件,检查 glob 或改用 fd

运维常用组合

安全批量替换git status --short → rg -l "oldFunc" → sd -p "oldFunc" "newFunc" $(rg -l "oldFunc") → 确认后去掉 -p 执行 → git diff
版本号升级rg -l "v1\.2\.3" | xargs sd "v1\.2\.3" "v1\.3\.0" → rg "v1.2.3" 复查残留
域名单替换sd "old\.example\.com" "new.example.com" $(fd -e conf -e yaml)
函数重命名sd -f w -p "getUser" "fetchUser" $(fd -e ts) → 预览无误后执行 → 跑测试
清理行尾空白sd "\s+$" "" $(git ls-files "*.md") → git diff --stat 看改动规模
CI 前置检查if rg -q "TODO: remove" src/; then echo "存在待删标记"; exit 1; fi

实战要点

1. 默认就地修改

sd 不需要 -i,给了文件就直接改,所以 -p 预览与 git 备份是必做动作

2. 捕获组用 $1

不是 sed 的 \1,也不是 perl 的 $1 加斜杠,替换串记得用单引号包住

3. 不支持前后顾

Rust regex 的硬限制,需要 lookaround 或反向引用时改用 perl

4. 先用 rg 定位

rg -l 拿到准确文件集再交给 sd,比直接对目录递归替换安全得多

5. 整词匹配防误伤

改函数名或变量名时加 -f w,避免 util 把 utilities 一起改了

6. 无匹配也算成功

退出码恒为 0,判断是否生效要看 git diff,不要依赖返回值

共 115 条 sd 命令 · 示例中的文件名与模式请替换为实际环境

关于sd命令速查

在线 sd(chmln/sd)命令速查手册,按安装与版本、基础替换、正则与捕获组、标志与次数限制、预览与安全、批量替换与管道组合、与 sed/perl 对比、实战场景、脚本与 CI、常见报错与排查等 10 类场景整理 110 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 sd --version 与 cargo/brew/apt/snap 安装、echo "hello world" | sd world there 的标准输入输出用法 与 sd foo bar file.txt 的默认就地编辑(无需 -i)、-p/--preview 预览彩色差异 与 -F/--fixed-strings 固定字符串 与 -f/--flags 的 c 区分大小写、e 关闭多行、i 忽略大小写、m 多行、s 点号匹配换行、w 整词匹配 与 -n/--max-replacements 限制替换次数 与 -- 结束参数解析,以及 $1/$2 位置捕获组 与 ${name} 命名捕获组 与 $0 整体匹配 与 $$ 输出字面量美元符号,还有 sd 基于 Rust regex 不支持前后顾与反向引用的限制及替代方案、多文件同时替换、与 fd/rg/xargs/find 组合做定向批量重构、git 工作区先提交再批量替换的流程、CI 中基于替换结果做校验,以及 error: Found argument which was not expected、regex parse error: look-around is not supported、required arguments were not provided、No such file or directory、Permission denied、Invalid flags、$ 被当作分组引用、无匹配时静默成功退出码 0、CRLF 与二进制文件被误改 等报错排查。适用于代码批量重命名与重构、配置与版本号批量更新、日志与文档文本替换、IP 与域名迁移、多文件统一改写、配合 fd/rg 做精准范围替换,以及运维、SRE 与后端工程师面试复习。

核心能力

  • 涵盖 sd --version 与 cargo/brew/apt/snap 安装、echo "hello world" | sd world there 的标准输入输出用法 与 sd foo bar file.txt 的默认就地编辑(无需 -i)、-p/--preview 预览彩色差异 与 -F/--fixed-strings 固定字符串 与 -f/--flags 的 c 区分大小写、e 关闭多行、i 忽略大小写、m 多行、s 点号匹配换行、w 整词匹配 与 -n/--max-replacements 限制替换次数 与 -- 结束参数解析,以及 $1/$2 位置捕获组 与 ${name} 命名捕获组 与 $0 整体匹配 与 $$ 输出字面量美元符号,还有 sd 基于 Rust regex 不支持前后顾与反向引用的限制及替代方案、多文件同时替换、与 fd/rg/xargs/find 组合做定向批量重构、git 工作区先提交再批量替换的流程、CI 中基于替换结果做校验,以及 error: Found argument which was not expected、regex parse error: look-around is not supported、required arguments were not provided、No such file or directory、Permission denied、Invalid flags、$ 被当作分组引用、无匹配时静默成功退出码 0、CRLF 与二进制文件被误改 等报错排查

适用场景

适用于代码批量重命名与重构、配置与版本号批量更新、日志与文档文本替换、IP 与域名迁移、多文件统一改写、配合 fd/rg 做精准范围替换,以及运维、SRE 与后端工程师面试复习。sd命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

sd命令速查是免费的吗?需要注册或安装吗?
sd命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
sd命令速查支持哪些功能?
涵盖 sd --version 与 cargo/brew/apt/snap 安装、echo "hello world" | sd world there 的标准输入输出用法 与 sd foo bar file.txt 的默认就地编辑(无需 -i)、-p/--preview 预览彩色差异 与 -F/--fixed-strings 固定字符串 与 -f/--flags 的 c 区分大小写、e 关闭多行、i 忽略大小写、m 多行、s 点号匹配换行、w 整词匹配 与 -n/--max-replacements 限制替换次数 与 -- 结束参数解析,以及 $1/$2 位置捕获组 与 ${name} 命名捕获组 与 $0 整体匹配 与 $$ 输出字面量美元符号,还有 sd 基于 Rust regex 不支持前后顾与反向引用的限制及替代方案、多文件同时替换、与 fd/rg/xargs/find 组合做定向批量重构、git 工作区先提交再批量替换的流程、CI 中基于替换结果做校验,以及 error: Found argument which was not expected、regex parse error: look-around is not supported、required arguments were not provided、No such file or directory、Permission denied、Invalid flags、$ 被当作分组引用、无匹配时静默成功退出码 0、CRLF 与二进制文件被误改 等报错排查。
sd命令速查适合哪些场景使用?
适用于代码批量重命名与重构、配置与版本号批量更新、日志与文档文本替换、IP 与域名迁移、多文件统一改写、配合 fd/rg 做精准范围替换,以及运维、SRE 与后端工程师面试复习。