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”
关闭以下选项（如果有）：
- Markdown: Use enhanced preview
- Cursor: Enable markdown chat in editor（重要！很多人是这个导致的）
- 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 版本号和操作系统，我再给你更精确的方案。
评论