如何使用自定义下载文件夹并简化Puppeteer Sharp的Chromium启动路径？

架构老林

2026-5-29

优化Puppeteer Sharp中Chromium可执行文件的路径定位

我完全懂你手动拼接Chromium路径的繁琐感——其实Puppeteer Sharp早就内置了工具帮你自动处理这件事，不用硬编码那些平台相关的路径片段！

方法一：用`BrowserFetcher`一站式管理下载与路径获取

BrowserFetcher是Puppeteer Sharp推荐的Chromium管理工具，它不仅能帮你下载指定版本，还会自动根据当前平台和版本号生成正确的可执行文件路径，完全不用你手动拼接Win32-{1}\chrome-win32这类片段：

string chromiumDownloadsPath = Path.Combine(baseDirectoryPath, "Puppeteer Sharp downloads");
var browserFetcher = new BrowserFetcher(new BrowserFetcherOptions { Path = chromiumDownloadsPath });
await browserFetcher.DownloadAsync(chromiumRevision);

// 直接获取自动生成的可执行文件路径
var executablePath = browserFetcher.GetExecutablePath(chromiumRevision);

var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    ExecutablePath = executablePath
});

方法二：用`ChromiumExecutablePath`工具类生成路径

如果你还是习惯用Downloader来处理下载，也可以借助ChromiumExecutablePath的静态方法来自动生成路径，它会识别当前运行平台并拼接正确的路径结构：

string chromiumDownloadsPath = Path.Combine(baseDirectoryPath, "Puppeteer Sharp downloads");
Downloader downloader = new Downloader(chromiumDownloadsPath);
await downloader.DownloadRevisionAsync(chromiumRevision);

// 自动生成对应平台的可执行文件路径
var executablePath = ChromiumExecutablePath.GetExecutablePath(chromiumDownloadsPath, chromiumRevision);

var browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    ExecutablePath = executablePath
}, chromiumRevision);