sd命令速查
安装与基础替换、正则捕获组、标志与次数限制、预览与安全、批量组合、与 sed/perl 对比、实战与报错排查等 115 条命令
共 115 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
sd --version | 查看版本,新版本才有 --preview 等参数 | |
sd --help | 查看全部参数与标志说明 | |
cargo install sd | Rust 工具链安装,版本最新 | |
brew install sd | macOS 安装 | |
apt install sd | 部分源提供的是 sd-find-replace,注意区分 | |
snap install sd | snap 安装 | |
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.txt | Tab 转 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.txt | CRLF 转 LF,注意跨行匹配需配 -f s | |
sd 不支持 (?=...)、(?<=...)、(\w)\1 | Rust 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" **/*.rs | shell 开启 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" file | sed 可留备份,sd 不支持,需自己 cp | |
sed -E "s/(a)(b)/\2\1/" file | sed 用 \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 supported | Rust 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 diffrg -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 看改动规模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,不要依赖返回值
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 与后端工程师面试复习。