Final Cut Pro XML需手动处理命名空间、非法字符和时间单位：用XNamespace声明默认命名空间"http://www.apple.com/fcpxml"，读取时用UTF8或Default编码并清理零字节，timecode需正则解析，duration依上下文判别帧或秒，保存时禁用格式化以避免FCP导入失败。
Final Cut Pro XML 是纯文本，别试图用 XmlDocument 加载
Final Cut Pro XML 实际是符合 Apple 定义的特定结构的 XML，但它不是标准的 XML Schema 文档，XmlDocument.Load() 或 XDocument.Load() 很可能直接抛出 XmlException —— 常见报错是 “The ‘xmlns’ attribute is bound to the reserved namespace” 或 “Invalid character in the given encoding”。这不是你文件损坏，而是 FCP XML 里大量使用了 xmlns 前缀混用、未声明的命名空间，甚至包含非 UTF-8 兼容的字节（比如某些时间码字段里的特殊空格）。
实操建议：
- 先用
File.ReadAllText(path, Encoding.UTF8)读取原始内容，手动检查前几行是否含xmlns="http://apple.com/..."类声明； - 若存在多命名空间或默认命名空间，必须用
XNamespace显式声明，不能靠XElement.GetDefaultNamespace()猜； - 对含非法字符的文件，尝试用
Encoding.Default或先用File.ReadAllBytes()+Encoding.UTF8.GetString(bytes).Replace("\u0000", "")清理零字节。
解析 fcpxml 根节点必须处理命名空间
FCP XML 的根元素通常是 <fcpxml version="1.8"></fcpxml>，但实际文档中它几乎总是带默认命名空间：<fcpxml xmlns="http://www.apple.com/fcpxml" version="1.8"></fcpxml>。忽略这个命名空间，所有 Descendants("project") 或 Element("library") 都会返回 null。
实操建议：
- 固定声明命名空间：
XNamespace ns = "http://www.apple.com/fcpxml";； - 查 project 节点要写成
root.Element(ns + "project")，不能写root.Element("project")； - 遍历
clip时注意：它可能在event下，也可能嵌套在sequence→spine→clip中，路径不唯一； - 版本差异敏感：
version="1.7"和version="1.9"的结构有变动（如asset的duration单位从帧变秒），解析前务必检查root.Attribute("version")。
timecode 和 duration 字段单位不统一，别直接当整数用
FCP XML 里的时间字段看似都是数字，实则混合了三种单位：帧数（frame）、秒数（seconds）、SMPTE 时间码字符串（如 01:02:03:15）。最坑的是同一标签名在不同上下文含义不同——duration 在 asset 下是帧数，在 clip 下可能是秒数（取决于 FCP 版本和项目设置）。
实操建议：
- 优先读
asset节点的duration和start，它们更稳定，单位基本是帧； - 遇到
timecode属性（如start="01:02:03:15"），用正则提取四组数字，按HH:MM:SS:FF解析，别依赖TimeSpan.Parse()； - 计算片段入点/出点时，必须结合
rate（帧率）属性：asset下的rate是<rate timebase="30" value="1"></rate>这种结构，需取timebase值； - 导出时间戳时，用
TimeSpan.FromSeconds(totalSeconds)，而非拼接字符串，避免毫秒精度丢失。
修改后保存 XML 必须保留原始缩进与换行，否则 FCP 可能拒绝导入
Final Cut Pro 对 XML 格式极其挑剔：如果用 XDocument.Save() 默认格式化，会把原本紧凑的 <clip name="A" duration="120"></clip> 拆成多行，或把空元素转成 <clip></clip>，导致 FCP 导入失败并静默跳过该片段。
实操建议：
- 不要用
XDocument.Save()直接覆盖原文件； - 用
XDocument.ToString(SaveOptions.DisableFormatting)获取紧凑字符串，再写入； - 若需人工可读，用
XmlWriterSettings手动控制：设置OmitXmlDeclaration = true、Indent = true、NewLineOnAttributes = false； - 保存前做一次轻量校验：用
XmlReader.Create(new StringReader(xmlString))尝试读取，捕获异常可提前发现格式问题。
真正麻烦的从来不是读取结构，而是 FCP 对 XML 的“主观解释”——它会忽略你认为合法的字段，又对空格和换行异常敏感。留一份原始 XML 备份，每次修改后用 FCP 手动导入验证，比写一百行容错逻辑更可靠。
