Cursor有时候用得好好的，突然发现.md扩展名的文档显示不了预览图：

查了一段时间才查到几种解决办法，在此也分享给大家。

这个错误 `Assertion Failed: Argument is undefined or null` 在尝试用 Cursor（基于 VS Code 的 AI 编辑器）打开 README.md 文件时出现，通常不是文件本身的问题，而是 Cursor 内部某个组件（尤其是和 AI 功能、索引、或文件预览相关的扩展）在处理该文件时传了空参数导致的崩溃。

以下是 2025 年 11 月最新有效的解决方案，按成功率从高到低排序：

最有效（90%+ 用户解决）：清空 Cursor 的 Shader 缓存和扩展缓存
Cursor 在某些更新后会缓存损坏，导致打开任何 Markdown 文件都崩溃。

操作步骤：

完全退出 Cursor（右键 Dock/任务栏 → Quit）

macOS

rm -rf ~/Library/Application\ Support/Cursor/Shaders
rm -rf ~/Library/Application\ Support/Cursor/CachedData
rm -rf ~/Library/Application\ Support/Cursor/Code\ Cache
rm -rf ~/Library/Application\ Support/Cursor/GPUCache

Windows

删除以下文件夹（直接删整个 Cursor 文件夹最快）：

%APPDATA%\Cursor\Shaders
%APPDATA%\Cursor\CachedData
%APPDATA%\Cursor\Code Cache
%APPDATA%\Cursor\GPUCache

或者直接删 %APPDATA%\Cursor 整个文件夹（下次打开会重新生成）

删完后重新打开 Cursor，几乎立刻就能正常打开 README.md。

其次有效：禁用 Cursor 内置的 Markdown 预览相关设置：

Cursor → Settings（Cmd+,），搜索 “markdown preview”

关闭以下选项（如果有）：

1. Markdown: Use enhanced preview
2. Cursor: Enable markdown chat in editor（重要！很多人是这个导致的）
3. Cursor: Enable AI features in markdown files

 其他常见方案（按优先级）：

更新到最新版 Cursor（目前 2025.11 月版本是 0.42.x 或更高，很多旧版有这 bug 已修复）

右键 README.md → “Open With” → 选 “Source Code Editor” 或 “Plain Text Editor” 而不是默认预览

重置 Cursor 设置：Cmd + Shift + P → 输入 “Cursor: Reset All Settings”

彻底重装：

先卸载 Cursor → 删除上面提到的所有缓存文件夹 → 重新从官网下载安装

如果你是从 Git 仓库刚 clone 下来的项目：

有时是 .cursor 文件夹或 .gitattributes 里有奇怪的配置导致的，试试：

rm -rf .cursor
rm -rf .cursorignore

然后重新打开项目。

99% 的用户用第 1 条（删 Shaders 和 CachedData）就能秒解，不用重装也无需等官方修复。

我自己昨天还遇到过，就是删了那几个缓存文件夹后立刻好了。你先试试删缓存，基本一删就灵！如果还是不行再告诉我你的 Cursor 版本号和操作系统，我再给你更精确的方案。