ruby版sass因默认用gbk解码utf-8文件导致中文注释崩溃，需修改engine.rb设encoding.default_external为utf-8，并确保文件utf-8无bom、@charset首行、路径无中文。
不是注释本身有问题，而是 Ruby 版 Sass 在读取文件时就用错了编码——它默认用 GBK 去解码 UTF-8 编码的 SCSS 文件，遇到中文注释（比如 /* 导航样式 */）直接崩溃，根本没走到解析注释那步。
报错发生在 Ruby I/O 阶段，不是 Sass 解析阶段
错误信息像 Invalid GBK character "\xE5" 或 Syntax error: Invalid GBK character ""，说明 Ruby 尝试把 UTF-8 字节流（如汉字“中”的首字节 \xE5）当 GBK 解，失败后立刻抛异常。此时 @charset "UTF-8" 还躺在文件里，Sass 解析器压根没启动。
-
@charset是 Sass 解析器识别的指令，只影响后续内容解释和最终 CSS 输出头，不干预 Ruby 打开文件的底层行为 - VS Code 把文件存成 UTF-8 没用——Ruby 不看编辑器存的编码，只按自己默认的
Encoding.default_external去读 - Koala、CodeKit 等 GUI 工具自带 Ruby 环境，改编辑器设置对它们完全无效
必须修改 Sass gem 的 engine.rb
找到你项目实际使用的 Sass gem 路径（运行 sass -v 查版本，再用 gem which sass 或 bundle show sass 定位），编辑 lib/sass/engine.rb：
- 在所有
require语句之后、module Sass定义之前插入一行：Encoding.default_external = Encoding.find('utf-8') - 别加括号，别放在
require块内部，否则可能被覆盖 - Windows 典型路径：
C:\Ruby25-x64\lib\ruby\gems\2.5.0\gems\sass-3.7.3\lib\sass\engine.rb - Koala 用户注意：要进其安装目录找内嵌 Ruby 下的 gem，不是系统 Ruby
SCSS 文件本身还必须满足三个硬条件
漏掉任意一条，整个修复就失效：
- 文件保存为 UTF-8 without BOM（VS Code 右下角点编码 → “Save with Encoding” → 选
UTF-8，不是UTF-8 with BOM） -
@charset "UTF-8";必须是文件第一行、第一个字符——前面不能有空格、空行、BOM、注释或任何不可见字符 - 项目路径不能含中文（如
D:\我的项目\style.scss会触发 Ruby 编码异常；临时改到D:\my-project\style.scss验证）
最容易被忽略的是：改了 engine.rb 却没确认改的是当前项目真正加载的 gem 版本路径，或者编辑器悄悄存成了带 BOM 的 UTF-8 —— 这两种情况会让所有操作白费。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
