curl--output-dir详解为-o与-O统一指定文件保存目录【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl--output-dir是 curl 命令行工具当前仓库为 curl 官方源码库文档位于 docs/cmdline-opts/output-dir.md中用于统一指定输出文件保存目录的输出类选项。它解决了一个很常见的痛点在使用--remote-name-O或--output-o下载文件时默认文件都会落到当前工作目录导致目录混乱、难以管理。本文将以该选项为主线完整讲解其语法、作用范围、与--create-dirs、--next等选项的协作关系并结合 src/tool_getparam.c、src/tool_operate.c、src/tool_dirhie.c 等源码剖析其底层实现。读完本文你将能熟练地把下载文件定向到任意目录并理解多 URL、多输出选项、--next分段配置下的实际行为。一、选项速览属性值长选项--output-dir参数dir必填拒绝空值帮助文本Directory to save files in加入版本curl 7.73.0分类outputMulti 语义single全局单一取值作用于其后所有 URL关联选项--remote-name、--remote-header-name、--create-dirs、--next官方示例--output-dir tmp -O $URL该选项在命令行参数表中注册为C_OUTPUT_DIR对应的解析代码位于 src/tool_getparam.ccase C_OUTPUT_DIR: /* --output-dir */ err getstr(config-output_dir, nextarg, DENY_BLANK); break;注意其中的DENY_BLANK标志--output-dir的参数不允许为空字符串这与文档中必须指定目录的语义一致。解析得到的值最终保存在配置结构体的output_dir字段中见 src/tool_cfgable.h并在 src/tool_cfgable.c 中随配置一起释放。二、作用与使用前提2.1 核心语义按文档原文--output-dir用于指定文件应存放的目录前提是配合--remote-name或--output使用Specify the directory in which files should be stored, when --remote-name or --output are used.也就是说它本身不产生输出文件只负责把输出文件放进哪个目录。它同时作用于命令中所有 URL 和所有输出选项直到遇到第一个--next为止The given output directory is used for all URLs and output options on the command line, up until the first --next.2.2 最小可用示例# 把远程文件下载到当前目录下的 tmp/ 子目录 curl --output-dir tmp -O https://example.com/file1.txt # 等价写法-O 与 --output-dir 顺序无关 curl -O --output-dir tmp https://example.com/file1.txt # 与 -o 配合把输出文件放到 tmp/ 下 curl --output-dir tmp -o result.html https://example.com/2.3 目录不存在时的行为文档明确如果目标目录不存在操作失败除非同时使用--create-dirsIf the specified target directory does not exist, the operation fails unless --create-dirs is also used.对应实践# 目录 downloads 不存在 → 失败 curl --output-dir downloads -O https://example.com/file1.txt # 配合 --create-dirs → 自动创建 downloads 目录后下载成功 curl --output-dir downloads --create-dirs -O https://example.com/file1.txt三、与--output-o的配合3.1-o简介--output短选项-o见 docs/cmdline-opts/output.md把输出写入指定文件而非 stdout支持 URL 通配globbing时用#1、#2等占位符生成多个文件也支持为多个 URL 依次指定多个-o。文档示例curl http://{one,two}.example.com -o file_#1.txt curl http://{site,host}.host[1-5].example -o #1_#2 curl -o aa example.com -o bb example.net3.2 组合使用与路径拼接实现当同时给出--output-dir时curl 会把目录与文件名拼接成最终输出路径。这一逻辑在 src/tool_operate.c 中实现if(config-output_dir *config-output_dir) { char *d curl_maprintf(%s/%s, config-output_dir, per-outfile); curlx_safefree(per-outfile); if(d) { per-outfile curlx_strdup(d); /* move to right memory */ curl_free(d); } if(!d || !per-outfile) return CURLE_WRITE_ERROR; }可以清楚看到拼接方式目录与文件名之间用单个/连接。因此--output-dir tmp -o result.html等价于输出到tmp/result.html--output-dir downloads --create-dirs -o archive/x.zip最终写入downloads/archive/x.zip且两级目录都会被创建。注意拼接是简单的字符串连接不会自动去除目录尾部多余的斜杠例如--output-dir tmp/ -o a.txt会产生tmp//a.txt这种双斜杠路径多数文件系统仍可正常工作但不推荐。3.3 目录创建逻辑拼接完成后若设置了--create-dirs会调用目录层级创建函数if(config-create_dirs) { CURLcode result create_dir_hierarchy(per-outfile); /* create_dir_hierarchy shows error upon CURLE_WRITE_ERROR */ if(result) return result; }该函数实现在 src/tool_dirhie.c其要点包括沿路径逐段解析目录并调用mkdir创建出的目录权限为0750Unix 风格文件系统对EEXIST目录已存在与EACCES无权限允许继续遍历两类错误宽容处理其余错误返回CURLE_WRITE_ERRORWindows/MS-DOS 下会跳过对单独盘符如X:的创建避免误建以盘符命名的目录路径分隔符在 Windows/DJGPP 下同时识别\与/在其他平台仅使用平台默认分隔符。这也印证了 docs/cmdline-opts/create-dirs.md 的说明--create-dirs创建的是--output指定的路径与--output-dir指定路径合并后所需的目录层级若合并后的文件名不含目录或目录已存在则不创建任何目录。四、与--remote-name-O的配合4.1-O简介--remote-name短选项-O见 docs/cmdline-opts/remote-name.md把输出写入以远程文件名为名的本地文件只取 URL 中文件名部分路径被丢弃默认保存在当前工作目录。文档明确指出若想换目录要么先cd要么使用--output-dirThe file is saved in the current working directory. If you want the file saved in a different directory, make sure you change the current working directory before invoking curl with this option or use --output-dir.4.2 组合使用# 将远程文件按原文件名保存到 downloads/ 目录 curl --output-dir downloads -O https://example.com/photo.jpg # 多文件批量下载到同一目录 curl --output-dir downloads -O https://example.com/a.zip -O https://example.com/b.zip4.3 与--remote-header-name的组合实现当-O再配合--remote-header-name-J文件名改由服务器返回的Content-Disposition头决定。此时--output-dir依然生效在 src/tool_cb_hdr.c 的set_filename()函数中从响应头解析出的文件名同样会被拼接到output_dir下if(per-config-output_dir) { char *f curl_maprintf(%s/%s, per-config-output_dir, filename); curlx_free(filename); if(!f) return FALSE; outs-filename curlx_strdup(f); curl_free(f); if(!outs-filename) return FALSE; }需要特别留意的一个行为差异remote-name.md 中注明-O按 URL 提取的文件名若已存在会直接覆盖而-J下由服务器指定的文件名若已存在则不会覆盖。目录不存在时两者一致都需要--create-dirs兜底。五、作用范围与--next分段5.1 覆盖全部 URL 与输出选项--output-dir是Multi: single类选项其值作用于命令行中所有URL 与输出选项-o、-O、-J等例如# 两个 -O 的输出都落在 downloads/ 下 curl --output-dir downloads -O https://example.com/1.txt -O https://example.com/2.txt5.2--next重置作用域--next短选项:见 docs/cmdline-opts/next.md用于为后续 URL 启用一组全新选项构成独立的操作段。文档原文强调--output-dir的取值仅持续到第一个--next因此# 第一段下载到 dir1/第二段下载到 dir2/重新指定 curl --output-dir dir1 -O https://example.com/a.txt \ --next --output-dir dir2 -O https://example.com/b.txt # 第二段若不重新指定 --output-dir则文件落在当前工作目录 curl --output-dir dir1 -O https://example.com/a.txt \ --next -O https://example.com/b.txt这与--next的通用语义一致本地选项local options在--next处被重置只有全局选项如--verbose、--trace、--fail-early的值会跨越--next延续--output-dir属于前者。六、典型实战组合6.1 自动创建目录并下载curl --create-dirs --output-dir downloads/2026/09 -O https://example.com/report.pdfdownloads/2026/09两级目录在需要时按 0750 权限创建report.pdf 按远程文件名落入其中。6.2 多 URL 多格式输出到统一目录curl --output-dir media \ -O https://example.com/img/logo.png \ -o index.html https://example.com/ \ -O https://example.com/data.json所有输出无论来自-O还是-o都被定向到media/。6.3 配合 URL globbing 生成多个文件curl --output-dir pics https://example.com/img[1-5].jpg -o img_#1.jpg最终生成pics/img_1.jpgpics/img_5.jpg目录仅需指定一次。6.4 目录不存在时的典型报错现象在不加--create-dirs时若目录不存在curl 会在写入阶段返回写入类错误对应源码中CURLE_WRITE_ERROR路径表现为下载中断或失败。排查步骤确认--output-dir指定的目录是否存在ls -ld dir确认写入权限目录需要可写、可执行进入权限需要自动建目录时补上--create-dirs。七、源码级小结参数解析src/tool_getparam.c 使用DENY_BLANK拒绝空参数写入config-output_dir-o路径拼接src/tool_operate.c 以%s/%s形式拼接目录与文件名-J文件名拼接src/tool_cb_hdr.c 将Content-Disposition解析出的文件名拼入output_dir目录创建src/tool_dirhie.c 逐段mkdir权限 0750宽容处理EEXIST/EACCES配置生命周期src/tool_cfgable.h 定义字段src/tool_cfgable.c 负责释放。八、常见问题速查问题答案--output-dir能单独使用吗不能产生效果必须配合-o或-O及其衍生如-J目录不存在会怎样失败配合--create-dirs自动创建创建的目录权限是什么Unix 下 0750对多个 URL 生效吗生效作用于命令中所有 URL 与输出选项--next之后还生效吗不生效每个--next之后需要重新指定参数能为空吗不能解析时DENY_BLANK直接拒绝目录尾部的/会被去掉吗不会属于简单字符串拼接避免书写多余斜杠Windows 下路径分隔符\与/均被create_dir_hierarchy识别掌握--output-dir之后结合 docs/cmdline-opts/output.md、docs/cmdline-opts/remote-name.md、docs/cmdline-opts/create-dirs.md 与 docs/cmdline-opts/next.md 等关联文档即可在批量下载、镜像抓取等场景中把输出文件管理得井井有条。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 curl `--output-dir` 详解：为 `-o` 与 `-O` 统一指定文件保存目录
curl--output-dir详解为-o与-O统一指定文件保存目录【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl--output-dir是 curl 命令行工具当前仓库为 curl 官方源码库文档位于 docs/cmdline-opts/output-dir.md中用于统一指定输出文件保存目录的输出类选项。它解决了一个很常见的痛点在使用--remote-name-O或--output-o下载文件时默认文件都会落到当前工作目录导致目录混乱、难以管理。本文将以该选项为主线完整讲解其语法、作用范围、与--create-dirs、--next等选项的协作关系并结合 src/tool_getparam.c、src/tool_operate.c、src/tool_dirhie.c 等源码剖析其底层实现。读完本文你将能熟练地把下载文件定向到任意目录并理解多 URL、多输出选项、--next分段配置下的实际行为。一、选项速览属性值长选项--output-dir参数dir必填拒绝空值帮助文本Directory to save files in加入版本curl 7.73.0分类outputMulti 语义single全局单一取值作用于其后所有 URL关联选项--remote-name、--remote-header-name、--create-dirs、--next官方示例--output-dir tmp -O $URL该选项在命令行参数表中注册为C_OUTPUT_DIR对应的解析代码位于 src/tool_getparam.ccase C_OUTPUT_DIR: /* --output-dir */ err getstr(config-output_dir, nextarg, DENY_BLANK); break;注意其中的DENY_BLANK标志--output-dir的参数不允许为空字符串这与文档中必须指定目录的语义一致。解析得到的值最终保存在配置结构体的output_dir字段中见 src/tool_cfgable.h并在 src/tool_cfgable.c 中随配置一起释放。二、作用与使用前提2.1 核心语义按文档原文--output-dir用于指定文件应存放的目录前提是配合--remote-name或--output使用Specify the directory in which files should be stored, when --remote-name or --output are used.也就是说它本身不产生输出文件只负责把输出文件放进哪个目录。它同时作用于命令中所有 URL 和所有输出选项直到遇到第一个--next为止The given output directory is used for all URLs and output options on the command line, up until the first --next.2.2 最小可用示例# 把远程文件下载到当前目录下的 tmp/ 子目录 curl --output-dir tmp -O https://example.com/file1.txt # 等价写法-O 与 --output-dir 顺序无关 curl -O --output-dir tmp https://example.com/file1.txt # 与 -o 配合把输出文件放到 tmp/ 下 curl --output-dir tmp -o result.html https://example.com/2.3 目录不存在时的行为文档明确如果目标目录不存在操作失败除非同时使用--create-dirsIf the specified target directory does not exist, the operation fails unless --create-dirs is also used.对应实践# 目录 downloads 不存在 → 失败 curl --output-dir downloads -O https://example.com/file1.txt # 配合 --create-dirs → 自动创建 downloads 目录后下载成功 curl --output-dir downloads --create-dirs -O https://example.com/file1.txt三、与--output-o的配合3.1-o简介--output短选项-o见 docs/cmdline-opts/output.md把输出写入指定文件而非 stdout支持 URL 通配globbing时用#1、#2等占位符生成多个文件也支持为多个 URL 依次指定多个-o。文档示例curl http://{one,two}.example.com -o file_#1.txt curl http://{site,host}.host[1-5].example -o #1_#2 curl -o aa example.com -o bb example.net3.2 组合使用与路径拼接实现当同时给出--output-dir时curl 会把目录与文件名拼接成最终输出路径。这一逻辑在 src/tool_operate.c 中实现if(config-output_dir *config-output_dir) { char *d curl_maprintf(%s/%s, config-output_dir, per-outfile); curlx_safefree(per-outfile); if(d) { per-outfile curlx_strdup(d); /* move to right memory */ curl_free(d); } if(!d || !per-outfile) return CURLE_WRITE_ERROR; }可以清楚看到拼接方式目录与文件名之间用单个/连接。因此--output-dir tmp -o result.html等价于输出到tmp/result.html--output-dir downloads --create-dirs -o archive/x.zip最终写入downloads/archive/x.zip且两级目录都会被创建。注意拼接是简单的字符串连接不会自动去除目录尾部多余的斜杠例如--output-dir tmp/ -o a.txt会产生tmp//a.txt这种双斜杠路径多数文件系统仍可正常工作但不推荐。3.3 目录创建逻辑拼接完成后若设置了--create-dirs会调用目录层级创建函数if(config-create_dirs) { CURLcode result create_dir_hierarchy(per-outfile); /* create_dir_hierarchy shows error upon CURLE_WRITE_ERROR */ if(result) return result; }该函数实现在 src/tool_dirhie.c其要点包括沿路径逐段解析目录并调用mkdir创建出的目录权限为0750Unix 风格文件系统对EEXIST目录已存在与EACCES无权限允许继续遍历两类错误宽容处理其余错误返回CURLE_WRITE_ERRORWindows/MS-DOS 下会跳过对单独盘符如X:的创建避免误建以盘符命名的目录路径分隔符在 Windows/DJGPP 下同时识别\与/在其他平台仅使用平台默认分隔符。这也印证了 docs/cmdline-opts/create-dirs.md 的说明--create-dirs创建的是--output指定的路径与--output-dir指定路径合并后所需的目录层级若合并后的文件名不含目录或目录已存在则不创建任何目录。四、与--remote-name-O的配合4.1-O简介--remote-name短选项-O见 docs/cmdline-opts/remote-name.md把输出写入以远程文件名为名的本地文件只取 URL 中文件名部分路径被丢弃默认保存在当前工作目录。文档明确指出若想换目录要么先cd要么使用--output-dirThe file is saved in the current working directory. If you want the file saved in a different directory, make sure you change the current working directory before invoking curl with this option or use --output-dir.4.2 组合使用# 将远程文件按原文件名保存到 downloads/ 目录 curl --output-dir downloads -O https://example.com/photo.jpg # 多文件批量下载到同一目录 curl --output-dir downloads -O https://example.com/a.zip -O https://example.com/b.zip4.3 与--remote-header-name的组合实现当-O再配合--remote-header-name-J文件名改由服务器返回的Content-Disposition头决定。此时--output-dir依然生效在 src/tool_cb_hdr.c 的set_filename()函数中从响应头解析出的文件名同样会被拼接到output_dir下if(per-config-output_dir) { char *f curl_maprintf(%s/%s, per-config-output_dir, filename); curlx_free(filename); if(!f) return FALSE; outs-filename curlx_strdup(f); curl_free(f); if(!outs-filename) return FALSE; }需要特别留意的一个行为差异remote-name.md 中注明-O按 URL 提取的文件名若已存在会直接覆盖而-J下由服务器指定的文件名若已存在则不会覆盖。目录不存在时两者一致都需要--create-dirs兜底。五、作用范围与--next分段5.1 覆盖全部 URL 与输出选项--output-dir是Multi: single类选项其值作用于命令行中所有URL 与输出选项-o、-O、-J等例如# 两个 -O 的输出都落在 downloads/ 下 curl --output-dir downloads -O https://example.com/1.txt -O https://example.com/2.txt5.2--next重置作用域--next短选项:见 docs/cmdline-opts/next.md用于为后续 URL 启用一组全新选项构成独立的操作段。文档原文强调--output-dir的取值仅持续到第一个--next因此# 第一段下载到 dir1/第二段下载到 dir2/重新指定 curl --output-dir dir1 -O https://example.com/a.txt \ --next --output-dir dir2 -O https://example.com/b.txt # 第二段若不重新指定 --output-dir则文件落在当前工作目录 curl --output-dir dir1 -O https://example.com/a.txt \ --next -O https://example.com/b.txt这与--next的通用语义一致本地选项local options在--next处被重置只有全局选项如--verbose、--trace、--fail-early的值会跨越--next延续--output-dir属于前者。六、典型实战组合6.1 自动创建目录并下载curl --create-dirs --output-dir downloads/2026/09 -O https://example.com/report.pdfdownloads/2026/09两级目录在需要时按 0750 权限创建report.pdf 按远程文件名落入其中。6.2 多 URL 多格式输出到统一目录curl --output-dir media \ -O https://example.com/img/logo.png \ -o index.html https://example.com/ \ -O https://example.com/data.json所有输出无论来自-O还是-o都被定向到media/。6.3 配合 URL globbing 生成多个文件curl --output-dir pics https://example.com/img[1-5].jpg -o img_#1.jpg最终生成pics/img_1.jpgpics/img_5.jpg目录仅需指定一次。6.4 目录不存在时的典型报错现象在不加--create-dirs时若目录不存在curl 会在写入阶段返回写入类错误对应源码中CURLE_WRITE_ERROR路径表现为下载中断或失败。排查步骤确认--output-dir指定的目录是否存在ls -ld dir确认写入权限目录需要可写、可执行进入权限需要自动建目录时补上--create-dirs。七、源码级小结参数解析src/tool_getparam.c 使用DENY_BLANK拒绝空参数写入config-output_dir-o路径拼接src/tool_operate.c 以%s/%s形式拼接目录与文件名-J文件名拼接src/tool_cb_hdr.c 将Content-Disposition解析出的文件名拼入output_dir目录创建src/tool_dirhie.c 逐段mkdir权限 0750宽容处理EEXIST/EACCES配置生命周期src/tool_cfgable.h 定义字段src/tool_cfgable.c 负责释放。八、常见问题速查问题答案--output-dir能单独使用吗不能产生效果必须配合-o或-O及其衍生如-J目录不存在会怎样失败配合--create-dirs自动创建创建的目录权限是什么Unix 下 0750对多个 URL 生效吗生效作用于命令中所有 URL 与输出选项--next之后还生效吗不生效每个--next之后需要重新指定参数能为空吗不能解析时DENY_BLANK直接拒绝目录尾部的/会被去掉吗不会属于简单字符串拼接避免书写多余斜杠Windows 下路径分隔符\与/均被create_dir_hierarchy识别掌握--output-dir之后结合 docs/cmdline-opts/output.md、docs/cmdline-opts/remote-name.md、docs/cmdline-opts/create-dirs.md 与 docs/cmdline-opts/next.md 等关联文档即可在批量下载、镜像抓取等场景中把输出文件管理得井井有条。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考