错误发生在ruby读取文件的i/o阶段，而非sass解析阶段；因ruby默认用gbk解码utf-8编码的scss文件，遇中文即崩溃报“invalid gbk character "\xe5"”，此时@charset尚未被读取。
直接结论：不是加 @charset "UTF-8" 就能解决，而是 Ruby 读文件时就用 GBK 解码失败了——@charset 根本没机会执行。
报错 Error: Invalid GBK character "\xE5" 是什么阶段的问题
这个错误出现在 Sass 解析器启动前。Ruby（尤其 Windows 下）默认用 Encoding.default_external = Encoding.find('GBK') 打开 .scss 文件，遇到 UTF-8 编码的中文（如 /* 注释 */ 或 font-family: "宋体";）直接解码崩溃，抛出类似 Invalid GBK character "\xE5" 的错误。此时 Sass 还没开始读 @charset，更不会处理后续逻辑。
- 错误发生在文件 I/O 阶段，不是 CSS 语法或 Sass 编译阶段
- VS Code 里把文件存成 UTF-8 没用——Ruby 不认你存的编码，只按自己默认的 GBK 去读
- Koala、CodeKit 等 GUI 工具自带 Ruby 环境，改编辑器编码对它们完全无效
必须修改 engine.rb 中的 Encoding.default_external
找到你当前项目实际使用的 Sass gem 路径（运行 sass -v 查版本，再用 gem environment gemdir 定位），编辑 lib/sass/engine.rb：
- 在所有
require语句之后、module Sass定义之前插入：Encoding.default_external = Encoding.find('utf-8') - 不要加括号，不要放在
require块内部，否则可能被覆盖 - 典型路径示例：
C:\Ruby25-x64\lib\ruby\gems\2.5.0\gems\sass-3.7.3\lib\sass\engine.rb（Windows）、/usr/local/lib/ruby/gems/3.0.0/gems/sass-3.7.4/lib/sass/engine.rb（macOS） - Koala 用户需进其安装目录找自带 Ruby 下的 sass gem，不是系统 Ruby
@charset "UTF-8" 要生效，还得满足三个硬条件
即使改了 engine.rb，@charset 仍可能被忽略——它极其脆弱：
- SCSS 文件必须保存为 UTF-8 without BOM（VS Code 右下角点编码 → “Save with Encoding” → 选
UTF-8，不是UTF-8 with BOM） -
@charset "UTF-8";必须是文件第一行、第一个字符——前面不能有空格、空行、BOM、注释或任何不可见字符 - 大小写敏感：
UTF-8必须全大写，utf-8旧版 Sass 会直接忽略 - 注意：
@charset只影响最终输出的 CSS 文件头部，不控制源文件读取；它对编译过程本身无作用
编译后 CSS 仍乱码？检查浏览器加载链上的三处 UTF-8
SCSS 编译成功 ≠ 浏览器正确显示。中文在 CSS 中要走完三道关卡，缺一不可：
- HTML 页面要有
<meta charset="UTF-8">，且放在靠前位置 - 输出的 CSS 文件头部要有
@charset "UTF-8";（这是编译结果，不是源 SCSS） - HTTP 响应头必须含
Content-Type: text/css; charset=utf-8（file://协议下无效，必须起本地服务） - 如果用了 Webpack/Vite，确认
css-loader或rollup-plugin-css-only显式配置了encoding: 'utf8'
最容易被跳过的环节：改了 engine.rb 却没验证是否改对了 gem 版本路径，或者编辑器悄悄存成了带 BOM 的 UTF-8 —— 这两种情况会让整个修复链彻底失效。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
