跨平台开发里的换行符与文件一致性

这类问题最讨厌的地方在于它不报错。文件能传上去、能执行，只是行为偶尔和本地不一样。等意识到是换行符的时候，往往已经排查了很久。

几个反复出现的现象

• 用 md5 比对本地与服务器上的同一个文件，内容看起来完全一样，哈希却对不上。
• Shell 脚本上传后在服务器上报类似 "\r: command not found" 的错误。
• 模板文件渲染出来每一行末尾多出不可见字符，前端偶尔表现为布局错位。
• 同一个文件在不同机器上被反复"改动"，版本记录里全是噪声。

怎么约束

第一层是仓库层面。用 .gitattributes 明确声明文本文件统一使用 LF，让检出和提交时自动归一化，从源头避免不同机器产生不同结果：

# .gitattributes
* text=auto eol=lf
*.sh text eol=lf
*.bat text eol=crlf

第二层是部署校验。在覆盖线上文件之前先做一次归一化比较，只有归一化之后仍然一致的才跳过，不一致的才上传。这一步能拦住"本地和线上明明是同一份代码却互相覆盖"的情况：

# 去掉回车再比对，排除换行符差异\nlocal_hash=$(tr -d '\r' < "$file" | md5sum | cut -d' ' -f1)\nremote_hash=$(ssh "$host" "tr -d '\r' < '$remote_path' | md5sum | cut -d' ' -f1")\n\nif [ "$local_hash" = "$remote_hash" ]; then\n  echo "内容一致，跳过上传"\nfi

一点经验

这类问题的解法是"约束"而不是"小心"。靠人记住不要用某个编辑器、不要做某步操作，一定会失效。把它变成仓库配置和部署脚本里的一个固定动作之后，这类问题就从日常里消失了。