sass-migrator使用遇绝对路径识别失败及node_modules处理问题咨询

1. 绝对路径导入识别失败问题 #

Sass 官方工具链的路径解析逻辑和 gulp-sass 等二次封装工具存在差异：

• 你之前使用 gulp-sass 时默认配置了 includePaths 参数指向项目根目录，所以绝对路径导入可以正常解析，但 sass-migrator 默认不会主动加载项目根目录作为路径解析基准，因此会抛出文件找不到的错误，这属于预期行为，不需要将所有导入改为相对路径。
• 解决方案：运行迁移命令时添加 --load-path 参数指定你的路径根目录即可，示例命令如下：

sass-migrator module --load-path ./src **/*.scss

如果需要长期使用，可以在项目根目录新增 sass.config.js 配置文件写入 loadPath 规则，sass-migrator 会自动读取。

2. node_modules 目录报错问题 #

sass-migrator 不会主动修改 node_modules 下的任何文件，你看到的报错是工具在处理你项目内的文件时，需要读取 @import 引用的依赖文件内容来完成变量、mixin 等成员的命名空间映射，仅为读取行为，不会写入修改。
对应解决方案：

• 优先升级 Bootstrap 等依赖到符合 Sass 标准的版本，依赖文件本身无语法问题后，迁移时的读取报错会自动消失。
• 如果暂时无法升级依赖，可以运行命令时添加 --ignore-path node_modules 参数，让工具跳过解析 node_modules 目录下的文件，也可以添加 --migrate-deps false 参数，明确指定仅处理你传入的目标源文件，不处理任何依赖文件。注意这两种配置下如果你的项目代码引用了依赖内的 Sass 成员，迁移后的 @use 语句可能需要你手动调整命名空间。

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