用pathlib.path拼接路径可跨平台：以path实例为起点，用/运算符拼接；用户输入路径需先转path；对外输出用as_posix()，本地操作直接传path对象。
用 pathlib.Path 拼接路径，Windows 和 Linux 自动适配
直接用 pathlib.Path 构造路径对象，再用 / 运算符拼接，就能跨平台。它内部会根据当前操作系统自动选择 或 / 作为分隔符，不需要手动判断 os.name 或调用 os.path.join。
常见错误是仍用字符串拼接："data/" + filename 或 r"C:config" + " est.json"——这在 Windows 上可能侥幸通过，但换到 Linux 就出错，且反斜杠转义容易引发 UnicodeDecodeError 或路径截断。
- 始终从一个
Path实例开始，比如Path("data")或Path.cwd() - 后续用
/（不是字符串除法，是重载运算符）拼接子路径或文件名：base / "subdir" / "file.txt" - 传入的路径片段可以是字符串、
Path对象，甚至os.PathLike实现，都兼容
处理用户输入的原始路径字符串要先转成 Path
如果从命令行参数、配置文件或用户表单拿到一串路径字符串（比如 "./logs/error.log" 或 "C:\temp\out"），不能直接和 Path 对象相加，必须先用 Path() 包裹一次。
否则会触发 TypeError: unsupported operand type(s) for /: 'PosixPath' and 'str'（Python 3.12+ 更严格）；老版本虽能隐式转换，但行为不可靠，尤其含 Windows 风格反斜杠时。
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
- 正确写法：
Path(user_input) / "result.json" - 错误写法：
Path("output") / user_input（user_input 是 str，且含时可能被误解析） - 若需规范化路径（如展开
~、解析..），再链式调用.resolve()，但注意它会访问文件系统——测试时若目标不存在会抛FileNotFoundError
Path 对象的 as_posix() 和 __str__() 行为差异
打印 Path 对象时，默认调用 __str__()，返回带本地分隔符的字符串（Windows 是 ，Linux 是 /）。但很多工具链（如 JSON 配置、HTTP URL 构造、Docker volume 参数）强制要求 POSIX 风格斜杠，这时就得显式调用 .as_posix()。
典型踩坑场景：用 json.dump({"path": str(p)}) 把 Windows 路径写进配置，结果 CI 流水线在 Linux 上读取时报错——因为 C:datainput 在 JSON 里变成 C: atainput（ 和 i 被当转义）。
- 对外输出通用路径（日志、API、配置文件），优先用
p.as_posix() - 仅用于本地文件操作（
open(p)、p.exists()），直接传Path对象即可，无需转字符串 -
str(p)只在调试打印或与旧代码兼容时使用，避免嵌入到结构化数据中
相对路径起点不明确时，用 Path.cwd() 或 Path(__file__).parent
跨平台脚本常因相对路径基准不同而失败。比如 Path("config.yaml") 总是相对于当前工作目录（cwd），但用户可能从任意目录运行脚本；而 Path(__file__).parent / "data" 才真正相对于脚本所在位置，更可靠。
另一个陷阱是混合使用 os.getcwd() 和 Path：有人写 Path(os.getcwd()) / "cache"，看似等价，实则多此一举，且丢失了 Path 的链式能力。
- 想定位“和当前 Python 文件同级的资源”，统一用
Path(__file__).parent / "assets" - 想定位“用户执行命令时的目录下的子目录”，用
Path.cwd() / "output"，但需文档注明该行为 - 避免
os.chdir()后再构造路径——Path.cwd()会变，但__file__始终稳定
Path 类型贯穿，而不是某处偷偷转成字符串又拼接。一旦漏掉一个，跨平台就断在那个点上。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
