最大文件名长度需运行时查询而非依赖宏：linux/macos用pathconf(path, _pc_name_max)，windows用getvolumeinformation获取lpmaximumcomponentlength，二者均返回单个文件名上限，且结果随文件系统和挂载点变化。
Linux/macOS 下用 NAME_MAX，但得先确认文件系统类型
系统级最大文件名长度不是全局统一的，而是由挂载的文件系统决定。比如 ext4 默认是 255，XFS 可达 255，APFS 是 255，但某些网络文件系统（如 NFSv3）可能更低，甚至受服务器端限制。直接硬写 NAME_MAX 很容易在跨文件系统时出错。
-
NAME_MAX定义在<limits.h></limits.h>中，但它只是 POSIX 标准建议值（通常为 255），不反映实际挂载点能力 - 真正可靠的方式是调用
pathconf(path, _PC_NAME_MAX)，传入具体路径（如"."或目标目录） - 如果返回 -1，说明出错，需检查
errno：常见是EINVAL（不支持该查询）或ENOTSUP
示例：
#include <unistd.h>
#include <cerrno>
#include <iostream><p>long max_name_len = pathconf(".", _PC_NAME_MAX);
if (max_name_len == -1) {
std::cerr </p>
<h3>Windows 上没有 <code>NAME_MAX</code>，得用 <code>GetVolumeInformation</code>
</h3>
<p>Windows 不提供编译期常量，也没有等价的 <code>pathconf</code>。它的单文件名长度上限（不含路径）通常是 255 UTF-16 code units，但实际受卷标格式影响——NTFS 支持 255，FAT32 也是 255，而 ReFS 文档未明确限制，实践中仍按 255 处理。</p>
<ul>
<li>必须用 Win32 API <code>GetVolumeInformation</code> 获取 <code>lpMaximumComponentLength</code> 输出参数</li>
<li>该值是运行时查出来的，且只对指定驱动器根路径有效（如 <code>"C:\"</code>），不同驱动器可能不同</li>
<li>注意：它返回的是 *component* 长度（即单个文件/目录名），不是全路径；全路径限制由 <code>MAX_PATH</code>（260）或启用长路径后（32767）决定，二者不能混用</li>
</ul>
<p>关键片段：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master"><img
src="https://img.php.cn/upload/skill/000/000/081/179051228971575.jpg" alt="C++ Code Review Master" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="overflowclass">C++ Code Review Master</a>
<p class="overflowclass">组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。</p>
</div>
<a rel="nofollow" href="/xiazai/skill5502" title="C++ Code Review Master" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<pre class="brush:php;toolbar:false;">#include <windows.h>
DWORD max_comp = 0;
GetVolumeInformation(L"C:\", nullptr, 0, nullptr, &max_comp, nullptr, nullptr, 0);
// max_comp 通常是 255，但也可能为 0（查失败）或更小（如某些网络映射盘）
</windows.h>
跨平台代码别依赖宏，优先走运行时查询
写 C++ 项目时，如果想“一次写完、到处能用”，硬塞 #ifdef _WIN32 + #else + NAME_MAX 是最常见错误。问题在于：NAME_MAX 在 macOS 上可能返回 255，但 APFS 卷若启用了 case-sensitive，实际行为不变；而 Windows 的 MAX_PATH 和组件长度是两回事，混淆会导致创建文件失败却报错 ERROR_FILENAME_EXCED_RANGE 而非更明确的提示。
- 统一用函数式封装：输入路径，输出该路径所在文件系统的单名最大长度
- Linux/macOS 走
pathconf(path, _PC_NAME_MAX)；Windows 走GetVolumeInformation提取根路径再查 - 缓存结果（同一路径多次调用时），但注意：挂载/卸载、USB 拔插会改变结果，不要永久缓存
- 如果只是做路径拼接校验，建议留 5–10 字符余量，避免边界截断（比如 ext4 允许 255，但某些工具会在末尾加
~1）
编译期宏 FILENAME_MAX 是陷阱，别当真
FILENAME_MAX 在 <cstdio></cstdio> 或 <climits></climits> 中定义，但它表示“完整路径字符串最大长度”（如 /home/user/file.txt），不是文件名本身。而且它只是建议值：glibc 中是 4096，musl 是 4096，Windows CRT 是 260 —— 但这些值既不保证可用，也不反映真实限制。
- 它不参与系统调用校验，
open()或CreateFile()失败时不会参考这个宏 - C++20 引入了
std::filesystem::path::filename()，但长度检查仍需运行时做，标准库不提供max_filename_length() - 唯一安全用途：给栈上缓冲区分配空间（如
char buf[FILENAME_MAX]），但现代代码更推荐用std::string或std::vector<char></char>
事情说清了就结束：最大文件名长度从来不是靠一个宏搞定的，它藏在路径背后，得问操作系统，还得问对那个路径。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
