Shell脚本如何批量创建目录结构

wen 实用脚本 2026-07-17 1

Shell脚本如何批量创建目录结构（实战指南）

📋 文章目录导读

为什么需要批量创建目录结构
Shell脚本基础回顾与准备工作
核心方法：使用mkdir -p递归创建
进阶技巧：从文件或变量读取目录列表
实战案例：多层级项目目录一键生成
常见错误与调试方法
问答环节（FAQ）
总结与最佳实践

为什么需要批量创建目录结构

在日常开发或运维工作中,经常需要一次性创建大量具有嵌套关系的目录。

Shell脚本如何批量创建目录结构

初始化项目骨架（src/, lib/, docs/, tests/ 等）
部署多环境配置文件目录（dev/, staging/, prod/）
按月/日归档日志文件（logs/2025/03/01）

手工逐层创建不仅效率低,而且容易遗漏或出错。Shell脚本正是解决此类重复性、结构化任务的利器。 通过本文，你将掌握从基础到进阶的批量目录创建方法，并能灵活应用于实际场景。

Shell脚本基础回顾与准备工作

1 为什么选择Shell？

跨平台性：Linux/macOS原生支持，Windows通过WSL或Git Bash也可运行。
轻量高效：无需安装额外依赖，一条命令即可完成任务。
管道与循环：天然支持文本处理和批量操作。

2 环境检查

在执行脚本前,请确认你的环境：

# 检查Shell版本（建议使用bash）
echo $SHELL
# 输出应为 /bin/bash 或 /bin/zsh
# 确保有写入目标目录的权限
ls -ld /your/target/path

3 基础命令速记

mkdir：创建目录
-p：递归创建父目录（核心参数）
花括号展开（批量创建）
for循环：处理动态列表

核心方法：使用`mkdir -p`递归创建

1 单行命令创建多层目录

mkdir -p project/{src/{main,test},lib,docs,config}

执行后生成：

project/
├── src/
│   ├── main/
│   └── test/
├── lib/
├── docs/
└── config/

原理：-p参数使mkdir自动创建路径中不存在的父目录，花括号实现批量展开。

2 更复杂的嵌套结构

mkdir -p {2024,2025}/{01,02,03}/{day1,day2}

生成类似：

2024/01/day1
2024/01/day2
...
2025/03/day2

注意：花括号内不能包含空格或特殊字符（如），如需更复杂逻辑，请使用for循环。

进阶技巧：从文件或变量读取目录列表

1 从文本文件读取

创建dirs.txt，每行一个路径：

logs/2025/01
logs/2025/02
backup/system
backup/user

脚本：

#!/bin/bash
while IFS= read -r dir; do
    mkdir -p "$dir"
done < dirs.txt

2 从数组变量读取

#!/bin/bash
dirs=(
    "data/raw"
    "data/processed"
    "models/v1"
    "models/v2"
)
for dir in "${dirs[@]}"; do
    mkdir -p "$dir"
done

3 结合循环与计数器

#!/bin/bash
for i in $(seq 1 5); do
    mkdir -p "test/iteration_$i/output"
done

生成 test/iteration_1/output 到 test/iteration_5/output。

实战案例：多层级项目目录一键生成

假设我们需要为Web应用创建如下结构：

webapp/
├── src/
│   ├── controllers
│   ├── models
│   └── views
├── static/
│   ├── css
│   ├── js
│   └── images
├── config/
│   ├── development
│   └── production
└── logs/
    └── {2025..2030}/{01..12}

编写脚本`setup_project.sh`：

#!/bin/bash
# 用法：./setup_project.sh [项目名] (默认webapp)
PROJECT_NAME="${1:-webapp}"
echo "正在创建项目结构: $PROJECT_NAME"
# 创建基础目录
mkdir -p "$PROJECT_NAME"/{src/{controllers,models,views},static/{css,js,images},config/{development,production}}
# 创建年度日志目录（使用循环）
for year in $(seq 2025 2030); do
    for month in $(seq 1 12); do
        mkdir -p "$PROJECT_NAME/logs/$year/$(printf '%02d' $month)"
    done
done
echo "✅ 项目目录创建完成！"
tree "$PROJECT_NAME" 2>/dev/null || ls -R "$PROJECT_NAME"  # 如果没安装tree，用ls递归

运行：

chmod +x setup_project.sh
./setup_project.sh myapp

输出示例（部分）：

myapp/logs/2025/01
myapp/logs/2025/02
...
myapp/logs/2030/12

常见错误与调试方法

❌ 错误1：路径中包含特殊字符

现象：mkdir: cannot create directory ‘./my dir/new’: No such file or directory
解决：用引号包裹路径变量 mkdir -p "$dir"

❌ 错误2：权限不足

现象：mkdir: cannot create directory ‘/root/test’: Permission denied
解决：使用 sudo 或确保当前用户有写入权限。

❌ 错误3：花括号展开未生效

现象：生成了一个名为 {a,b} 的文件夹
解决：确保脚本第一行是 #!/bin/bash，且没有设置 set -f（禁用通配符）。

🛠 调试技巧

在mkdir前添加echo命令，预览即将创建的目录：echo "Creating: $dir"
使用-v参数让mkdir输出创建信息：mkdir -pv "$dir"
对复杂脚本,先set -x开启调试模式。

问答环节（FAQ）

Q1: 如何在Windows上运行这些Shell脚本？

A：推荐安装Git Bash、WSL（Windows Subsystem for Linux）或Cygwin，脚本语法与Linux一致，但注意路径分隔符使用而非。

Q2: 脚本里可以用通配符吗？比如`mkdir -p */subdir`？

A：通配符在mkdir中会展开为当前目录下的所有子目录，但不会递归创建，例如mkdir -p ./*/subdir会为每个子目录创建subdir，但前提是这些子目录已存在，更可靠的方式是用for dir in */; do mkdir -p "$dir/subdir"; done。

Q3: 批量创建的目录中，如何给不同目录设置不同权限？

A：在mkdir后使用chmod。

mkdir -p "$dir"
chmod 755 "$dir"  # 设置目录权限为rwxr-xr-x

或使用install -d -m 755 "$dir"一步到位。

Q4: 如果目标目录已存在，会报错吗？

A：使用-p参数时不会报错。mkdir -p会忽略已存在的目录，只会创建不存在的部分，所以你的脚本可以安全多次运行。

Q5: 可以创建包含空格的目录名吗？

A：可以，但必须用引号包裹变量。

dir="my project/src files"
mkdir -p "$dir"

但强烈建议避免在目录名中使用空格,改用下划线或连字符。

总结与最佳实践

核心要点

mkdir -p是最简单的批量创建方法，配合花括号展开可快速生成固定结构。
从文件或数组读取适合动态或大量目录，便于维护。
循环与变量让你能按规则生成（如日期、序号）。
始终用引号包裹路径变量，防止空格或特殊字符导致错误。

最佳实践清单

✅ 先在安全目录（如/tmp）测试脚本
✅ 添加用户输入验证（如目录是否存在、参数是否为空）
✅ 使用set -e让脚本在出错时立即退出
✅ 脚本开头添加注释说明用途和用法
✅ 将脚本版本纳入Git管理，方便回溯

扩展阅读

想要探索更高级的自动化？可以结合：

find命令：查找并处理已存在的目录
rsync：保持目录结构的同步
awk或sed：从配置文件中解析目录路径

Shell脚本如何批量创建目录结构