问题背景
在使用 Hugo 搭建博客过程中，我遇到了以下错误信息：
1Error: "F:\Blog\hugo\blog\layouts\partials\sidebar\left.html:65:1": parse failed: template: partials/sidebar/left.html:65: unterminated quoted string
这个错误是由 Cursor 编辑器的"保存文件自动格式化代码"功能导致的。特别是在处理 Hugo 模板文件时，自动格式化可能会破坏原有的模板语法结构。
错误分析
错误消息解读
这个错误包含以下关键信息：
- 文件位置：
F:\Blog\hugo\blog\layouts\partials\sidebar\left.html - 错误行号：第 65 行，第 1 个字符位置
- 错误类型：
parse failed（解析失败） - 具体原因：
unterminated quoted string（未终止的带引号字符串）
问题代码示例
出错的代码片段大致如下：
1{{ warnf "Menu item [%s] is using [pre] field to set icon, please use [params.icon] instead.\nMore
2 information: https://stack.jimmycai.com/config/menu" .URL }}
错误原因
问题出在 warnf 函数调用的第一个参数上。这是一个使用双引号( " )定义的字符串，但字符串内容跨越了多行。
在 Go 模板（ Hugo 使用的模板引擎）中，双引号定义的字符串不能直接包含源代码中的换行符。当解析器看到第一行末尾的换行时，它认为这一行代码结束了，但还没有找到字符串的结束引号 " ，因此报告"未终止的带引号字符串"错误。
解决方案
使用反引号定义字符串
最推荐的方式是使用反引号( ` )代替双引号定义字符串，因为反引号定义的字符串（原始字符串字面量）可以直接跨越多行，并保留其中的换行和空格：
1{{ warnf `Menu item [%s] is using [pre] field to set icon, please use [params.icon] instead.
2 More information: https://stack.jimmycai.com/config/menu` .URL }}
注意：使用反引号时，字符串中的 \n 不会被解释为换行符，而是字面上的 \ 和 n 两个字符。但由于源代码中已包含实际换行，所以效果通常与预期相同。
将字符串放在同一行
如果希望继续使用双引号，并且需要 \n 被解释为换行符，可以将整个字符串写在同一行：
1{{ warnf "Menu item [%s] is using [pre] field to set icon, please use [params.icon] instead.\nMore information: https://stack.jimmycai.com/config/menu" .URL }}
这种方式对于较长字符串可能会降低代码可读性。
防止问题再次发生
关闭 Cursor 自动格式化功能
为避免类似问题再次发生，可以关闭 Cursor 的"保存文件自动格式化代码"功能。
通过设置界面关闭
- 打开 Cursor 设置：
- Windows/Linux：按
Ctrl + ,键 - macOS：按
Cmd + ,键
- 搜索"保存时格式化"选项：
- 在设置顶部的搜索栏输入
format on save - 找到
Editor: Format On Save或类似选项
- 关闭选项：
- 取消勾选该选项（或将其设置为
false）
通过配置文件手动修改
如果在设置界面找不到相应选项，可以直接编辑用户设置文件：
- 打开 Cursor 的settings.json：
- 按
Ctrl + Shift + P（或Cmd + Shift + P）打开命令面板 - 输入
Preferences: Open User Settings (JSON)并回车
-
添加或修改配置：
1{ 2 "editor.formatOnSave": false 3} -
保存文件后自动生效
其他可能的解决方法
-
为特定文件类型禁用格式化： 如果你只想为 Hugo 模板文件禁用自动格式化，可以添加语言特定设置：
1{ 2 "[html]": { 3 "editor.formatOnSave": false 4 } 5} -
使用.prettierignore： 如果 Cursor 使用 Prettier 作为格式化工具，可以在项目根目录创建
.prettierignore文件，并添加需要忽略的模板文件路径。
总结
Go模板引擎对字符串的处理有特定规则，特别是对于多行字符串，使用反引号(`)是最安全的选择。为避免编辑器自动格式化导致的语法错误，建议对模板文件禁用自动格式化功能，或使用符合模板语法的编码方式。