安装forge-dataviz-iot-reference-app依赖npm报错解决方案

按照Autodesk Forge官方Data Viz参考应用快速入门流程部署项目时，进入forge-dataviz-iot-reference-app目录执行依赖安装命令，终端输出数页npm错误提示。

执行的安装命令如下：

cd forge-dataviz-iot-reference-app
npm install

报错核心为libsass原生模块编译阶段触发的警告，典型报错片段如下：

npm ERR! 2 warnings generated.
npm ERR! In file included from ../src/libsass/src/subset_map.cpp:2:
npm ERR! ../src/libsass/src/ast.hpp:1614:25: warning: loop variable 'numerator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto numerator : numerators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1614:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto numerator : numerators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~
npm ERR!                         &
npm ERR! ../src/libsass/src/ast.hpp:1616:25: warning: loop variable 'denominator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto denominator : denominators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1616:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto denominator : denominators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~~~
npm ERR!                         &
npm ERR! 2 warnings generated.
npm ERR! In file included from ../src/libsass/src/to_c.cpp:3:
npm ERR! ../src/libsass/src/ast.hpp:1614:25: warning: loop variable 'numerator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto numerator : numerators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1614:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto numerator : numerators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~
npm ERR!                         &
npm ERR! ../src/libsass/src/ast.hpp:1616:25: warning: loop variable 'denominator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto denominator : denominators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1616:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto denominator : denominators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~~~
npm ERR!                         &
npm ERR! 2 warnings generated.
npm ERR! In file included from ../src/libsass/src/to_value.cpp:2:
npm ERR! ../src/libsass/src/ast.hpp:1614:25: warning: loop variable 'numerator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto numerator : numerators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1614:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto numerator : numerators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~
npm ERR!                         &
npm ERR! ../src/libsass/src/ast.hpp:1616:25: warning: loop variable 'denominator' creates a copy from type 'const std::__1::basic_string<char>' [-Wrange-loop-construct]
npm ERR!         for (const auto denominator : denominators)
npm ERR!                         ^
npm ERR! ../src/libsass/src/ast.hpp:1616:14: note: use reference type 'const std::__1::basic_string<char> &' to prevent copying
npm ERR!         for (const auto denominator : denominators)
npm ERR!              ^~~~~~~~~~~~~~~~~~~~~~~~

上述报错均为libsass编译阶段的range-loop-construct类警告，提示循环变量numerator、denominator会生成const std::__1::basic_string<char>类型副本，建议使用对应引用类型避免拷贝。

这类问题在老旧前端项目依赖安装时非常普遍，不是项目代码本身的逻辑错误：
项目依赖的旧版本node-sass绑定的libsass原生模块源码发布时间较早，没有适配高版本C++编译器（Xcode 12+、GCC 9+及以上版本）默认开启的循环构造检查规则，编译器检测到范围for循环的字符串变量未使用引用会产生冗余拷贝，输出对应警告，npm将这类原生模块编译阶段的警告误判为安装失败，最终抛出错误中断安装流程。

• 方案1（推荐）：替换已官方废弃的node-sass为纯JavaScript实现的sass（即dart-sass），从根源规避原生模块编译问题。两者API完全兼容，不会影响项目原有样式构建逻辑，也是目前前端项目的通用替代方案。在项目目录依次执行以下命令即可：

  npm uninstall node-sass
  npm install sass --save-dev
  npm install
  

• 方案2：跳过本地源码编译步骤，直接使用对应Node版本匹配的node-sass预编译二进制包。执行安装前配置环境变量，指定node-sass二进制包的国内镜像源即可，不同操作系统、不同终端的环境变量配置方式可根据自身环境检索对应操作命令。
• 方案3：降级本地Node.js版本到14.x大版本。该版本配套的编译工具链默认不会将libsass的这类循环拷贝警告判定为阻断性错误，可直接完成原生模块的编译安装流程。
• 方案4：临时跳过脚本错误阻断完成安装，执行安装命令时追加--ignore-scripts参数：

  npm install --ignore-scripts
  

  注意该方案可能导致部分原生依赖未完成正常编译，安装完成后如果项目启动报错，需要单独重装对应异常依赖。

注意：不要手动修改node_modules目录下的libsass源码，后续执行依赖重装、版本更新操作时会直接覆盖手动修改的内容，无法永久解决问题。

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