为什么Navicat在跨平台同步脚本时会出现换行符LF和CRLF冲突?

陌涛君_5276

陌涛君_5276

2026-06-28

369人浏览

原创

navicat执行sql脚本报“unexpected token '\r'”是因git跨平台换行转换导致的混合换行符问题,需统一配置.gitattributes(*.sql text eol=lf)并执行git rm --cached -r . && git reset --hard,或用dos2unix清理文件。

navicat 本身不处理脚本文件的换行符转换,它只是原样读取、执行 sql 文件内容。所谓“lf/crlf 冲突”,实际是 git 在跨平台拉取或提交 sql 脚本时自动转换换行符,导致 navicat 执行时遇到非标准换行(比如 windows 下看到 \r\n 被误判为非法字符),或 prettier/eslint 报 delete ␍ 错误——这不是 navicat 的 bug,而是 git + 编辑器 + 工具链协同失准。

Navicat 执行 SQL 脚本时报错:Unexpected token '\r'

这是最典型的症状,尤其在 Windows 上用 Navicat 打开从 macOS/Linux 提交的 SQL 文件时出现。Navicat 的 SQL 解析器对 \r\n 容忍度低,遇到孤立的 \r(比如 LF 文件被 Git 错误转成混合换行)会直接中断解析。

  • 不是所有 SQL 文件都报错:只有含存储过程、函数或复杂注释的脚本才容易触发,因为这些结构对换行敏感
  • Navicat 不会主动修正换行符,也不会提示“检测到 CRLF”,只会静默失败或报语法错误
  • 验证方式:用记事本打开该 SQL 文件 → 若状态栏显示“UTF-8 BOM”或“CRLF”,就基本锁定问题来源

Git 配置 core.autocrlf 和 .gitattributes 必须同时生效

只设 git config --global core.autocrlf false 不够,因为团队其他成员可能仍用默认配置,导致仓库里混入 CRLF;只配 .gitattributes 也不行,如果本地 Git 没启用 autocrlf,规则压根不触发。

navicatmysql
navicatmysql

Navicat For MySQL

下载
  • 项目根目录必须存在 .gitattributes,内容至少包含:
    * text=auto eol=lf
  • SQL 类文件要显式声明:
    *.sql text eol=lf
    ,否则 Git 可能按二进制处理,跳过换行标准化
  • Windows 用户仍需执行:git config --global core.autocrlf input(不是 true),让 Git 在 commit 时把 CRLF 强制转 LF
  • 改完配置后,必须重置工作区:git rm --cached -r . && git reset --hard,否则旧换行符缓存仍在

VS Code / 编辑器保存设置和 Navicat 导入行为不一致

你在 VS Code 里把文件设成 LF 并保存,Navicat 却仍报错?因为 Navicat 的「运行 SQL 文件」功能不走编辑器编码流程,它直接读磁盘字节流。如果文件曾被其他工具(如 Notepad++、PowerShell)以 CRLF 保存过,VS Code 的设置无法覆盖历史痕迹。

  • VS Code 的 files.eol 只影响新创建/另存为的文件,对已存在文件无效
  • 真正可靠的做法:在终端用 dos2unix script.sql 或 sed -i 's/\r$//' script.sql 彻底清理
  • Navicat 导入时勾选「Remove carriage returns (\r)」选项(位于导入向导「高级」页),这是它唯一内置的换行净化开关
  • 若用 Navicat CLI 自动化同步,命令中加 --strip-cr 参数,等效于勾选该选项

最容易被忽略的是:Navicat 同步任务里「从文件导入」和「从查询执行」走的是两套解析逻辑——前者严格校验换行,后者由 MySQL 服务端解析,完全不受客户端换行影响。所以临时绕过问题,可以把 SQL 复制进查询窗口执行,但这不能替代规范治理。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

navicat

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

2585

3

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2023.08.14

3841

10

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

2023.08.31

2831

3

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

927

5

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

2527

5

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

2023.10.16

2527

4

vb连接access数据库的方法
vb连接access数据库的方法

vb连接access数据库方法:1、使用ADO连接,首先导入System.Data.OleDb模块,然后定义一个连接字符串,接着创建一个OleDbConnection对象并使用Open() 方法打开连接;2、使用DAO连接,首先导入 Microsoft.Jet.OLEDB模块,然后定义一个连接字符串,接着创建一个JetConnection对象并使用Open()方法打开连接即可。

2023.10.16

2853

3

vb连接数据库的方法
vb连接数据库的方法

vb连接数据库的方法有使用ADO对象库、使用OLEDB数据提供程序、使用ODBC数据源等。详细介绍:1、使用ADO对象库方法,ADO是一种用于访问数据库的COM组件,可以通过ADO连接数据库并执行SQL语句。可以使用ADODB.Connection对象来建立与数据库的连接,然后使用ADODB.Recordset对象来执行查询和操作数据;2、使用OLEDB数据提供程序方法等等。

2023.10.19

2321

3

mdf文件导入数据库的方法
mdf文件导入数据库的方法

mdf文件导入数据库的方法有使用SQL Server Management Studio、使用SQL Server命令行工具、使用SQL Server Integration Services等方法。想了解更多mdf文件导入数据库的方法的相关内容,可以阅读本专题下面的文章。

2023.10.23

2473

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习