HTML5跨平台协作问题源于BOM、换行符、路径分隔符、Git配置等元信息；VS需关闭UTF-8 with BOM、设LF换行符，并配合.editorconfig与.gitattributes统一规范。
Visual Studio（VS）本身不直接编译或打包 HTML5 应用，它只是个编辑器/IDE；真正影响跨系统协作的是文件编码、换行符、路径分隔符、构建工具链和 Git 配置——不是 VS 本身要“转格式”。
HTML5 文件在 Windows 和 macOS 之间共享时，哪些地方会出问题
常见错误现象：mac 团队打开 VS 保存的 .html 或 .js 文件后，中文乱码、CSS 不生效、脚本报错但查不出语法问题；或者本地 file:// 路径能跑，一放到 macOS 的本地服务器就 404。
-
UTF-8 with BOM是 Windows 上 VS 默认可能加上的编码，macOS 和大多数 Web 服务器（如live-server、http-server）会把它当非法字符处理，导致 JS 解析失败或 CSS @import 失效 - 换行符默认是
CRLF（Windows），而 macOS/Linux 期望LF；虽现代浏览器基本兼容，但某些构建工具（如webpack的 watch 模式、eslint）会因换行差异触发重复编译或校验失败 - 硬编码的路径如
C:\project\assets\img.png或..\\css\\main.css在 macOS 上直接崩，尤其在 JS 动态拼接路径时
VS 里怎么关掉 BOM 和统一换行符
VS 默认行为对跨平台不友好，必须手动调。关键不是“能不能传”，而是“传过去会不会悄悄坏掉”。
- 关闭 BOM：打开文件 → 文件 → 高级保存选项 → 编码选
UTF-8（注意不是UTF-8 with signature）→ 行尾符选LF - 批量设置：在 VS 的
工具 → 选项 → 文本编辑器 → 常规中，勾选以 LF 作为行尾符保存文件（VS 2022 17.6+ 支持） - 新建文件默认编码：修改
.editorconfig（项目根目录），加两行：[*.{html,htm,css,js,ts,json}]\ncharset = utf-8\nend_of_line = lf
Git 配置不设好，团队一提交就覆盖对方的换行和编码
即使 VS 里设对了，如果 Git 自动转 CRLF ↔ LF，协作时仍会出问题——比如 Windows 同学 commit 后，mac 同学 pull 到的文件莫名多出 ^M 或中文变问号。
立即学习“前端免费学习笔记（深入）”；
- 全局禁用自动换行转换：
git config --global core.autocrlf false（推荐，让 Git 完全不管换行，靠编辑器和.editorconfig管） - 或更稳妥：项目根加
.gitattributes，明确声明：* text=auto eol=lf\n*.html text eol=lf\n*.js text eol=lf\n*.css text eol=lf
- 已有仓库出过问题？先
git rm --cached -r . && git reset --hard清缓存重索引（慎用，先备份）
真正卡住协作的，从来不是 VS 或 macOS 本身，而是那些看不见的元信息：BOM、换行符、Git 的隐式转换、相对路径里的反斜杠。这些细节一旦混进代码，排查起来比逻辑 bug 还费时间——尤其当问题只在别人机器上复现时。
