最轻量可靠方式是直接调用Win32 API的SetFileAttributes函数，需用宽字符路径（std::wstring）、按位或组合属性标志，并先获取原属性再清除指定标志，避免误清其他属性。
Windows 下用 SetFileAttributes 修改只读/隐藏属性
直接调用 Win32 API 是最轻量、最可靠的方式，不依赖第三方库，也不需要打开文件内容。关键函数是 SetFileAttributes，它接受文件路径和一组标志位。
常见错误是传入相对路径未转为绝对路径，或路径含中文时没处理宽字符 —— 这会导致函数返回 FALSE 且 GetLastError() 返回 ERROR_PATH_NOT_FOUND 或 ERROR_INVALID_NAME。
- 必须用
LPCWSTR（即const wchar_t*）传路径：推荐用std::wstring+.c_str()，避免窄字符串隐式转换失败 - 只读属性对应
FILE_ATTRIBUTE_READONLY，隐藏属性对应FILE_ATTRIBUTE_HIDDEN；可按位或组合，如FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_HIDDEN - 要清除某属性（比如取消只读），不能直接传剩余标志，而应先用
GetFileAttributes获取当前值，再用按位与取反清除：例如oldAttrs & ~FILE_ATTRIBUTE_READONLY
std::wstring path = L"C:\test.txt";
DWORD attrs = GetFileAttributes(path.c_str());
if (attrs != INVALID_FILE_ATTRIBUTES) {
SetFileAttributes(path.c_str(), attrs | FILE_ATTRIBUTE_READONLY);
}
Linux/macOS 下用 chmod 和 chflags 替代方案
类 Unix 系统没有“只读/隐藏”这种 Windows 风格的文件属性概念，但行为可近似模拟：
- “只读”对应权限位：对普通文件，清除用户写位（
chmod u-w file）即可让fopen("file", "w")失败；C++ 中可用chmod()系统调用，传入0444（只读）或0644（默认） - “隐藏”在 Linux/macOS 中纯属 shell 层约定：文件名以
.开头即被ls忽略；C++ 无法“设隐藏”，只能重命名，如rename("config.txt", ".config.txt") - macOS 支持扩展属性（如
uchg锁定），但需chflags命令或ioctl，且普通用户通常无权设置；不建议在跨平台代码中依赖
注意：chmod 不影响 C++ 的 std::ofstream 打开行为（除非文件系统挂载为只读），它只是限制进程自身权限；真正阻止写入得靠内核权限检查。
立即学习“C++免费学习笔记（深入）”；
跨平台封装时别硬套 Windows 语义
如果项目需同时支持 Windows 和 Linux，不要试图抽象出一个统一的 set_hidden(bool) 接口——Linux 根本没有该语义，强行封装只会埋坑。
- 只在 Windows 构建时启用
SetFileAttributes调用，Linux/macOS 下静默跳过或记录 warning - 若业务逻辑真依赖“是否可见”，应改用配置文件字段或数据库标记，而非文件系统属性
- 读取属性时更危险：Linux 下
GetFileAttributes在 MinGW 或 WSL 中可能返回假值；建议用stat()+ 权限位判断只读，用文件名前缀判断“隐藏”
一个典型误用是：在 Linux 上调用 SetFileAttributes（通过 mingw-w64 工具链编译），结果函数始终返回 FALSE 且不报具体错——因为该 API 在非 Windows 系统上根本未实现，只是 stub。
为什么 std::filesystem::permissions 不够用
C++17 的 std::filesystem 提供了 permissions() 函数，但它只映射 POSIX 权限（owner_read, group_write 等），对 Windows 的 FILE_ATTRIBUTE_HIDDEN 完全无感知。
- 调用
fs::permissions(p, fs::perms::owner_read)在 Windows 上会清除写权限，但不会动HIDDEN或SYSTEM属性 - 它也无法读取当前是否隐藏：即使文件是
.gitignore，fs::status(p).permissions()也只返回0644类权限，和gitignore无关 - 若你用的是较老编译器（如 GCC 8 或 MSVC 2015），
std::filesystem可能未完全实现或存在 race condition，不如直接调 Win32 API 稳定
真正需要跨平台且精确控制属性时，得按平台条件编译，而不是指望标准库兜底。
