babalae/better-genshin-impact · error · MarkdownRenderException

Markdown 文件不存在：{filePath}

Error message

Markdown 文件不存在：{filePath}

What it means

Error "Markdown 文件不存在：{filePath}" thrown in babalae/better-genshin-impact.

Source

Thrown at BetterGenshinImpact/View/Controls/Markdown/MarkdownView.xaml.cs:559

            throw new MarkdownRenderException("Markdown 与 FilePath 不能同时设置。");
        }

        if (!hasMarkdown && !hasFilePath)
        {
            return null;
        }

        var encoding = SourceEncoding ?? new UTF8Encoding(false);
        if (hasMarkdown)
        {
            var basePath = ResolveBasePath(BasePath);
            return new MarkdownSource(Markdown!, basePath, null, encoding);
        }

        var filePath = ResolveFilePath(FilePath!, BasePath);
        if (!File.Exists(filePath))
        {
            throw new MarkdownRenderException($"Markdown 文件不存在：{filePath}");
        }

        var text = await File.ReadAllTextAsync(filePath, encoding, cancellationToken);
        return new MarkdownSource(text, Path.GetDirectoryName(filePath), filePath, encoding);
    }

    private void ConfigureFileWatcher()
    {
        DisposeFileWatcher();
        if (!WatchFileChanges || string.IsNullOrWhiteSpace(FilePath))
        {
            return;
        }

        try
        {
            var filePath = ResolveFilePath(FilePath, BasePath);
            var directory = Path.GetDirectoryName(filePath);

View on GitHub (pinned to a7cb36712d)

Solutions

1. 检查 Markdown 文件路径是否正确
2. 确认文件未被移动或删除
3. 重新下载对应的文档资源

Example fix

确认 FilePath 指向真实存在的 .md 文件；若用相对路径，检查 BasePath 设置。

When it happens

Trigger: MarkdownView 只设置了 FilePath 而未设置 Markdown 文本时，ResolveFilePath 后的文件在磁盘上不存在，抛出 MarkdownRenderException。

Common situations: Markdown 文件路径配置错误、文件被删除或相对路径基准不对。

AI-assisted analysis of babalae/better-genshin-impact@a7cb36712d (2026-08-13). Data as JSON: /api/errors/ee4c0dcfb17c31a4. Report an issue: GitHub.