在 Go 中，应避免通过符号链接等方式跨包复用结构体文件；正确做法是将公共结构体提取为独立的 model 或 types 包，由其他包统一导入，确保类型唯一性与代码可维护性。
在 go 中，应避免通过符号链接等方式跨包复用结构体文件；正确做法是将公共结构体提取为独立的 `model` 或 `types` 包，由其他包统一导入，确保类型唯一性与代码可维护性。
Go 语言强调“一个包，一个职责”，同时严格遵循类型系统一致性原则：同一结构体定义若出现在多个包中（即使内容完全相同），也会被视为不同类型，无法互相赋值或比较。因此，像 server.Response 和 routines.Response 这样看似相同的结构体，在 Go 类型系统中实为两个不兼容的类型——这正是硬链接 structs.go 到多个目录所导致的根本问题。
✅ 推荐方案：创建专用的 model 包
将原 structs.go 文件移至新目录 model/，并声明为独立包：
myprogram/
├── main/
│ └── main.go
├── server/
│ └── server.go
├── routines/
│ └── routines.go
└── model/ # ← 新增公共结构体包
└── model.go # 包声明：package model
model/model.go 示例：
package model
// User 表示系统用户，被 server 和 routines 共同使用
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email"`
}
// Response 是标准 API 响应结构
type Response struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}
各业务包通过标准 import 引用：
// server/server.go
package server
import (
"myprogram/model" // ← 显式导入 model 包
)
func HandleUser(u model.User) model.Response {
return model.Response{Code: 200, Message: "OK", Data: u}
}
// main/main.go
package main
import (
"myprogram/model"
"myprogram/server"
"myprogram/routines"
)
func main() {
u := model.User{ID: 1, Name: "Alice"}
resp := server.HandleUser(u) // 类型安全，无隐式转换
_ = routines.Process(resp)
}
⚠️ 注意事项：
- 包路径需唯一：确保 myprogram/model 在 go.mod 所在模块下可解析（建议 go mod init myprogram 并保持目录结构与导入路径一致）；
- 避免循环依赖：model 包不得反向导入 server 或 routines；
- 命名清晰：若结构体偏业务域，可用 domain 替代 model；若纯数据契约，types 或 schema 亦可；
- 轻量项目可暂不拆分：若项目仅含数个文件且无明确扩展需求，保留在 main 包内更简洁——Go 鼓励“先简单，后抽象”。
总结：Go 的包设计不是为了强行分层，而是为了明确依赖边界、保障类型一致性、支持渐进式演进。将共享结构体置于独立包，是兼顾可读性、可测试性与可维护性的最佳实践。
