Nix环境下Clang编译Wasm模块出现属性识别失效与链接错误问题

问题原因 #

你遇到的问题核心原因是Nix提供的llvmPackages_12.stdenv中的Clang是经过Nix封装修补的版本，默认会强制绑定宿主架构（测试环境的x86_64-linux）的编译目标，你传入的--target=wasm32参数会被覆盖失效，所以才会出现target不生效、Wasm专属属性import_module/import_name不识别、链接时调用系统ld而非wasm-ld的问题。

解决方案 #

方案一：使用Nix内置Wasm交叉编译工具链（推荐） #

Nixpkgs已经预定义了Wasm目标的交叉编译环境，直接调用即可避免手动配置工具链的问题，修改后的default.nix如下：

{ pkgs ? import <nixpkgs> {} }:
let
  # 按需选择目标平台：
  # 需WASI运行时用wasm32-unknown-wasi，纯裸Wasm模块用wasm32-unknown-unknown
  stdenv = pkgs.pkgsCross.wasm32-unknown-wasi.stdenv;
in
stdenv.mkDerivation {
  name = "wasm-module";
  src = ./.;
  buildPhase = ''
    # 环境内置的$CC已经默认适配Wasm目标，无需额外加--target参数
    $CC --no-standard-libraries -c -Ofast -o $out/out.o in.c
    # 链接时会自动调用wasm-ld，无需手动指定链接器
    $CC -Wl,--no-entry -o $out/module.wasm $out/out.o
  '';
  installPhase = "ls $out";
}

方案二：手动调用未封装的Clang #

如果你需要固定使用LLVM 12版本，不想用内置交叉编译环境，可以直接调用未经过Nix target补丁封装的Clang版本：

{ pkgs ? import <nixpkgs> {} }:
let
  clang = pkgs.llvmPackages_12.clang-unwrapped;
  lld = pkgs.llvmPackages_12.lld;
in
pkgs.stdenv.mkDerivation {
  name = "wasm-module";
  src = ./.;
  nativeBuildInputs = [ clang lld ];
  buildPhase = ''
    # 明确指定target和链接器，参数不会被覆盖
    clang --target=wasm32 --no-standard-libraries \
          -fuse-ld=lld -c -Ofast -o out.o in.c
    # 链接步骤保持参数一致
    clang --target=wasm32 -fuse-ld=lld \
          -Wl,--no-entry -o module.wasm out.o
    mkdir -p $out
    cp out.o module.wasm $out/
  '';
}

注意事项 #

• 不要混用llvmPackages_*.stdenv和单独安装的clang包，封装后的stdenv默认会覆盖所有自定义target参数
• Wasm专属的编译/链接参数可以直接加在-Wl,后传递给wasm-ld，比如-Wl,--export-all、-Wl,--allow-undefined

内容的提问来源于stack exchange，提问作者user8866053