执行npm run compile:sass命令时遇模块未找到等错误求助

问题现象 #

执行npm run compile:sass时出现两个错误：

• 'CSS' 未被识别为内部或外部命令、可运行的程序或批处理文件
• 无法找到模块'D:\Takbeer\Courses\node-sass\bin\node-sass'

当前环境：Node.js v18.16.0

问题原因 #

1. node-sass兼容性问题：node-sass已停止维护，且不支持Node.js v16及以上版本，导致安装失败或无法正常调用模块。
2. scripts命令配置错误：package.json中的compile:sass命令可能存在拼写错误（比如误写了CSS相关的错误指令），或者命令格式不正确。

解决方案 #

步骤1：替换node-sass为sass（dart-sass） #

node-sass已被官方废弃，推荐使用官方维护的sass包（dart-sass实现）：

# 卸载旧的node-sass
npm uninstall node-sass
# 安装sass开发依赖
npm install sass --save-dev

步骤2：修正package.json中的scripts命令 #

打开项目根目录的package.json，找到scripts里的compile:sass命令，将其中的node-sass替换为sass，同时检查命令是否存在拼写错误（比如避免出现无意义的CSS字符串）。

示例修正前：

"scripts": {
  "compile:sass": "node-sass src/sass/main.scss dist/CSS/style.css -w"
}

修正后（注意路径大小写和命令名称）：

"scripts": {
  "compile:sass": "sass src/sass/main.scss dist/css/style.css -w"
}

步骤3：重新执行编译命令 #

npm run compile:sass

额外检查 #

• 确认项目中存在src/sass/main.scss文件，以及dist/css目录已创建（如果没有，手动创建对应目录）。
• 若仍有问题，删除node_modules和package-lock.json，重新执行npm install后再尝试编译。

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