SaveFileDialog.ShowDialog() 返回 DialogResult.Cancel 的常见原因包括用户点击“取消”或关闭对话框，此时 FileName 为空，需先判断 DialogResult.OK 再读取；InitialDirectory 无效时可能静默退至默认路径；Filter 格式错误（如缺竖线、空格、扩展名格式不对）导致选项不显示；FilterIndex 从1开始；OverwritePrompt=true 仅对手动输入路径生效；文本保存需显式指定 Encoding.UTF8 避免乱码或 BOM 问题。
SaveFileDialog.ShowDialog() 返回 DialogResult.Cancel 的常见原因
调用 ShowDialog() 后得不到文件路径，多半不是代码写错了，而是用户点了“取消”或关闭了对话框。它返回的是 DialogResult.Cancel 而非 DialogResult.OK，此时 FileName 属性为空字符串——直接拿去写文件会抛 ArgumentException（“路径不能为空”）。
- 必须先判断
dialogResult == DialogResult.OK，再读取FileName -
InitialDirectory设为不存在的路径时，对话框可能退回到系统默认位置，但不会报错，容易误以为初始化失败 - 如果设置了
CheckPathExists = true（默认为true），而InitialDirectory是空或非法路径，对话框可能静默失败或弹出警告，行为因 Windows 版本略有差异
设置 Filter 时下拉列表不显示自定义格式名
Filter 字符串格式是 “显示名称|扩展名”，中间用竖线分隔，且每组之间用 | 连接。少一个竖线、多一个空格、扩展名没带点，都会导致该选项不出现或无法选中。
- 正确写法：
"文本文件|*.txt|JSON 文件|*.json|所有文件|*.*" - 错误写法：
"文本文件 (*.txt)"（缺竖线分隔符）、"TXT|*.TXT"（Windows 对大小写不敏感，但习惯用小写更稳） - 若想默认选中第二项，需设置
FilterIndex = 2；不设则默认为 1，且索引从 1 开始（不是 0）
保存前未检查文件是否已存在导致覆盖无提示
SaveFileDialog 默认不检查目标文件是否存在，也不会自动弹出“是否覆盖”确认框——那是你自己的责任。
- 启用
OverwritePrompt = true，系统会在用户输入已存在文件名时自动弹窗询问 - 若禁用了该选项（比如做日志归档场景），应手动用
File.Exists(dialog.FileName)判断，并自行决定是否调用MessageBox.Show(...) - 注意：
OverwritePrompt只对用户在编辑框里手动输入的路径生效；通过双击已有文件选择的路径，即使存在也不会触发提示
用 FileStream 写入时 Encoding 不匹配导致中文乱码
保存文本文件时，SaveFileDialog 只管选路径，不管内容编码。如果你用 StreamWriter 写入中文却没指定编码，会默认用系统 ANSI（如 GBK），而现代应用通常期望 UTF-8。
- 安全写法：
new StreamWriter(dialog.FileName, false, Encoding.UTF8) - 避免直接用
File.WriteAllText(path, content)—— 它默认 UTF-8 BOM，但某些旧工具（如 Excel CSV 导入）会把 BOM 当作乱码；可显式传Encoding.UTF8并设new UTF8Encoding(encoderShouldEmitUTF8Identifier: false) - 若保存二进制数据（如图片、序列化对象），别用文本流，改用
File.OpenWrite()或new FileStream(..., FileMode.Create)
DialogResult 判断和 OverwritePrompt 的语义理解——前者导致空路径异常，后者导致静默覆盖。这两个点不处理好，功能看似跑通，上线后用户一操作就出问题。 
