JavaScript文件须以UTF-8无BOM格式保存,确保编辑器(如VS Code)选“UTF-8”而非“UTF-8 with BOM”;HTML中script标签无需charset属性;Node.js读取文件应显式指定'utf8'编码。

JavaScript脚本文件默认按UTF-8编码解析,但若实际文件保存编码与浏览器/运行环境预期不一致,就会出现中文乱码、语法错误或特殊符号解析失败等问题。关键不在代码里写什么声明,而在于文件保存方式和加载环境的一致性。
确保源文件以UTF-8无BOM格式保存
编辑器(如VS Code、Sublime、WebStorm)保存时需明确选择“UTF-8”而非“UTF-8 with BOM”。BOM(Byte Order Mark)是开头的EF BB BF三个字节,虽不影响多数现代浏览器,但在Node.js、某些构建工具(如Webpack早期版本)或内联<script>中可能被当作非法字符,导致SyntaxError。</script>
- VS Code右下角点击编码名称 → 选择“Save with Encoding” → 点击“UTF-8”(不是“UTF-8 with BOM”)
- 在Git中可通过.gitattributes设置:
* text=auto eol=lf,避免Windows换行符干扰,也间接降低编码混淆风险
HTML中引入外部JS时无需指定charset(现代浏览器已默认)
HTML5规范规定,<script src="app.js"></script>标签在无charset属性时,浏览器会按HTML文档的字符编码(通常由<meta charset="UTF-8">声明)来加载JS文件。显式写charset="UTF-8"已过时,且可能在部分旧环境引发兼容问题。
- ✅ 推荐写法:
<script src="main.js"></script> - ❌ 不推荐:
<script src="main.js" charset="UTF-8"></script>(HTML5中已废弃)
Node.js环境默认使用UTF-8,但读取文件时需留意fs方法
Node.js内部字符串统一为UTF-16,但文件I/O操作(如fs.readFileSync)默认按UTF-8解码二进制内容。只要JS文件本身是UTF-8保存,直接读取即可正常处理中文变量名、字符串等。
立即学习“Java免费学习笔记(深入)”;
- ✅ 安全写法:
fs.readFileSync('./data.js', 'utf8')(显式指定编码更清晰) - ⚠️ 注意:若用
Buffer方式读取后手动转字符串,务必用.toString('utf8'),避免默认调用.toString()(等价于ascii)导致中文变乱码
构建工具与打包器(如Webpack、Vite)通常自动处理,但需检查输入配置
这些工具一般默认按UTF-8读取源码,但若项目存在自定义loader(如raw-loader)、或从非标准路径读取JS片段(如模板字符串拼接的脚本),就可能绕过默认编码逻辑。
- Webpack中可确认
module.rules对.js文件未误配encoding选项 - Vite项目若在
vite.config.ts中使用defineConfig,无需额外编码配置;但通过fs.readFileSync动态读取JS内容时,仍要传'utf8'










