VSCode中Go文件第一行特殊注释时如何禁用保存自动格式化？

如果你遇到Go文件首行的特殊注释（比如//usr/bin/env echo hello这类用作系统加载器脚本的注释）在保存时被自动格式化破坏，且全局禁用formatOnSave不是理想方案，可以试试以下几种方法：

1. 调整注释格式适配gofmt #

gofmt（Go官方格式化工具）本身会保留首行的shebang风格注释，只要把注释改成带空格的标准形式：

// usr/bin/env echo hello

或者更规范的shebang写法（虽然Go不是脚本语言，但多数工具兼容）：

// #!/usr/bin/env echo hello

这种格式下，gofmt不会改动这一行，既保留了注释的功能，又能正常格式化文件其他内容。

2. 用//go:noformat指令跳过整个文件格式化 #

如果不想调整注释格式，可以在文件最开头添加//go:noformat标记，让gofmt直接跳过整个文件的格式化：

//go:noformat
//usr/bin/env echo hello
package main

// 其他代码...

注意这个方法会禁用整个文件的格式化，适合对格式化要求不高的场景。

3. 自定义格式化脚本保留首行 #

如果只想保留首行、正常格式化其余内容，可以写一个简单的脚本先提取首行，再用gofmt处理剩余内容，最后合并：

#!/bin/bash
# 保存为go-format-preserve-first-line.sh
if [ $# -ne 1 ]; then
    echo "Usage: $0 <go-file>"
    exit 1
fi
temp_file=$(mktemp)
# 提取首行
head -n 1 "$1" > "$temp_file"
# 格式化剩余内容并追加
tail -n +2 "$1" | gofmt >> "$temp_file"
# 替换原文件
mv "$temp_file" "$1"

然后在编辑器中把格式化工具设置为这个脚本（比如VS Code里修改go.formatTool为脚本路径），这样就能兼顾首行保留和其余内容格式化。

4. 编辑器插件的单行忽略功能 #

部分编辑器插件支持单行跳过格式化，比如VS Code的Formatting Toggle插件，或者在目标行附近添加特定标记（如// fmt:skip），不过这类标记的兼容性取决于你使用的格式化插件，需要自行测试。

内容的提问来源于stack exchange，提问作者Gurjeet Singh