WAMR-IDE 开发环境完全指南在 VSCode 中一站式完成 WebAssembly 编码、编译与源码调试【免费下载链接】fluent-bitFast and Lightweight Logs, Metrics and Traces processor for Linux, BSD, OSX and Windows项目地址: https://gitcode.com/GitHub_Trending/fl/fluent-bit本文基于lib/wasm-micro-runtime-WAMR-2.4.1/test-tools/wamr-ide/README.md编写。WAMR-IDE 是 wasm-micro-runtimeWAMR附带的实验性集成开发环境它将「编码、编译、运行与源码级调试」WebAssembly 应用的能力整合进 VSCode扩展负责项目管理与交互两个 Docker 镜像分别提供构建工具链与运行调试环境。读完本文你将掌握从零安装 WAMR-IDE、通过 VSCode 扩展市场或本地源码两种途径部署扩展以及完成新建项目、定制编译配置、一键 Build / Run / Debug 的完整实战流程并了解其底层 Docker 镜像与 TypeScript 扩展的实现原理。WAMR-IDE 简介三大组件如何协作WAMR-IDE 是 WAMR 官方提供的、用于开发 WebAssembly 应用的集成开发环境实验性功能核心目标是让开发者能在 VSCode 中完成从编写代码到源码级调试的完整闭环。它由三个组件构成详见 README.mdVSCode 扩展VSCode extension负责构建与管理工程支持创建项目、编译build、运行run与调试debugWebAssembly 应用WASM-toolchain Docker 镜像为 wasm 提供编译构建环境WASM source debug server Docker 镜像为 wasm 应用提供运行与源码调试环境。三个组件的职责边界在 Dockerfile 中清晰可见WASM-Toolchain/Docker/Dockerfile 基于gcc:12.2.0构建内部安装ccache、ninja-build、make、cmake、python3-pip并预先部署wasi-sdk 19.0WASI 编译工具链、wamrcWAMR 的 AOT 编译器被软链到/usr/bin/wamrc以及wamr-sdk/appWAMR SDK 的 app 目录内含wamr_toolchain.cmake最终产物是提供 wasm 编译能力的工具链镜像WASM-Debug-Server/Docker/Dockerfile 同样基于gcc:12.2.0通过cmake .. -DWAMR_BUILD_DEBUG_INTERP1开启WAMR 调试解释器debug interpreter构建iwasmWAMR 的独立运行程序并附带debug.sh与run.sh两个运行脚本为 wasm 应用提供运行与调试能力。从源码结构可以推断这套设计把「编译」与「运行/调试」彻底容器化宿主机只需要 VSCode 与 Docker即可获得完全一致的跨平台开发体验。安装前的环境准备WAMR-IDE 依赖宿主机上的两个基础软件VSCode版本至少为1.59.0见 VSCode-Extension/package.json 中engines.vscode: ^1.59.0的约束。请从官方渠道下载安装Docker用于拉起 toolchain 与 debug-server 两个镜像。Windows安装 Docker DesktopUbuntu安装 Docker Engine官方要求 64 位系统且支持 Ubuntu Impish 21.10、Hirsute 21.04、Focal 20.04 (LTS)、Bionic 18.04 (LTS) 等版本。安装 WAMR-IDE 扩展的三种途径官方提供了三条安装路径按推荐优先级排列如下。途径一从 VSCode 扩展市场直接安装最省力当前最直接的安装方式是在 VSCode 扩展市场中搜索WAMR-IDE并直接安装。如果你只是想快速使用 WAMR 的调试能力这是理想选择。安装完成后可直接进入「使用 WAMR-IDE」章节。官方建议只安装1.3.2 之后的版本。途径二从 GitHub Release 下载推荐做法WAMR 的每次 GitHub Release 都会打包同版本号的 Docker 镜像 tar 包、lldb 二进制以及 .vsix 扩展安装文件可以完全离线使用。第 1 步加载 Docker 镜像从 Release 页面下载wasm-toolchain-{版本号}与wasm-debug-server-{版本号}的 zip/tar.gz 包解压后用docker load导入# Linux / macOS使用 tar 解压 tar xf wasm-toolchain-{version number}.tar.gz tar xf wasm-debug-server-{version number}.tar.gz # 或者使用 unzip unzip wasm-toolchain-{version number}.zip unzip wasm-debug-server-{version number}.zip # 加载 wasm-toolchain docker load --input wasm-toolchain.tar # 加载 wasm-debug-server docker load --input wasm-debug-server.tar # Windows可用任意解压软件解压然后在 PowerShell 或 git bash 中加载 docker load --input ./wasm-toolchain.tar docker load --input ./wasm-debug-server.tar第 2 步下载扩展安装文件Release 中提供同版本的wamr-ide-{版本号}.tar.gz/.zip解压后可获得wamr-ide.vsix扩展安装文件。例如 1.1.2 版本对应wamr-ide-1.1.2.tar.gz与wamr-ide-1.1.2.zip。未来发布新版本时只要保证下载的Docker 镜像与 .vsix 版本一致均可正常使用。第 3 步从 vsix 安装扩展在 VSCode 扩展面板的...菜单中选择Install from VSIX...选中从压缩包解压出的wamr-ide.vsix即可。途径三本地构建进阶/定制做法如果你希望修改扩展、Docker 镜像或 lldb 后再验证效果可以本地构建。需要注意本地构建教程中默认使用硬编码的版本标签1.0而非 WAMR 的语义化版本号。同时请确保resource目录下的脚本具有可执行权限Git 仓库中带有 x 位但例如从 Windows 拷贝时可能丢失拷贝resource/debug/bin下的 lldb 二进制时也不要丢失执行权限。1. 构建 Docker 镜像进入WASM-Toolchain/Docker与WASM-Debug-Server/Docker目录分别执行构建脚本REM Windows (powershell) cd .\WASM-Toolchain\Docker .\build_docker_image.bat cd .\WASM-Debug-Server\Docker .\build_docker_image.bat# Linux cd ./WASM-Toolchain/Docker ./build_docker_image.sh cd ./WASM-Debug-Server/Docker ./build_docker_image.sh构建脚本的核心命令只有一个见 build_docker_image.shdocker build -t wasm-toolchain:1.0 .随后执行docker image prune -f清理中间镜像。构建完成后宿主机上会出现wasm-toolchain与wasm-debug-server两个镜像。2. 构建失败时的处理网络状况不佳时Docker 构建可能失败。请先修正代理设置然后手动执行构建命令注意把示例代理地址替换为你自己的地址$ cd .\docker_images\wasm-debug-server $ docker build --no-cache --build-arg http_proxyhttp://proxy.example.com:1234 --build-arg https_proxyhttp://proxy.example.com:1234 -t wasm-debug-server:1.0 .$ cd .\docker_images\wasm-toolchain $ docker build --no-cache --build-arg http_proxyhttp://proxy.example.com:1234 --build-arg https_proxyhttp://proxy.example.com:1234 -t wasm-toolchain:1.0 .如果遇到报错failed to solve with frontend dockerfile.v0: failed to create LLB definition需要检查并调整 Docker Desktop 的 Engine 配置如 DNS 与代理设置。3. 打包扩展 vsix 文件使用vsce打包wamride-1.0.0.vsixnpm install -g vsce cd VSCode-Extension rm -rf node_modules npm install vsce package4. 启用源码调试特性可选本地构建的 .vsix 默认关闭源码调试功能。要启用它需从 Release 下载对应平台的 lldb 二进制例如wamr-lldb-1.1.2-x86_64-ubuntu-20.04.tar.gz解压后把文件拷贝到扩展安装目录下的对应平台目录。以 Ubuntu 20.04 为例# 解压 .tar.gz 得到 wamr-lldb 目录内含 bin lib package.json syntaxes $ ls wamr-lldb bin lib package.json syntaxes # 拷贝到 VSCode 扩展安装路径示例/home/{usrname}/.vscode-server/extensions/wamr.wamride-1.0.0/ $ cp inst/* /home/{usrname}/.vscode-server/extensions/wamr.wamride-1.0.0/resource/debug/linux/如果想使用自己定制的 lldb可以按照 doc/source_debugging.md 中的debugging with interpreter章节构建 lldb再按VSCode-Extension/resource/debug/README.md的说明替换现有二进制。此外也可以不打包扩展直接按照 VSCode-Extension/README.md 的指引用 F5 启动「Run Extension」调试宿主来直接调试扩展本身。5. 安装本地打包的 vsix在扩展面板选择Install from VSIX...选中刚打包出的wamride-1.0.0.vsix即可。使用前的硬性前提无论采用哪种安装方式使用 WAMR-IDE 前都必须保证wasm-toolchain:1.0与wasm-debug-server:1.0两个镜像均成功构建/加载否则扩展的 Build、Run、Debug 三个功能都将无法工作。扩展在启动时也会自动检查镜像是否存在从 dockerUtilities.ts 可以看到它通过docker image inspect wasm-debug-server:${imageTag} wasm-toolchain:${imageTag}探测镜像imageTag 等于扩展版本号缺失时会弹出提示并引导自动下载同时通过执行docker images检查 Docker 服务是否已启动。使用 WAMR-IDE安装并激活扩展后VSCode 活动栏会出现 WAMR-IDE 图标侧边栏包含两个主要视图「WAMR IDE」负责工作区与项目管理New project / Open project / Change workspace「Current Project」负责当前项目的执行Configuration / Build / Run / Debug。这两个视图的配置定义在 VSCode-Extension/package.json 的viewsWelcome段中。项目执行1. 新建项目New project点击New project按钮扩展会在屏幕右下角弹出提示框。点击Set up now并选择目标文件夹作为项目工作区也可点击Maybe later暂时关闭。注意选择的工作区文件夹必须为空或已经配置为工作区。工作区设置成功后会弹出提示Workspace has been set up successfully!。再次点击New project会展示新建项目页面输入Project name并选择Template点击Create后新项目会在当前 VSCode 窗口或新窗口中打开具体取决于当前资源管理器是否为空为空则在当前窗口打开否则在新窗口打开。新建的默认项目结构如下.wamr是项目配置目录包含 3 个文件CMakeLists.txt用于构建 wasm targetproject.cmake被CMakeLists.txtincludecompilation_config.json保存用户自定义配置例如需要加入 include path 的文件夹。2. 打开项目Open project点击Open project按钮会弹出 quick-pick 列表当前工作区下的所有项目都会展示出来供选择。3. 切换工作区Change workspace点击Change workspace按钮弹出文件选择对话框选择文件系统中的任意文件夹作为新工作区。新工作区路径会覆盖旧工作区之后新建的项目都会生成在新工作区中。4. 定制 include paths 与排除源文件扩展支持将头文件目录加入include path以及从构建中排除源文件Add to include path鼠标移到文件夹上右键菜单中出现Toggle state of path including点击即可切换该目录是否加入 include pathExclude source file from build鼠标移到源文件上右键菜单中出现Toggle state of excluding点击即可切换是否从构建中排除该文件。这两个菜单项有严格的显示条件Toggle state of path including仅在选中文件夹时出现其他资源一律隐藏Toggle state of excluding仅在选中[.c | .cpp | .cxx]源文件时出现。这些条件与 package.json 中menus.explorer/context的when表达式explorerResourceIsFolder与resourceExtname in ext.supportedFileType一一对应。设置之后对应的文件夹与文件会被着色并带特殊图标标识同时所有 include path 与 exclude 文件会以 JSON 数组形式写入.wamr/compilation_config.json。Current Project 管理1. 构建目标配置Configuration点击Configuration按钮打开配置页可以配置构建目标字段包括Include paths、Initial Max linear memory、stack size、exported_symbols、exclude files等。各字段含义如下Output file name程序编译产出的 wasm 文件名Initial linear memory size / Max linear memory size / Stack sizewasi-sdk clang 的编译选项对应 WebAssembly 线性内存与栈的尺寸配置Exported symbolswasm 程序要导出的符号多个符号用逗号分隔且不加空格Host managed heap sizeiwasm 运行时宿主托管堆的大小。多数场景下默认值即可但如果需要通过malloc分配更多内存应相应调大。注意由于当前实现限制修改Output file name或Host managed heap size后需要关闭并重新打开 VSCode以重新激活扩展运行配置才会正确更新。点击Modify按钮确认修改成功后弹出提示框点击OK页面自动关闭所有配置都会保存到.wamr/compilation_config.json。从源码结构看构建目标配置页面对应 VSCode-Extension/src/view/TargetConfigPanel.ts新建项目页面对应 NewProjectPanel.tsinclude/exclude 的着色装饰则由 decorationProvider.ts 实现。2. Build构建编码完成后点击Build按钮扩展会通过wasm-toolchain镜像自动启动一个容器并执行构建流程。构建成功后资源管理器中会出现build文件夹其中包含${output_file_name}.wasm产物。构建前请先启动 Docker 服务docker service/ Docker Desktop。构建任务由 taskProvider.ts 定义的wasm类型 Task 驱动执行逻辑集中在 extension.ts构建前会销毁可能残留的wasm-toolchain-ctr容器构建结束后同样会销毁该容器保证环境干净。3. Run运行点击Run按钮扩展通过wasm-debug-server镜像自动启动容器执行 wasm 应用。容器内运行环境基于开启了WAMR_BUILD_DEBUG_INTERP的 iwasm见 WASM-Debug-Server/Docker/Dockerfile由run.sh负责拉起程序。4. Debug源码调试点击Debug按钮会启动wamr-debug-server镜像容器在 iwasm 内部启动lldb debug server随后 VSCode 发起一个调试会话并自动连接。调试开始后按F11或点击step into即可进入源码级单步调试。调试连接的核心配置定义在 VSCode-Extension/package.json 的debuggers段调试器类型为wamr-debug通过process connect -p wasm connect://127.0.0.1:1234附加attach到 iwasm 内的调试服务端口并根据平台选择resource/debug/{windows,darwin,linux}/bin/lldb-vscode作为调试适配器对应的request: attach配置与各平台路径由 debugConfigurationProvider.ts 负责提供。另外从 extension.ts 可以看到调试前会销毁wasm-debug-server-ctr容器确保调试会话以全新状态启动。Docker 容器会在执行结束后被自动停止并移除不会残留。常见问题与注意事项汇总版本匹配从 Release 安装时Docker 镜像与 .vsix 必须使用相同版本号本地构建则统一使用1.0标签本地构建的 vsix 为wamride-1.0.0.vsix。可执行权限resource目录下的构建/运行脚本以及resource/debug/bin下的 lldb 二进制在跨系统拷贝尤其是从 Windows 拷贝到 Linux/macOS时容易丢失 x 位务必保持执行权限。镜像缺失Build / Run / Debug 前必须确保wasm-toolchain:1.0与wasm-debug-server:1.0均已存在扩展启动时会自动检测并提示下载。网络与代理构建 Docker 镜像可能因网络问题失败需要正确配置 Docker 代理手动构建时使用--build-arg http_proxy/--build-arg https_proxy传入代理并替换为真实地址。Docker 引擎遇failed to solve with frontend dockerfile.v0报错时检查 Docker Desktop 的 Engine 配置。工作区约束新建项目前工作区必须为空或已配置好修改Output file name与Host managed heap size后需要重启 VSCode 才能生效。导出符号格式Exported symbols多个符号用逗号分隔且不能有空格。扩展实现速览从命令到容器的调用链WAMR-IDE 扩展的命令全部注册在 VSCode-Extension/package.json 的contributes.commands中包括wamride.newProject、wamride.changeWorkspace、wamride.build、wamride.run、wamride.debug、wamride.openFolder、wamride.targetConfig以及两个右键切换命令入口为./out/extension.js由 TypeScript 编译产出。其核心流程为用户点击按钮触发命令extension.ts 中对应的registerCommand回调被调用构建/运行/调试均通过 Docker CLI 与宿主机交互wasm-toolchain容器内执行 CMake 构建工具链镜像内置 wasi-sdk 与 wamrcwasm-debug-server容器内由 iwasm 运行或启动 lldb 调试服务dockerUtilities.ts 统一封装了镜像探测、自动下载从 Release 拉取 zip 后解压并docker load -i等 Docker 相关逻辑调试会话由 debugConfigurationProvider.ts 配合 package.json 中的wamr-debug调试器类型发起attach 到 iwasm 内的 lldb 服务。在 fluent-bit 仓库中的定位本 README 位于 fluent-bit 仓库 vendored 的第三方依赖lib/wasm-micro-runtime-WAMR-2.4.1目录内WAMR 全称为 WebAssembly Micro Runtime是 bytecodealliance 维护的轻量级 WebAssembly 运行时。fluent-bit 通过 plugins/filter_wasm/filter_wasm.c 等插件调用该运行时来执行 wasm 过滤器因此 WAMR-IDE 提供的编译wasm-toolchain 镜像内含 wasi-sdk 与 wamrc与源码调试能力恰好可以服务于为 fluent-bit 编写 wasm 过滤器的开发工作流——先在 WAMR-IDE 中完成 wasm 模块的开发与调试再将其部署到 fluent-bit 的 wasm 过滤器中运行。读者可在仓库的 lib/wasm-micro-runtime-WAMR-2.4.1 目录中继续深入阅读 WAMR 的文档与源码。【免费下载链接】fluent-bitFast and Lightweight Logs, Metrics and Traces processor for Linux, BSD, OSX and Windows项目地址: https://gitcode.com/GitHub_Trending/fl/fluent-bit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WAMR-IDE 开发环境完全指南：在 VSCode 中一站式完成 WebAssembly 编码、编译与源码调试
WAMR-IDE 开发环境完全指南在 VSCode 中一站式完成 WebAssembly 编码、编译与源码调试【免费下载链接】fluent-bitFast and Lightweight Logs, Metrics and Traces processor for Linux, BSD, OSX and Windows项目地址: https://gitcode.com/GitHub_Trending/fl/fluent-bit本文基于lib/wasm-micro-runtime-WAMR-2.4.1/test-tools/wamr-ide/README.md编写。WAMR-IDE 是 wasm-micro-runtimeWAMR附带的实验性集成开发环境它将「编码、编译、运行与源码级调试」WebAssembly 应用的能力整合进 VSCode扩展负责项目管理与交互两个 Docker 镜像分别提供构建工具链与运行调试环境。读完本文你将掌握从零安装 WAMR-IDE、通过 VSCode 扩展市场或本地源码两种途径部署扩展以及完成新建项目、定制编译配置、一键 Build / Run / Debug 的完整实战流程并了解其底层 Docker 镜像与 TypeScript 扩展的实现原理。WAMR-IDE 简介三大组件如何协作WAMR-IDE 是 WAMR 官方提供的、用于开发 WebAssembly 应用的集成开发环境实验性功能核心目标是让开发者能在 VSCode 中完成从编写代码到源码级调试的完整闭环。它由三个组件构成详见 README.mdVSCode 扩展VSCode extension负责构建与管理工程支持创建项目、编译build、运行run与调试debugWebAssembly 应用WASM-toolchain Docker 镜像为 wasm 提供编译构建环境WASM source debug server Docker 镜像为 wasm 应用提供运行与源码调试环境。三个组件的职责边界在 Dockerfile 中清晰可见WASM-Toolchain/Docker/Dockerfile 基于gcc:12.2.0构建内部安装ccache、ninja-build、make、cmake、python3-pip并预先部署wasi-sdk 19.0WASI 编译工具链、wamrcWAMR 的 AOT 编译器被软链到/usr/bin/wamrc以及wamr-sdk/appWAMR SDK 的 app 目录内含wamr_toolchain.cmake最终产物是提供 wasm 编译能力的工具链镜像WASM-Debug-Server/Docker/Dockerfile 同样基于gcc:12.2.0通过cmake .. -DWAMR_BUILD_DEBUG_INTERP1开启WAMR 调试解释器debug interpreter构建iwasmWAMR 的独立运行程序并附带debug.sh与run.sh两个运行脚本为 wasm 应用提供运行与调试能力。从源码结构可以推断这套设计把「编译」与「运行/调试」彻底容器化宿主机只需要 VSCode 与 Docker即可获得完全一致的跨平台开发体验。安装前的环境准备WAMR-IDE 依赖宿主机上的两个基础软件VSCode版本至少为1.59.0见 VSCode-Extension/package.json 中engines.vscode: ^1.59.0的约束。请从官方渠道下载安装Docker用于拉起 toolchain 与 debug-server 两个镜像。Windows安装 Docker DesktopUbuntu安装 Docker Engine官方要求 64 位系统且支持 Ubuntu Impish 21.10、Hirsute 21.04、Focal 20.04 (LTS)、Bionic 18.04 (LTS) 等版本。安装 WAMR-IDE 扩展的三种途径官方提供了三条安装路径按推荐优先级排列如下。途径一从 VSCode 扩展市场直接安装最省力当前最直接的安装方式是在 VSCode 扩展市场中搜索WAMR-IDE并直接安装。如果你只是想快速使用 WAMR 的调试能力这是理想选择。安装完成后可直接进入「使用 WAMR-IDE」章节。官方建议只安装1.3.2 之后的版本。途径二从 GitHub Release 下载推荐做法WAMR 的每次 GitHub Release 都会打包同版本号的 Docker 镜像 tar 包、lldb 二进制以及 .vsix 扩展安装文件可以完全离线使用。第 1 步加载 Docker 镜像从 Release 页面下载wasm-toolchain-{版本号}与wasm-debug-server-{版本号}的 zip/tar.gz 包解压后用docker load导入# Linux / macOS使用 tar 解压 tar xf wasm-toolchain-{version number}.tar.gz tar xf wasm-debug-server-{version number}.tar.gz # 或者使用 unzip unzip wasm-toolchain-{version number}.zip unzip wasm-debug-server-{version number}.zip # 加载 wasm-toolchain docker load --input wasm-toolchain.tar # 加载 wasm-debug-server docker load --input wasm-debug-server.tar # Windows可用任意解压软件解压然后在 PowerShell 或 git bash 中加载 docker load --input ./wasm-toolchain.tar docker load --input ./wasm-debug-server.tar第 2 步下载扩展安装文件Release 中提供同版本的wamr-ide-{版本号}.tar.gz/.zip解压后可获得wamr-ide.vsix扩展安装文件。例如 1.1.2 版本对应wamr-ide-1.1.2.tar.gz与wamr-ide-1.1.2.zip。未来发布新版本时只要保证下载的Docker 镜像与 .vsix 版本一致均可正常使用。第 3 步从 vsix 安装扩展在 VSCode 扩展面板的...菜单中选择Install from VSIX...选中从压缩包解压出的wamr-ide.vsix即可。途径三本地构建进阶/定制做法如果你希望修改扩展、Docker 镜像或 lldb 后再验证效果可以本地构建。需要注意本地构建教程中默认使用硬编码的版本标签1.0而非 WAMR 的语义化版本号。同时请确保resource目录下的脚本具有可执行权限Git 仓库中带有 x 位但例如从 Windows 拷贝时可能丢失拷贝resource/debug/bin下的 lldb 二进制时也不要丢失执行权限。1. 构建 Docker 镜像进入WASM-Toolchain/Docker与WASM-Debug-Server/Docker目录分别执行构建脚本REM Windows (powershell) cd .\WASM-Toolchain\Docker .\build_docker_image.bat cd .\WASM-Debug-Server\Docker .\build_docker_image.bat# Linux cd ./WASM-Toolchain/Docker ./build_docker_image.sh cd ./WASM-Debug-Server/Docker ./build_docker_image.sh构建脚本的核心命令只有一个见 build_docker_image.shdocker build -t wasm-toolchain:1.0 .随后执行docker image prune -f清理中间镜像。构建完成后宿主机上会出现wasm-toolchain与wasm-debug-server两个镜像。2. 构建失败时的处理网络状况不佳时Docker 构建可能失败。请先修正代理设置然后手动执行构建命令注意把示例代理地址替换为你自己的地址$ cd .\docker_images\wasm-debug-server $ docker build --no-cache --build-arg http_proxyhttp://proxy.example.com:1234 --build-arg https_proxyhttp://proxy.example.com:1234 -t wasm-debug-server:1.0 .$ cd .\docker_images\wasm-toolchain $ docker build --no-cache --build-arg http_proxyhttp://proxy.example.com:1234 --build-arg https_proxyhttp://proxy.example.com:1234 -t wasm-toolchain:1.0 .如果遇到报错failed to solve with frontend dockerfile.v0: failed to create LLB definition需要检查并调整 Docker Desktop 的 Engine 配置如 DNS 与代理设置。3. 打包扩展 vsix 文件使用vsce打包wamride-1.0.0.vsixnpm install -g vsce cd VSCode-Extension rm -rf node_modules npm install vsce package4. 启用源码调试特性可选本地构建的 .vsix 默认关闭源码调试功能。要启用它需从 Release 下载对应平台的 lldb 二进制例如wamr-lldb-1.1.2-x86_64-ubuntu-20.04.tar.gz解压后把文件拷贝到扩展安装目录下的对应平台目录。以 Ubuntu 20.04 为例# 解压 .tar.gz 得到 wamr-lldb 目录内含 bin lib package.json syntaxes $ ls wamr-lldb bin lib package.json syntaxes # 拷贝到 VSCode 扩展安装路径示例/home/{usrname}/.vscode-server/extensions/wamr.wamride-1.0.0/ $ cp inst/* /home/{usrname}/.vscode-server/extensions/wamr.wamride-1.0.0/resource/debug/linux/如果想使用自己定制的 lldb可以按照 doc/source_debugging.md 中的debugging with interpreter章节构建 lldb再按VSCode-Extension/resource/debug/README.md的说明替换现有二进制。此外也可以不打包扩展直接按照 VSCode-Extension/README.md 的指引用 F5 启动「Run Extension」调试宿主来直接调试扩展本身。5. 安装本地打包的 vsix在扩展面板选择Install from VSIX...选中刚打包出的wamride-1.0.0.vsix即可。使用前的硬性前提无论采用哪种安装方式使用 WAMR-IDE 前都必须保证wasm-toolchain:1.0与wasm-debug-server:1.0两个镜像均成功构建/加载否则扩展的 Build、Run、Debug 三个功能都将无法工作。扩展在启动时也会自动检查镜像是否存在从 dockerUtilities.ts 可以看到它通过docker image inspect wasm-debug-server:${imageTag} wasm-toolchain:${imageTag}探测镜像imageTag 等于扩展版本号缺失时会弹出提示并引导自动下载同时通过执行docker images检查 Docker 服务是否已启动。使用 WAMR-IDE安装并激活扩展后VSCode 活动栏会出现 WAMR-IDE 图标侧边栏包含两个主要视图「WAMR IDE」负责工作区与项目管理New project / Open project / Change workspace「Current Project」负责当前项目的执行Configuration / Build / Run / Debug。这两个视图的配置定义在 VSCode-Extension/package.json 的viewsWelcome段中。项目执行1. 新建项目New project点击New project按钮扩展会在屏幕右下角弹出提示框。点击Set up now并选择目标文件夹作为项目工作区也可点击Maybe later暂时关闭。注意选择的工作区文件夹必须为空或已经配置为工作区。工作区设置成功后会弹出提示Workspace has been set up successfully!。再次点击New project会展示新建项目页面输入Project name并选择Template点击Create后新项目会在当前 VSCode 窗口或新窗口中打开具体取决于当前资源管理器是否为空为空则在当前窗口打开否则在新窗口打开。新建的默认项目结构如下.wamr是项目配置目录包含 3 个文件CMakeLists.txt用于构建 wasm targetproject.cmake被CMakeLists.txtincludecompilation_config.json保存用户自定义配置例如需要加入 include path 的文件夹。2. 打开项目Open project点击Open project按钮会弹出 quick-pick 列表当前工作区下的所有项目都会展示出来供选择。3. 切换工作区Change workspace点击Change workspace按钮弹出文件选择对话框选择文件系统中的任意文件夹作为新工作区。新工作区路径会覆盖旧工作区之后新建的项目都会生成在新工作区中。4. 定制 include paths 与排除源文件扩展支持将头文件目录加入include path以及从构建中排除源文件Add to include path鼠标移到文件夹上右键菜单中出现Toggle state of path including点击即可切换该目录是否加入 include pathExclude source file from build鼠标移到源文件上右键菜单中出现Toggle state of excluding点击即可切换是否从构建中排除该文件。这两个菜单项有严格的显示条件Toggle state of path including仅在选中文件夹时出现其他资源一律隐藏Toggle state of excluding仅在选中[.c | .cpp | .cxx]源文件时出现。这些条件与 package.json 中menus.explorer/context的when表达式explorerResourceIsFolder与resourceExtname in ext.supportedFileType一一对应。设置之后对应的文件夹与文件会被着色并带特殊图标标识同时所有 include path 与 exclude 文件会以 JSON 数组形式写入.wamr/compilation_config.json。Current Project 管理1. 构建目标配置Configuration点击Configuration按钮打开配置页可以配置构建目标字段包括Include paths、Initial Max linear memory、stack size、exported_symbols、exclude files等。各字段含义如下Output file name程序编译产出的 wasm 文件名Initial linear memory size / Max linear memory size / Stack sizewasi-sdk clang 的编译选项对应 WebAssembly 线性内存与栈的尺寸配置Exported symbolswasm 程序要导出的符号多个符号用逗号分隔且不加空格Host managed heap sizeiwasm 运行时宿主托管堆的大小。多数场景下默认值即可但如果需要通过malloc分配更多内存应相应调大。注意由于当前实现限制修改Output file name或Host managed heap size后需要关闭并重新打开 VSCode以重新激活扩展运行配置才会正确更新。点击Modify按钮确认修改成功后弹出提示框点击OK页面自动关闭所有配置都会保存到.wamr/compilation_config.json。从源码结构看构建目标配置页面对应 VSCode-Extension/src/view/TargetConfigPanel.ts新建项目页面对应 NewProjectPanel.tsinclude/exclude 的着色装饰则由 decorationProvider.ts 实现。2. Build构建编码完成后点击Build按钮扩展会通过wasm-toolchain镜像自动启动一个容器并执行构建流程。构建成功后资源管理器中会出现build文件夹其中包含${output_file_name}.wasm产物。构建前请先启动 Docker 服务docker service/ Docker Desktop。构建任务由 taskProvider.ts 定义的wasm类型 Task 驱动执行逻辑集中在 extension.ts构建前会销毁可能残留的wasm-toolchain-ctr容器构建结束后同样会销毁该容器保证环境干净。3. Run运行点击Run按钮扩展通过wasm-debug-server镜像自动启动容器执行 wasm 应用。容器内运行环境基于开启了WAMR_BUILD_DEBUG_INTERP的 iwasm见 WASM-Debug-Server/Docker/Dockerfile由run.sh负责拉起程序。4. Debug源码调试点击Debug按钮会启动wamr-debug-server镜像容器在 iwasm 内部启动lldb debug server随后 VSCode 发起一个调试会话并自动连接。调试开始后按F11或点击step into即可进入源码级单步调试。调试连接的核心配置定义在 VSCode-Extension/package.json 的debuggers段调试器类型为wamr-debug通过process connect -p wasm connect://127.0.0.1:1234附加attach到 iwasm 内的调试服务端口并根据平台选择resource/debug/{windows,darwin,linux}/bin/lldb-vscode作为调试适配器对应的request: attach配置与各平台路径由 debugConfigurationProvider.ts 负责提供。另外从 extension.ts 可以看到调试前会销毁wasm-debug-server-ctr容器确保调试会话以全新状态启动。Docker 容器会在执行结束后被自动停止并移除不会残留。常见问题与注意事项汇总版本匹配从 Release 安装时Docker 镜像与 .vsix 必须使用相同版本号本地构建则统一使用1.0标签本地构建的 vsix 为wamride-1.0.0.vsix。可执行权限resource目录下的构建/运行脚本以及resource/debug/bin下的 lldb 二进制在跨系统拷贝尤其是从 Windows 拷贝到 Linux/macOS时容易丢失 x 位务必保持执行权限。镜像缺失Build / Run / Debug 前必须确保wasm-toolchain:1.0与wasm-debug-server:1.0均已存在扩展启动时会自动检测并提示下载。网络与代理构建 Docker 镜像可能因网络问题失败需要正确配置 Docker 代理手动构建时使用--build-arg http_proxy/--build-arg https_proxy传入代理并替换为真实地址。Docker 引擎遇failed to solve with frontend dockerfile.v0报错时检查 Docker Desktop 的 Engine 配置。工作区约束新建项目前工作区必须为空或已配置好修改Output file name与Host managed heap size后需要重启 VSCode 才能生效。导出符号格式Exported symbols多个符号用逗号分隔且不能有空格。扩展实现速览从命令到容器的调用链WAMR-IDE 扩展的命令全部注册在 VSCode-Extension/package.json 的contributes.commands中包括wamride.newProject、wamride.changeWorkspace、wamride.build、wamride.run、wamride.debug、wamride.openFolder、wamride.targetConfig以及两个右键切换命令入口为./out/extension.js由 TypeScript 编译产出。其核心流程为用户点击按钮触发命令extension.ts 中对应的registerCommand回调被调用构建/运行/调试均通过 Docker CLI 与宿主机交互wasm-toolchain容器内执行 CMake 构建工具链镜像内置 wasi-sdk 与 wamrcwasm-debug-server容器内由 iwasm 运行或启动 lldb 调试服务dockerUtilities.ts 统一封装了镜像探测、自动下载从 Release 拉取 zip 后解压并docker load -i等 Docker 相关逻辑调试会话由 debugConfigurationProvider.ts 配合 package.json 中的wamr-debug调试器类型发起attach 到 iwasm 内的 lldb 服务。在 fluent-bit 仓库中的定位本 README 位于 fluent-bit 仓库 vendored 的第三方依赖lib/wasm-micro-runtime-WAMR-2.4.1目录内WAMR 全称为 WebAssembly Micro Runtime是 bytecodealliance 维护的轻量级 WebAssembly 运行时。fluent-bit 通过 plugins/filter_wasm/filter_wasm.c 等插件调用该运行时来执行 wasm 过滤器因此 WAMR-IDE 提供的编译wasm-toolchain 镜像内含 wasi-sdk 与 wamrc与源码调试能力恰好可以服务于为 fluent-bit 编写 wasm 过滤器的开发工作流——先在 WAMR-IDE 中完成 wasm 模块的开发与调试再将其部署到 fluent-bit 的 wasm 过滤器中运行。读者可在仓库的 lib/wasm-micro-runtime-WAMR-2.4.1 目录中继续深入阅读 WAMR 的文档与源码。【免费下载链接】fluent-bitFast and Lightweight Logs, Metrics and Traces processor for Linux, BSD, OSX and Windows项目地址: https://gitcode.com/GitHub_Trending/fl/fluent-bit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
详解：核心公式、Python实现与工程调参指南)
