文档教程【免费下载链接】linux-commandLinux命令大全搜索工具内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux项目地址https://gitcode.com/GitHub_Trending/linux/linux-command点击查看免费下载mapfile是 bash 内建命令用于从标准输入或指定文件描述符按行读取内容并一次性赋值到数组是 Shell 脚本中批量解析文本、生成索引列表、遍历配置文件的高效工具。本文以 linux-command 开源仓库中 mapfile 手册 为核心骨架结合仓库内 declare.md、read.md 等兄弟命令文档与 dist/data.json 索引数据系统讲解其语法、全部选项、返回值语义与可复制的实战示例读完后你将掌握用mapfile替代while read循环、从任意文件描述符读取数据、自定义分隔符与增量回调等一整套数组化文本处理方案。命令定位与适用场景mapfile同义词readarray的本质是把输入流按行切开逐行存入数组。它解决的核心问题是如何把一段文本变成可编程遍历的数据结构典型场景包括读取文件、管道输出或/proc等伪文件的内容到数组供后续脚本逐行处理从指定文件描述符如exec 3 file打开的描述符读取避免与主标准输入冲突配合-C/-c在批量读取过程中触发回调实现边读边统计、边读边校验作为while read循环的替代方案mapfile在子 Shell 中无需额外处理读取后变量立即可用代码更简洁。该命令与read、declare同属 bash 内建工具linux-command 仓库在 read.md 与 declare.md 中分别收录了它们的手册。项目在 dist/data.json 索引中登记了该命令的名称、路径与描述从标准输入读取行并赋值到数组。可通过仓库生成的 Web 版README.md 中的搜索入口随时查阅。语法概要mapfile [-d delim] [-n count] [-O origin] [-s count] [-t] [-u fd] [-C callback] [-c quantum] [array]整体语义为从标准输入或-u fd指定的文件描述符中逐行读取将每一行作为一个元素写入数组array若省略array则写入名为MAPFILE的默认数组。选项详解-d delim自定义行分隔符将行分隔符从默认的换行符\n替换为delim。适合处理以 Tab、冒号、逗号等分隔的类表格文本——此时每个字段会被当作数组的一个元素而不是一整行。# 默认按换行符切分 mapfile source_file target_array # 以 Tab 作为分隔符$\t 是 ANSI-C 引用的写法 mapfile source_file -d $\t target_array # 终端输入场景直接在命令中书写 Tab 字符 # 注意第二行的 tab 在终端需要用 ctrlv tab 输入 mapfile source_file -d target_array需要说明的是使用自定义分隔符后输入流中残余的换行符不再作为切分依据而是作为普通字符保留在元素内部除非配合-t实际使用时往往把-d与-t组合以去除该分隔符本身。-n count限制读取行数从输入中获取最多count行即停止读取若count为 0则等同于读取全部。适用于只关心文件头部若干行、或大文件内存受限的场景。# 只读取前 5 行 mapfile source_file -n 5 target_array-O origin指定起始下标从数组下标origin处开始赋值默认下标为 0。注意两点语义差异指定了-O且提供了数值时不会清空数组已有元素会被保留新读取的内容从origin下标开始覆盖写入只使用-O而未提供起始位置数值时mapfile会在实际赋值之前清空该数组。# 从下标 2 开始赋值数组中 0、1 位置的原有元素不受影响 mapfile source_file -O 2 target_array-s count跳过前 count 行先跳过输入流的前count行再从第count1行开始读取。常用于处理带表头、注释或元信息的文件如跳过 CSV 表头、/proc伪文件的首行标题。# 跳过前 5 行后再读取 mapfile source_file -s 5 target_array-t读取时移除行分隔符读取时自动去掉每行末尾的分隔符默认为换行符若配合-d则为该自定义分隔符。不指定-t时数组元素会保留行尾的换行符这在用printf拼接输出时极易产生意外换行因此-t是最高频的组合选项。# 读取时移除换行符 mapfile source_file -t target_array # 读取时移除自定义分隔符Tab mapfile source_file -d $\t -t target_array-u fd从指定文件描述符读取默认从标准输入读取-u fd将读取来源切换为文件描述符fd。适合在脚本中预先打开多个文件、或在标准输入已被占用时使用例如exec 3 source_file # 打开文件并绑定到描述符 3 mapfile -u 3 target_array # 从描述符 3 读取 exec 3- # 读取完毕后关闭描述符-C callback 与 -c quantum批量读取回调每当读取满quantum行时执行一次callback语句回调执行时bash 会把数组下一个要赋值的下标以及本次刚读取的行作为额外参数传递给callback。-c用于设定量子行数若使用-C而未指定-cquantum默认为 5000。# 每读取 2 行执行一次 echo 语句 mapfile source_file -C echo CALLBACK: -c 2 target_array回调机制适合需要边读边统计如累计行数、实时进度条、逐批校验的场景因为-n的提前截断不会影响回调已触发的次数统计逻辑。参数说明array可选用于输出结果的数组名称。规则如下必须是下标数组而非关联数组这是命令的前提约束若省略数组名默认写入变量名为MAPFILE的数组数组的创建与属性如只读、整型由declare管理相关机制可参考仓库 declare.md 中对declare -a下标数组、declare -A关联数组、declare -r只读属性的说明。返回值命令返回成功除非出现以下异常使用了非法选项指定的数组是只读的指定的数组不是下标数组。这与 declare.md 中只读属性与数组属性均通过declare设置的语义相互印证向只读数组写入必然失败向关联数组按行追加也违反mapfile的线性写入模型。实战示例最常见的三种读取形式# 形式一输入重定向 mapfile source_file target_array # 形式二管道传入cat 输出经由管道进入 mapfile 的标准输入 cat source_file | mapfile target_array # 形式三从文件描述符读取 mapfile -u fd target_array三种形式等价地完成把 source_file 每行写入 target_array。注意管道形式中cat会产生额外进程大文件场景更推荐直接使用输入重定向。限制行数与跳过行数# 只读取前 5 行其余输入被丢弃 mapfile source_file -n 5 target_array # 跳过前 5 行从第 6 行开始读取 mapfile source_file -s 5 target_array两者可组合mapfile source_file -s 5 -n 3 target_array表示跳过 5 行后只取接下来的 3 行。指定起始下标赋值# 在数组指定的下标开始赋值 # 请注意这样做不会清空该数组 mapfile source_file -O 2 target_array若希望从某下标开始且先清空数组则需显式在-O后同时给出下标数值并通过其他手段如target_array()预先清空仅凭提供-O但不给数值这一写法无法同时满足两个意图因为该写法本身即在赋值前清空数组。自定义分隔符读取# 读取时设定行分隔符为 tab # 注意第二行的 tab 在终端需要用 ctrlv tab 输入 mapfile source_file -d $\t target_array mapfile source_file -d target_array$\t是 ANSI-C 引用的转义形式脚本中推荐使用它以保证可读性直接嵌入 Tab 字符的写法在终端里通常需要CtrlV再按Tab才能输入字面 Tab。读取时移除分隔符# 读取时移除行分隔符tab mapfile source_file -d $\t -t target_array # 读取时移除行分隔符换行符 mapfile source_file -t target_array-t是几乎所有生产脚本的标配选项不带-t时每个元素尾部残留\n直接echo ${array[i]}会输出双换行拼接字符串时也会出现意外断行。批量读取回调# 每读取 2 行执行一次语句在这里是 echo mapfile source_file -C echo CALLBACK: -c 2 target_array执行时回调会收到两个额外参数下一个待赋值的数组下标、刚读取到的行。例如将-C定义为echo NEXT_INDEX\$1 LINE\$2即可观察两者的实际取值。遍历数组元素# 遍历下标依次显示数组的元素 for i in ${!target_array[]}; do printf %s ${target_array[i]} done${!target_array[]}展开为数组的全部下标列表相当于 Python 的enumerate语义逐个下标取值输出。配合-t后这里即使使用printf %s也不会出现换行粘连问题若数组中存在以空格开头的元素建议将取值改为printf %s ${target_array[i]}加引号保留完整元素。进阶技巧与边界说明与 while read 循环的取舍while read line; do ...; done file是逐行处理的经典写法但它天然在子 Shell 中运行时无法把结果带出循环管道写法cat file | while read ...尤其明显。mapfile将全部行一次装入当前 Shell 的数组读取结束后变量立即可用代码更短、语义更清晰。若内存敏感超大日志文件再回退到while read流式处理。与兄弟命令的协同read.md 的read -a arrayname把一行内的单词清单读入数组是行内切分mapfile则是按行切分两者互补declare.md 负责声明数组属性declare -a声明下标数组、declare -A声明关联数组、declare -r设置只读属性——mapfile写入的目标必须是非只读的下标数组printf.md 提供无换行的格式化输出配合mapfile -t可实现精确的逐元素打印。环境与版本前提mapfile是 bash 内建命令bash 4 起加入不是独立可执行程序因此需在 bash而非 dash、sh 的某些精简实现环境下运行可先执行bash --version确认版本该命令是 bash 内建命令相关的帮助信息请查看help命令如help mapfilebash 内建命令readarray是mapfile的同义词二者完全等价按习惯选用即可。在 linux-command 仓库中查阅与使用本手册收录于 command/mapfile.md并与declare、read、readonly、printf等 bash 内建命令手册一同构成 linux-command 仓库的命令文档集见 README.md 的仓库定位说明。仓库通过 dist/data.json 生成命令索引其中登记了 mapfile 的名称、路径/mapfile与描述Web 版支持按命令名搜索npm包亦可直接以require(linux-command/command/mapfile.md)方式获取该手册的 Markdown 原文用于二次开发。总结mapfile把读入 切分 入组三步合并为一条内建命令配合-d、-t、-n、-s、-O、-u、-C/-c七类选项即可覆盖从纯文本解析到批量回调的绝大多数脚本需求是 bash 脚本中值得优先掌握的高效文本数组化工具。赞分享文档教程【免费下载链接】linux-commandLinux命令大全搜索工具内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux项目地址https://gitcode.com/GitHub_Trending/linux/linux-command点击查看免费下载相关推荐gin-vue-admin 项目记忆体系基于 AGENT.MD 与 aiDoc/memory 的分层持久化设计gin vue admin 项目记忆体系基于 AGENT.MD 与 aiDoc/memory 的分层持久化设计 导读 本项目gin vue admin在文档教程The Art of Command Line 精读一页掌握 Linux 命令行的高阶实战手册The Art of Command Line 精读一页掌握 Linux 命令行的高阶实战手册 the art of command line 是一份以单页文档教程linux-command 命令手册解读Linux init 命令与运行级别runlevel切换完全指南linux command 命令手册解读Linux init 命令与运行级别runlevel切换完全指南 init 是 Linux 系统中最特殊的命令之一文档教程上一篇深入解析 Dagger TypeScript SDK 的 TypeDefWithInterfaceOpts模块接口类型定义及其底层实现下一篇DataHub Applications 特性深度指南基于业务目的的资产分组与建模创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考