“command-line-arguments”不是错误而是go工具链为临时编译生成的虚拟包名，根本原因是未正确识别main包：常见于缺失main.go、package main声明、utf-8 bom干扰、go.mod路径不匹配或go run参数误用（如go run .在无模块时降级），需确保目录含合法main包且命令指定明确文件或路径。
直接运行单文件时出现 “command line-arguments” 错误
这不是编译失败，而是 Go 工具链在找不到明确包路径时，自动给当前目录起的临时包名 —— command line-arguments。它本身不是错误信息，但常伴随 cannot load command line-arguments: no Go files in current directory 或构建失败提示，说明 Go 没识别出合法的 main 包。
- 最常见原因：当前目录下没有
main.go，或有但没在package main下写func main() - 另一个高频坑：文件名是
app.go或server.go，但内容里漏了package main声明（Go 要求可执行文件必须是main包） - Windows 用户容易忽略：用记事本保存时选了 UTF-8 with BOM，导致 Go 解析失败，报错看似无关，实则卡在包声明读取阶段
- 如果目录里有
go.mod但模块名和当前路径不匹配（比如module example.com/foo，但你在/tmp/bar下运行），go run .也会退回到command line-arguments
go run 后面该填什么：路径、文件名还是包名？
go run 的参数不是随意写的路径，它严格区分三类输入：
- 单个
.go文件：如go run main.go—— 这是最安全的方式，Go 直接编译并运行该文件，不依赖模块路径 - 目录路径：如
go run ./cmd/myapp—— 要求该目录下存在main.go，且其go.mod中定义的模块能解析到这个子目录（即./cmd/myapp是一个有效的包导入路径） - 包导入路径：如
go run example.com/myapp/cmd/myapp—— 必须已通过go mod tidy或go get安装过该包，否则报cannot load example.com/myapp/cmd/myapp: module example.com/myapp@latest not found - 绝对禁止：
go run .在无go.mod或模块路径混乱时，会触发command line-arguments回退逻辑，行为不可控
VS Code 调试时 program 字段填错导致 same error
VS Code 的 launch.json 中 program 字段若填成 "." 或 "./"，Delve 就无法定位入口，最终也表现为 command line-arguments 相关的构建失败或 could not launch process。
- 正确填法只有两种：
"${workspaceFolder}/main.go"（单文件项目），或"${workspaceFolder}/cmd/myapp"（多包结构，对应cmd/myapp/main.go） - 不要依赖
go run .能跑通就以为program: "."也能行 —— Delve 不走go run的包发现逻辑，它需要明确的源码路径或包路径 - 如果项目根目录没有
go.mod，Delve 可能根本找不到依赖，此时即使program填对了，也会在构建阶段卡住并输出含command line-arguments的模糊错误
为什么 go build -o xxx 后运行正常，go run 却报这个？
因为 go build 和 go run 对“当前工作区”的理解不同：go build 只关心能否找到 main 函数并链接成功；而 go run 在构建前会先做一次模块解析，若失败就降级为 command line-arguments 模式，再尝试编译 —— 这个降级过程极易暴露路径/模块配置问题。
- 典型场景：你在子目录里执行
go run ../main.go，虽然语法合法，但 Go 会以当前目录为模块根去解析依赖，很可能失败 - 更隐蔽的问题：
GO111MODULE=off环境下运行go run，它会忽略go.mod，强行走老式 GOPATH 模式，结果找不到包，又 fallback 到command line-arguments - 验证方式：运行
go list -f '{{.Name}}' .，如果输出不是main，说明 Go 根本没把你当前目录当main包看待 —— 这就是所有问题的起点
真正卡住人的地方，往往不是语法写错，而是 Go 在背后悄悄切换了模块解析模式，而你只看到 command line-arguments 这个毫无上下文的占位符。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
