- name
- filesystem
- description
- Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
Filesystem Operations
文件系统操作工具，提供目录列表、内容搜索、批量处理和目录分析功能。
快速开始
列出目录
# 列出当前目录
ls -la
# 递归列出目录树
find . -type f -name "*.md" | head -20
# 按类型过滤
find . -type f \( -name "*.md" -o -name "*.txt" \)搜索文件
# 按名称搜索
find . -name "*keyword*"
# 按内容搜索
grep -r "keyword" . --include="*.md"
# 不区分大小写搜索
grep -ri "keyword" . --include="*.md"分析目录
# 统计文件类型
find . -type f -name "*.md" | wc -l
# 查看目录大小
du -sh .
# 找出最大文件
find . -type f -exec ls -lh {} \; | sort -k5 -h | head -10核心功能
1. 目录列表
基础列表：
ls -la # 详细列表
ls -lh # 人类可读大小
ls -lt # 按修改时间排序
ls -R # 递归列表高级列表：
# 列出特定类型
find . -type f -name "*.md"
# 按深度列出
find . -maxdepth 2 -type f
# 排除特定目录
find . -type f -not -path "*/node_modules/*"2. 文件搜索
按名称搜索：
# 精确匹配
find . -name "filename.md"
# 模式匹配
find . -name "*pattern*"
# 大小写不敏感
find . -iname "*pattern*"按内容搜索：
# 基础搜索
grep -r "keyword" .
# 包含行号
grep -rn "keyword" .
# 只搜索特定文件
grep -r "keyword" . --include="*.md"
# 排除目录
grep -r "keyword" . --exclude-dir=node_modules正则表达式搜索：
# 使用正则
grep -r "^## " . --include="*.md"
# 多个关键词
grep -r "key1\|key2" .
# 行首/行尾
grep -r "^关键词" .
grep -r "关键词$" .3. 批量操作
批量复制：
# 复制特定类型
find . -name "*.md" -exec cp {} backup/ \;
# 复制到多个位置
for file in *.md; do cp "$file" dir1/ && cp "$file" dir2/; done批量移动：
# 移动特定文件
find . -name "*.log" -exec mv {} logs/ \;
# 按条件移动
find . -type f -size +1M -exec mv {} large/ \;批量删除：
# 删除特定类型
find . -name "*.tmp" -delete
# 删除空目录
find . -type d -empty -delete
# 删除旧文件
find . -type f -mtime +30 -delete批量重命名：
# 使用 rename 命令
rename 's/old/new/' *.md
# 添加前缀
for file in *.md; do mv "$file" "prefix_$file"; done4. 目录分析
大小分析：
# 总大小
du -sh .
# 各目录大小
du -h --max-depth=1 . | sort -hr
# 最大的文件
find . -type f -exec ls -lh {} \; | sort -k5 -hr | head -10文件类型统计：
# 按扩展名统计
find . -type f -name "*.md" | wc -l
# 各类型统计
find . -type f -name "*.*" | sed 's/.*\.//' | sort | uniq -c目录结构分析：
# 目录树
tree -L 2
# 递归深度
find . -type d | wc -l
# 文件分布
find . -type f | cut -d/ -f1-2 | sort | uniq -c5. 文件信息查询
文件详情：
# 完整信息
stat filename
# 只看大小
ls -lh filename
# 只看时间
ls -lt filename文件内容预览：
# 头部
head -20 filename
# 尾部
tail -20 filename
# 随机行
shuf -n 10 filename
# 字符数
wc -c filename
# 行数
wc -l filename实用工具
tree 命令
# 安装
brew install tree
# 使用
tree -L 2 -I 'node_modules|__pycache__'fd 命令（快速查找）
# 安装
brew install fd
# 使用
fd "pattern" /path
fd -e md . # 只找 md 文件
fd -t f . # 只找文件ripgrep 命令（快速搜索）
# 安装
brew install ripgrep
# 使用
rg "keyword" .
rg -t md "keyword" .
rg -i "keyword" . # 不区分大小写
rg --type md "pattern" .最佳实践
1. 搜索优化
- 使用
fd或ripgrep替代find和grep（更快） - 先缩小搜索范围，再进行深度搜索
- 使用文件类型过滤减少搜索时间
2. 批量操作安全
- 操作前先用
--dry-run查看会发生什么 - 批量删除前先列出文件确认
- 重要操作前先备份
3. 目录分析
- 使用
-max-depth限制递归深度 - 使用
-size过滤大文件 - 使用
-mtime按时间筛选
常见任务
查找并处理 Markdown 文件
# 查找所有 md 文件
find . -name "*.md" -type f
# 统计 md 文件数量
find . -name "*.md" | wc -l
# 列出最大的 md 文件
find . -name "*.md" -exec ls -lh {} \; | sort -k5 -hr | head -5搜索并替换内容
# 搜索所有匹配项
grep -rn "old_text" . --include="*.md"
# 替换（使用 sed）
find . -name "*.md" -exec sed -i '' 's/old_text/new_text/g' {} \;清理临时文件
# 删除 .tmp 文件
find . -name "*.tmp" -delete
# 删除空目录
find . -type d -empty -delete
# 删除 30 天前的日志
find . -name "*.log" -mtime +30 -delete安全提醒
⚠️ 批量操作前先确认：
- 列出要操作的文件
- 确认不会误删重要文件
- 考虑先备份
⚠️ 删除操作不可逆：
rm删除后无法恢复- 大批量删除前仔细检查
- 考虑使用
rm -i交互式删除
⚠️ 权限注意：
- 某些操作可能需要 sudo
- 系统目录操作要谨慎
- 考虑文件权限问题