WasmEdge 在 macOS 上的安装问题与解决方案

WasmEdge 是一个轻量级、高性能的 WebAssembly 运行时，适用于云原生、边缘计算等场景。本文将详细介绍在 macOS 系统上安装 WasmEdge 时可能遇到的证书问题和插件安装问题，并提供相应的解决方案。

证书问题的背景与解决

在 macOS 系统上使用 Python 安装 WasmEdge 时，可能会遇到 SSL 证书验证失败的问题。这是因为某些 Python 环境没有正确配置证书路径导致的。具体表现为安装脚本无法验证 GitHub 的 SSL 证书。

解决方案是手动下载最新的 CA 证书包，并将其路径配置到环境变量中：

1. 下载最新的 cacert.pem 文件
2. 在用户配置文件（如 .zprofile）中添加以下环境变量：

   export SSL_CERT_FILE=~/cacert.pem
   export REQUESTS_CA_BUNDLE=~/cacert.pem
   

这样配置后，Python 的 SSL 验证就能正常工作，安装脚本可以顺利下载 WasmEdge 的安装包。

WASI 插件安装问题

WasmEdge 提供了多种 WASI 插件来扩展其功能。在安装过程中，用户可能会尝试同时安装 wasi_logging 和 wasi_nn-ggml 插件：

curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- --plugins wasi_logging wasi_nn-ggml

这时会出现 404 错误，提示无法下载 wasi_logging 插件。这是因为从 WasmEdge 0.14.1 版本开始，wasi_logging 功能已经被直接集成到主库中，不再作为单独的插件提供。

正确的安装方式

对于只需要基本功能的用户，可以直接安装 WasmEdge 核心运行时：

curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash

如果需要 wasi_nn-ggml 插件来支持机器学习功能，可以使用以下命令：

curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- --plugins wasi_nn-ggml

安装完成后，可以通过以下命令验证安装是否成功：

wasmedge --version

输出中会显示已安装的插件信息，包括直接集成在核心中的 wasi_logging 功能。

总结

在 macOS 上安装 WasmEdge 时，需要注意 Python 环境的 SSL 证书配置。对于插件安装，用户应该了解哪些功能已经集成到核心中，哪些仍需要单独安装。随着 WasmEdge 的发展，更多的功能可能会从插件迁移到核心库中，因此建议用户查阅最新文档了解功能分布情况。