本篇文章介绍一个可以批量复制文件到指定目录的 shell 脚本。

假设这个 shell 脚本的名称为 cpfiles.sh。

在实际开发工作中，可能需要按照目录结构来保存一些改动后的文件，以作备份。

这些目录结构可能包含多个子目录、或者需要复制多个文件。

如果直接复制外面的目录，会包含没有发生改动的文件。

如果手动创建各个子目录，再来复制多个文件，比较麻烦。

当前脚本预期把要复制的文件路径保存到一个配置文件里面。

然后解析所给的配置文件，自动创建对应的子目录，复制文件到指定目录下。

当配置了多个文件路径时，就可以批量复制文件。

同时，当前脚本进行了扩展，可以处理 Android 系统的 repo status 命令打印的修改文件信息。

执行 repo status 查看 Android 源码仓库的改动时，打印的文件信息格式如下：

project frameworks/base/-m services/core/java/com/android/server/ServiceThread.javaproject packages/apps/Music/-m src/com/android/music/MusicPicker.java

在每个 project 后面，会跟着某个代码仓库相对于 Android 源码根目录的路径。

接下来的行对应该仓库下面的文件路径，这个文件路径相对于代码仓库的根目录。

例如，上面的 ServiceThread.java 文件在 Android 源码根目录中的完整路径是 “frameworks/base/services/core/java/com/android/server/ServiceThread.java”

当需要备份 Android 源码多个仓库下发生改动的文件时，可以使用 repo status 列出修改文件信息。

把这些文件信息保存到一个文件里面，当前脚本可以解析这些文件信息，批量复制所列出的文件到指定目录下。

在其他使用 git 管理代码的项目上，git log --name-status 打印的修改文件信息跟 repo status 的信息类似。

只是缺少了 “project project_path” 这一行，手动补上这一行，就可以使用当前脚本复制 git 仓库下面的文件。

脚本代码

列出 cpfiles.sh 脚本的具体代码如下所示。

在这个代码中，对大部分关键代码都提供了详细的注释，方便阅读。

这篇文章的后面也会提供一个参考的调用例子，有助理解。

#!/bin/bash# 在Android源码中,执行repo status命令可以查看修改的文件信息.格式为:#   project frameworks/base/#   -m services/core/java/com/android/server/ServiceThread.java#   project packages/apps/Music/#   -m src/com/android/music/MusicPicker.java# 在这些信息中,每一个 project 段对应一个代码仓库路径.当需要复制多个# 仓库的指定代码文件时,手动复制比较麻烦. 当前脚本用于处理这种格式的# 配置信息,组装得到完整的文件路径,并复制后指定的目标目录下.# 同时,该脚本也做了扩展,可以提供要复制的完整文件路径,使不局限于复制# Android 源码目录下的代码文件,可以复制任意目录下的文件.# 下面设置set -e,一旦报错就停止执行.例如复制某个文件出错就不再复制.set -eshow_help(){printf "USAGE    cpfiles.sh [source_fileinfos [target_dir]]OPTIONS    该脚本最多可以提供两个参数. 这两个参数是可选的.    source_fileinfos: 指定保存源文件路径信息的配置文件名.        如果没有提供该参数,默认解析的文件名是 'copy-files.txt'.    target_dir: 指定要把源文件复制到哪个目录下.        如果没有提供该参数,默认会复制到当前目录下的 '0-复制后' 目录.        如果目标目录不存在,会自动新建对应的目录.        这个参数必须是第二个参数.当提供该参数时,也要提供第一个参数.NOTE    配置源文件路径信息的参考格式如下:        project base_top_dir1/        -m     file_sub_path1        project        full_file_path2    一般来说,每个 project 开头的段对应不同目录下的文件. 在project后面    可以跟着一个目录路径,该段的源文件路径会自动加上这个目录路径.例如,    在上面例子中,要复制的完整文件路径是 base_top_dir1/file_sub_path1    如果project后面没有目录路径,则该段的文件路径就是要复制的完整路径."}# 下面变量指定配置源文件路径信息的文件名.解析该文件得到要复制的文件路径.SRC_FILEINFO="copy-files.txt"# 这个脚本的第一个参数用于指定配置源文件路径信息的文件名.# 如果没有提供第一个参数,则使用默认的配置文件名.if [ $# -gt 0 ]; then    SRC_FILEINFO="$1"fi# 下面变量指定源文件被复制到的目标目录名,会在当前工作目录下新建该目录.COPY_TARGET_TOP_DIR="0-复制后"# 这个脚本的第二个参数用于指定源文件被复制到的目标目录名.# 如果没有提供第二个参数,则使用默认的目标目录名.if [ $# -eq 2 ]; then    COPY_TARGET_TOP_DIR="$2"fiif [ $# -gt 2 ]; then    echo "出错: 该脚本最多只能提供两个参数."    show_help    exit 1fi# 检查当前工作目录下是否存在一个指定的配置文件. 如果不存在,则报错返回.if [ ! -f "${SRC_FILEINFO}" ]; then    echo "出错: 在当前目录下不存在要解析的 ${SRC_FILEINFO} 文件."    show_help    exit 2fi# 从 SRC_FILEINFO 配置文件解析出完整的源文件路径信息后,把这些信息写入到# FULL_FILEPATH 对应的文件里面.基于FULL_FILEPATH文件保存的文件路径进行复制.FULL_FILEPATH="full_filepaths.txt"# 从所给文件中解析要复制的源文件路径信息.第一个参数指定被解析的文件名.# 解析得到的完整源文件路径信息会写入 FULL_FILEPATH 变量指定的文件里面.# 所给配置文件里面配置了要复制的源文件路径信息. 具体格式如下:#   project base_top_dir1/#   foo     file_sub_path1#   project#   full_file_path2# 配置内容可以分为多段. 每段以project开头. 每段里面可以配置多个源文件路径.# 如果在project后面跟着一个目录路径,则该段的文件路径前面会自动加上这个目录# 路径.例如在上面格式中,实际要复制的文件路径是 base_top_dir1/file_sub_path1.# 此时,该段的文件路径前面要有一个 foo 占位字符串,具体内容不限,但一定要有.# 这个格式是为了符合 Android 的 repo status 命令打印的文件信息.# 如果project后面没有提供目录路径,表示该段的文件路径就是完整的目录路径.如果# 所给的文件路径是相对路径,需要确保执行时的工作目录可以寻址到这个相对路径.parse_file_infos(){    if [ $# -ne 1 ]; then        echo "Usage: ${FUNCNAME} filename"        return 1    fi    # 所给的第一个参数指定要解析的配置文件名.    local parsefile="${1}"    # 下面变量对应每段开始的 project 字符串.    local IDENTIFY_PROJECT="project"    local fileline lastchar    local header project_dir sub_file_path full_file_path    # 如果文件的最后一行没有以换行符'\n'结尾, read 命令在读取最后一行    # 时会返回false,从而退出下面的 while 循环,导致最后一行没有被处理,    # 会少复制一个文件.下面使用 tail 命令获取文件的最后一个字符.由于    # $() 表达式会去掉输出结果末尾的换行符,如果文件的最后一个字符是换    # 行符,经过 "$()" 扩展后会变成空.可以通过判断扩展后的结果是否为空    # 来确认文件是否以换行符结尾.如果不以换行符结尾,则使用 echo 命令    # 给文件末尾追加一个换行符. test -n 命令判断字符串不为空时返回true.    if test -n "$(tail "${parsefile}" -c 1)"; then        echo >> "${parsefile}"    fi    # /dev/null 是一个空文件,输出这个文件的内容为空.重定向到    # FULL_FILEPATH 文件,清空该文件的内容,避免原有内容的影响.    cat /dev/null > "${FULL_FILEPATH}"    while read fileline; do        header="$(echo ${fileline} | awk '{print $1}')"        if [ "${header}" == "${IDENTIFY_PROJECT}" ]; then            project_dir="$(echo ${fileline} | awk '{print $2}')"            # project_dir 被作为目录路径使用,要求最后一个            # 字符必须是'/',以便组装成目录路径.如果没有            # 以 '/' 结尾,则在该变量值后面加上 '/' 字符.            if [ -n "${project_dir}" ]; then                lastchar="${project_dir: -1:1}"                if [ "${lastchar}" != "/" ]; then                    project_dir="${project_dir}/"                fi            fi        elif [ -n "${fileline}" ]; then            # 当文件中有空行时, fileline 的内容是空字符串. 后面组装            # sub_file_path的值会有异常,所以上面用-n判断不为空才处理.            #            # 如果当前行没有以 project 开头,那么对应要复制的文件路径.            # 当 project_dir 不为空时,表示当前解析的段配置了目录路径,            # 那么源文件路径前面会有一个占位字符串,所以要获取空格隔开            # 的第二列内容才是文件路径. 如果 project_dir 为空,则这一            # 行就是完整的源文件路径.            if [ -n "${project_dir}" ]; then                sub_file_path="$(echo ${fileline} | awk '{print $2}')"            else                sub_file_path="${fileline}"            fi            full_file_path="${project_dir}${sub_file_path}"            echo "${full_file_path}" >> "${FULL_FILEPATH}"        fi    done < "${parsefile}"    # 由于有些文件可能被配置多次,下面对生成的内容进行排序,并删除重复行.    # sort 命令的 -u 选项表示删除重复行. -o 选项后面提供文件名来指定排序    # 后的内容要写入哪个文件. 如果没有提供 -o 选项,默认写到标准输出,不会    # 直接修改所给文件自身.这里指定排序后的内容输出到同一个文件,覆盖文件.    sort -u "${FULL_FILEPATH}" -o "${FULL_FILEPATH}"}# 该函数解析所给的文件,从中得到要复制的源文件路径,复制# 指定文件到目标目录下. 所给的第一个参数指定要解析的文件名.# 所给文件的每一行都对应一个要复制的完整文件路径.copy_src_files(){    if [ $# -ne 1 ]; then        echo "Usage: ${FUNCNAME} filepaths"        return 1    fi    # 所给的第一个参数指定保存了源文件完整路径信息的文件名    local copyfiles="$1"    local source_file_path    # 先创建目标目录.这个目录必须先创建, cp 命令才能复制文件过来. 当要    # 创建的目录已经存在时, mkdir 命令默认会报错.使用 -p 选项使不报错.    mkdir -pv "${COPY_TARGET_TOP_DIR}"    while read source_file_path; do        # cp 命令的 --parents 选项会在目标目录下自动创建源文件路径包含        # 的子目录.不需要先在目标目录下创建各个子目录再复制.        # cp --parents -v 命令会打印创建中间子目录的信息,导致打印的        # 信息比较多.先不加 -v 选项.使用 -u 选项指定只复制较新的文件.        cp --parents -u "${source_file_path}" "${COPY_TARGET_TOP_DIR}"    done < "$copyfiles"}# 把Windows系统的dos格式文件转换成unix格式. Dos格式文件的行末是\r\n,# 而unix格式文件的行末是\n,且把\r视作有效字符.如果不做转换,那么提供# 一个dos格式的文件,最后得到的文件路径会包含\r字符,且被当做文件名的# 一部分.用cp命令复制时,会提示找不到这样的文件.在使用 file 命令查看# dos 格式文件时,打印的信息包含 "CRLF line terminators" 字符串.查看# 所给文件的信息是否包含该字符串,就可以判断这个文件是不是 dos 格式.# 如果是 dos 格式文件,则执行 dos2unix 命令转换为 unix 格式文件.if [[ "$(file SRC_FILEINFO)" =~ "CRLF line terminators" ]]; then    # dos2unix 命令默认直接修改所给文件自身,覆盖成 unix 格式.    dos2unix "${SRC_FILEINFO}"fi# 调用 parse_file_infos 函数解析所给文件内容,得到要复制的源文件路径.# 解析得到的源文件路径保存在 FULL_FILEPATH 变量名指定的文件里面.parse_file_infos "${SRC_FILEINFO}"# 调用 copy_src_files 函数,基于源文件路径,复制源文件到目标目录下.copy_src_files "${FULL_FILEPATH}"echo "已复制全部文件到 '${COPY_TARGET_TOP_DIR}' 目录下."# 把所给文件和生成的路径信息文件移动到目标目录下,以便记录文件来源.cp -v "${SRC_FILEINFO}" "${COPY_TARGET_TOP_DIR}/"mv -v "${FULL_FILEPATH}" "${COPY_TARGET_TOP_DIR}/"exit

为了测试当前的 cpfiles.sh 脚本，可以先执行下面命令来创建一些目录和文件：

$ mkdir -p top/sub1/left1/left2$ mkdir -p top/sub1/right1/$ mkdir -p top/sub2/sub3$ touch top/sub1/left1/left2/left_file.txt$ touch top/sub1/right1/right_file.txt$ touch top/sub2/sub3/sub_file.txt

这几个命令在当前工作目录下创建了一个 top 目录。

在这个 top 目录底下还有一些子目录和文件。总共新建了三个文本文件。

下面会使用 cpfiles.sh 脚本来复制这三个文本文件，且保存在对应的目录结构里面。

基于上面创建的目录和文件，可以新建一个 copy-files.txt 文件，并在文件里面配置如下内容：

project top/sub1/a   left1/left2/left_file.txta   right1/right_file.txtprojecttop/sub2/sub3/sub_file.txt

在这个配置信息中，第一个 project 段后面跟着 top/sub1/ 目录路径。

那么该段下的文件路径会自动加上这个目录路径。

例如，所配置的 left1/left2/left_file.txt 这个文件的完整复制路径会是 “top/sub1/left1/left2/left_file.txt”。

第二个 project 段后面提供目录路径。

那么该段下的文件路径就是完整的目录路径。

此时，需要确保可以基于当前工作目录寻址到所配置的文件。

把 cpfiles.sh 脚本和 copy-files.txt 文件放到当前目录下，为脚本添加可执行权限。

具体执行结果如下：

$ ./cpfiles.shmkdir: created directory ‘0-复制后’已复制全部文件到 '0-复制后' 目录下.‘copy-files.txt’ -> ‘0-复制后/copy-files.txt’‘full_filepaths.txt’ -> ‘0-复制后/full_filepaths.txt’$ ls 0-复制后/copy-files.txt  full_filepaths.txt  top$ ls 0-复制后/top/sub1  sub2

可以看到，执行 cpfiles.sh 脚本后，会在当前目录新建一个 “0-复制后” 目录。

然后把所要复制的文件按照原先的目录结构复制到 “0-复制后” 目录下。

同时，还会在 “0-复制后” 目录下生成所给的 copy-files.txt 文件、生成的 full_filepaths.txt。

这两个文件记录了要复制的文件路径信息，以便后续进入该目录时，可以查看目录下的文件列表信息。

测试结束后，可以执行下面命令来删除所创建的测试目录和文件：

rm -r 0-复制后/ top/ copy-files.txt