最大文件名长度需运行时查询而非依赖宏：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>中，但它只是 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 << "pathconf failed: " << strerror(errno) << "
";
} else {
std::cout << "Max filename length: " << max_name_len << "
";
}
Windows 上没有 NAME_MAX，得用 GetVolumeInformation
Windows 不提供编译期常量，也没有等价的 pathconf。它的单文件名长度上限（不含路径）通常是 255 UTF-16 code units，但实际受卷标格式影响——NTFS 支持 255，FAT32 也是 255，而 ReFS 文档未明确限制，实践中仍按 255 处理。
- 必须用 Win32 API
GetVolumeInformation获取lpMaximumComponentLength输出参数 - 该值是运行时查出来的，且只对指定驱动器根路径有效（如
"C:\"），不同驱动器可能不同 - 注意：它返回的是 *component* 长度（即单个文件/目录名），不是全路径；全路径限制由
MAX_PATH（260）或启用长路径后（32767）决定，二者不能混用
关键片段：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
#include <windows.h> DWORD max_comp = 0; GetVolumeInformation(L"C:\", nullptr, 0, nullptr, &max_comp, nullptr, nullptr, 0); // max_comp 通常是 255，但也可能为 0（查失败）或更小（如某些网络映射盘）
跨平台代码别依赖宏，优先走运行时查询
写 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> 或 <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>
事情说清了就结束：最大文件名长度从来不是靠一个宏搞定的，它藏在路径背后，得问操作系统，还得问对那个路径。
