Jekyll中使用SASS自动迁移工具报错：如何指定_sass目录？

核心原因 #

Jekyll默认会把_sass目录加入Sass的导入搜索路径，但sass-migrator工具本身不会自动识别这个Jekyll特定的路径，所以当assets/css/index.sass引用_sass下的文件时，工具找不到对应依赖，导致迁移失败。

解决步骤 #

1. 指定_sass目录作为Sass加载路径 #

运行sass-migrator时，通过--load-path（简写-I）参数把_sass目录加入搜索路径，让工具能识别该目录下的依赖文件。执行命令：

sass-migrator module --migrate-deps --load-path _sass assets/css/index.sass

如果_sass目录不在当前工作目录根路径，替换为实际相对路径即可（比如../_sass）。

2. 批量迁移多个文件（可选） #

如果有多个需要迁移的入口文件，可一次性指定或用通配符批量处理：

sass-migrator module --migrate-deps --load-path _sass assets/css/*.sass

3. 验证迁移结果 #

迁移完成后，检查相关文件：

• 原本的@import语句会被替换为符合模块规范的@use或@forward
• 启动Jekyll服务，确认样式正常且无新的Sass弃用警告

额外注意事项 #

• 若你的Jekyll站点在_config.yml中配置了自定义Sass加载路径（sass: load_paths），需要把这些路径也通过--load-path参数加入，多个路径用逗号分隔：

  sass-migrator module --migrate-deps --load-path _sass,assets/custom-sass assets/css/index.sass
  

• 迁移前建议备份所有Sass文件，避免意外修改导致样式故障

内容的提问来源于stack exchange，提问作者Jan Černý