beego命名空间是带作用域隔离的路由分组机制，需显式调用beego.addnamespace()注册才生效；支持nscond条件过滤、nsinclude复用及路径前缀组合实现逻辑分层，但不支持嵌套，且nscond执行早于参数解析。
Beego 的命名空间（Namespace）不是“多级目录式路由前缀”的简单叠加，而是带作用域隔离的路由分组机制；它本身不嵌套子命名空间，但可通过组合 NSCond、NSRouter 和 NSInclude 实现逻辑分层与条件路由复用。
命名空间必须显式注册到全局路由树
只调用 beego.NewNamespace() 不会生效，必须用 beego.AddNamespace() 才真正挂载。漏掉这一步是 404 最常见原因。
-
beego.AddNamespace(ns)是唯一生效入口，ns.Router()或ns.NSCond()只是构建中间态 - 多个命名空间可共存，但路径不能冲突；后注册的会覆盖先注册的同路径规则（无警告）
- 命名空间内定义的
NSFilter仅对本空间内路由生效，不会污染全局
路径前缀 + 条件过滤器（NSCond）实现“伪多级”控制
Beego 不支持 NSInclude(NSInclude(...)) 嵌套，但可用 NSCond 绑定运行时条件（如 header、query、用户角色），配合路径前缀达成类似效果。
- 例如管理后台按角色分流：
beego.NewNamespace("/admin", beego.NSCond(func(ctx *context.Context) bool { return ctx.Input.Session("role") == "admin" }), ...) -
NSCond返回false时，整个命名空间路由跳过匹配，请求继续向下查找其他路由 - 避免在
NSCond中做耗时操作（如 DB 查询），否则阻塞所有该前缀下的请求
NSInclude 复用外部路由定义，但要注意初始化顺序
NSInclude 用于把已定义好的命名空间或路由集合“插入”当前空间，常用于模块化拆分（如 /api/v1 和 /api/v2 各自独立文件）。
- 被
NSInclude的命名空间必须已创建完成，且不能依赖未初始化的变量（如未赋值的AppConfig） - 若
NSInclude的子空间也含NSCond，条件判断仍基于原始请求上下文，不会自动叠加父空间条件 - 调试时可用
beego.BeeApp.Handlers.ShowAllHandlers()查看最终注册的完整路由表，确认包含关系是否符合预期
真正容易被忽略的是：命名空间的 NSRouter 和控制器方法绑定后，其参数提取逻辑（如 :id）仍走 Beego 默认解析流程，但 NSCond 的执行时机早于参数解析 —— 换句话说，你无法在条件函数里直接读取 ctx.Input.Param(":id")，得改用 ctx.Input.URL() 自行正则提取。
