应使用各语言标准配置目录API而非硬编码路径：Python用platformdirs.user_config_dir()，Node.js用env-paths，Go用os.UserHomeDir()；权限操作需按系统差异处理，避免跨平台静默失败。
Windows 和 macOS/Linux 的配置路径怎么写才通用
硬编码 ~/Library/Preferences 或 C:UsersAliceAppDataRoaming 会导致跨平台程序启动失败或配置丢失。系统差异不在“有没有配置目录”，而在「谁负责创建它」「路径是否可写」「大小写和空格是否敏感」。
- 用语言内置的配置目录 API，而不是拼接字符串：Python 用
appdirs.user_config_dir()（或更现代的platformdirs.user_config_dir()），Node.js 用os.homedir()+path.join()配合process.platform判断，但推荐直接用env-paths或configstore - 避免依赖
~：Shell 下~可展开，但 Go/Python 子进程执行命令时可能不生效；改用os.UserHomeDir()（Go）或pathlib.Path.home()（Python） - macOS 的
~/Library/Application Support默认不可被沙盒 App 写入，若走 MAS 分发，必须用NSApplicationSupportDirectory+NSUserDomainMask查询真实路径，而非硬写
chmod 755 在 Windows 上执行会静默失败
不是所有系统都支持 POSIX 权限，Windows 的 fs.chmodSync() 或 os.chmod() 对普通文件调用后不报错，但权限位根本不生效——下次读取仍是默认 ACL，且不会提醒你。
- 跨平台代码里别假设
chmod一定成功：Node.js 中加try/catch并忽略EPERM或ENOTSUP错误；Python 中用os.chmod()前先hasattr(os, 'chmod') - 真正需要“仅用户可读”时（如密钥文件），Windows 应调用
win32security设置 DACL，macOS/Linux 才靠chmod 600；两者逻辑不同，不能混用同一套判断 - Git for Windows 的 Bash 里
chmod看似有效，实则只改了 Cygwin 层映射，原生 Windows 进程仍无感知——别拿 Git Bash 测试最终行为
路径分隔符用 path.sep，但不要用它切配置文件名
path.sep 解决的是目录层级拼接问题，不是字符串解析工具。用 split(path.sep) 提取文件名，在 Windows 上遇到 C:Configmy.conf 会得到 ['C:', '', 'Config', 'my.conf']，多出空字符串；macOS/Linux 却不会。
- 提取文件名统一用
path.basename()（Node.js）、os.path.basename()（Python）、filepath.Base()（Go）——它们内部已处理盘符、双斜杠等边界 - 拼接路径必须用
path.join()，哪怕你确定只有 ASCII 字符：Windows 下'dir' + path.sep + 'file'在某些旧版 Node.js 里会因path.sep === '\'导致反斜杠被转义成单个字符 - 配置文件扩展名校验（如只加载
.yaml）别用filePath.endsWith('.yaml')，而要用path.extname(filePath) === '.yaml'，否则config.yaml.bak也会被误判
权限赋予失败时，错误信息里藏了系统真相
看到 EPERM 不代表“没权限”，可能是 macOS Gatekeeper 拦截、Windows Defender 阻止、Linux SELinux 限制，或是目标路径在只读文件系统（如 Docker 容器的 /proc 下）。
- Node.js 报
EPERM: operation not permitted：先检查fs.statSync(path).isDirectory()，再确认父目录是否可写；若路径含中文或 emoji，macOS APFS 可能因 Unicode 归一化导致 stat 失败 - Python 报
PermissionError: [Errno 13] Permission denied：在 Windows 上常因文件正被记事本或 VS Code 占用；用lsof -i | grep your_file（macOS/Linux）或handle.exe -a your_file（Windows Sysinternals）查持有者 - Docker 容器内迁移配置时，宿主机挂载的
/host/config若是 NTFS 或 exFAT 格式，Linux 容器里 chmod 会始终失败——这不是代码问题，是文件系统不支持
路径和权限的跨平台适配，本质是接受每个系统有自己的规则，而不是强行统一表象。最危险的不是报错，而是“看起来成功了，其实什么都没发生”。
