在 IntelliJ IDEA 中使用 Go 插件时，新建的 .go 文件未被自动纳入构建会导致编译错误；需确保使用「Go Application」运行配置并指定完整包路径，而非「Go Single file」，才能使多文件项目正常编译与运行。
在 intellij idea 中使用 go 插件时，新建的 `.go` 文件未被自动纳入构建会导致编译错误；需确保使用「go application」运行配置并指定完整包路径，而非「go single file」，才能使多文件项目正常编译与运行。
当你在 Go 项目中新增一个 .go 文件（例如 utils.go 或 handler.go），IDE 并不会自动将其加入构建上下文——这与 Go 的构建模型密切相关：Go 编译器按包（package） 而非单个文件组织代码，只要文件位于同一目录、声明相同的 package main（或对应包名），且语法合法，go build 或 go run . 就会自动包含所有 .go 文件。
但在 IntelliJ IDEA 的 Go 插件中，运行配置类型决定了构建行为：
- ✅ Go Application（推荐）：等效于 go build ./... && ./binary，支持整个包（当前目录及子目录，取决于配置）；需在配置中明确指定 Package path（如 . 表示当前模块根目录，main 表示主包，或完整导入路径如 github.com/yourname/project/cmd/app）。
- ❌ Go Single file：等效于 go run main.go，仅编译并运行指定单个文件，忽略同目录下其他 .go 文件，因此引用新文件中的函数或变量必然报错（undefined）。
? 操作步骤（IntelliJ IDEA）：
- 点击右上角运行配置下拉菜单 → Edit Configurations…
- 左侧点击 + → 选择 Go Application
- 在 Package path 栏输入：
- 若项目是模块化（含 go.mod），填 .（当前目录）或完整模块路径（如 example.com/myapp）；
- 若为传统 GOPATH 项目，填相对 $GOPATH/src 的路径（如 myproject/cmd/app）
- 确保 Run kind 为 Package（非 File）
- 点击 OK，然后运行该配置
? 额外验证建议：
- 终端执行 go list -f '{{.Name}}' . 确认当前目录是否被识别为有效 Go 包；
- 执行 go build -v . 观察是否成功编译全部 .go 文件；
- 新增文件务必以 package main（主程序）或对应包名开头，且无语法错误（如缺少分号、未使用的导入等），否则仍会构建失败。
? 小结：Go 项目依赖显式包结构而非 IDE 自动索引。正确设置运行配置为 Go Application + Package path = .，即可让新添加的 .go 文件无缝参与构建与运行——这才是符合 Go 工具链设计的标准化实践。
