核心问题是libvlc.dll缺失、版本错配、ui线程卡死、拖动无响应；必须严格匹配libvlcsharp与videolan.libvlc.windows版本，wpf中videoview需套windowsformshost，mediaplayer.position设后需显式play()，资源释放须先mediaplayer后libvlc。
WPF 或 WinForms 里用 LibVLCSharp 播视频，核心问题不是“能不能播”，而是“libvlc.dll 找不着、版本不对、UI 线程卡死、拖动没反应”——这四类错误占了实际开发中 90% 的阻塞点。
LibVLCSharp 和 VideoLAN.LibVLC.Windows 版本必须严格一致
装了 LibVLCSharp 但运行时报 System.DllNotFoundException: libvlc.dll，大概率是 NuGet 包和原生 DLL 版本错配。两者版本号（如 4.0.0）必须完全相同，连预发布标记（-beta1）都不能差。
- 用 Package Manager Console 一次性装齐：
Install-Package LibVLCSharp -Version 4.0.0+Install-Package VideoLAN.LibVLC.Windows -Version 4.0.0 - 构建后检查输出目录：
bin/Debug/net6.0-windows/下要有libvlc.dll和libvlccore.dll，且都在x64/或x86/子文件夹里（取决于项目平台目标） - 若手动复制 DLL，请确认它们来自同一版
VideoLAN.LibVLC.Windows包，别混用官网下载的独立 VLC 安装包里的 DLL
WPF 中 VideoView 必须套 WindowsFormsHost 使用
直接在 XAML 里写 <videoview></videoview>，在 WPF 项目中常导致 UI 线程假死或渲染空白——这不是代码写错了，而是 VideoView 底层依赖 Windows Forms 渲染上下文，WPF 原生不兼容。
- 正确做法：XAML 中用
<windowsformshost></windowsformshost>包一层，再把VideoView实例加进去 - 后台代码中初始化顺序不能乱：
Core.Initialize()必须在App.xaml.cs.OnStartup里调用，早于任何窗口创建 - 别在构造函数里直接 new
VideoView后塞进Grid.Children，必须走WindowsFormsHost.Child = videoView
Slider 拖动进度时 MediaPlayer.Position 不生效？检查三件事
拖动滑块后视频跳转但卡住、或根本不动，常见原因是时间单位误用或状态未同步。
-
MediaPlayer.Position是 0.0–1.0 的浮点数（相对位置），不是毫秒或秒；设完player.Position = 0.35后，如果当前是暂停态，必须显式调player.Play()才触发跳转 - 绑定
Slider.Value时，最大值应为1.0，不要用player.Length / 1000.0这类换算——那是给Time属性用的 - 拖动过程中别频繁读写
Position，建议加个if (Math.Abs(oldPos - newPos) > 0.01)防抖，避免渲染线程被压垮
播放 RTSP 或本地 MP4 黑屏无声？先验证媒体源有效性
不是所有 .mp4 都能播——尤其手机录的 H.264+AAC 封装，或带 B-frame 的 RTSP 流，容易因解码器链路断裂而静音/黑屏。
- 先用 VLC 播放器直接打开同一地址，确认能播；不行就换 FFmpeg 转一次：
ffmpeg -i input.mp4 -c:v libx264 -c:a aac -movflags +faststart output.mp4 - RTSP 地址要带完整协议前缀：
rtsp://192.168.1.100:554/stream，不能漏rtsp:// - 加载前加选项提升容错：
new Media(libVLC, url, FromType.FromLocation, "--no-audio", "--no-video-title-show")，排除字幕/音频干扰后再逐个放开
最易被忽略的是资源释放顺序：MediaPlayer 必须在 LibVLC 之前 dispose，否则下次初始化可能失败；WPF 窗口关闭时别只靠 GC，要显式调 _mediaPlayer?.Stop()、_mediaPlayer?.Dispose()、_libVLC?.Dispose()。
