拓冰网站定制 
后端Web框架【免费下载链接】chilightweight, idiomatic and composable router for building Go HTTP services项目地址https://gitcode.com/gh_mirrors/ch/chi点击查看免费下载导读本文以 chi 官方 REST 示例_examples/rest自动生成的路由文档 routes.md 为骨架逐条剖析其中的 10 条路由及其背后的中间件链、嵌套子路由、URL 参数与正则匹配模式。读完本文你将能熟练反向阅读任何一份 chi 的 docgen 路由文档并能参照 main.go 亲手搭建一个同样结构清晰、可维护的 REST API 服务。一、这份路由文档从何而来docgen 与-routes标志routes.md 并不是手写的文档而是 chi 官方 REST 示例通过docgen工具自动生成的路由快照。它精确记录了一个chi.Router在某一时刻的完整路由拓扑每条路由匹配的模式、可用的 HTTP 方法、挂载的中间件、以及最终处理函数在源码中的位置。生成机制就在 main.go 的 flag 定义中var routes flag.Bool(routes, false, Generate router documentation)当以-routes参数启动程序时main.go 会调用docgen输出文档并提前退出if *routes { // fmt.Println(docgen.JSONRoutesDoc(r)) fmt.Println(docgen.MarkdownRoutesDoc(r, docgen.MarkdownOpts{ ProjectPath: github.com/go-chi/chi/v5, Intro: Welcome to the chi/_examples/rest generated docs., })) return }也就是说在_examples/rest目录下执行go run . -routes即可在标准输出看到本文的原始素材而目录下的 routes.json 则是同一路由树以 JSON 结构导出的版本其router.routes字段与 Markdown 版一一对应适合程序化消费。该示例依赖的docgen版本为 v1.2.0见 go.mod。附带一提-routes分支只是打印文档不传该 flag 时程序才会真正以http.ListenAndServe(:3333, r)启动服务main.go。二、每条路由前的五件套全局中间件链浏览 routes.md 会发现一个显著规律十条路由中的每一条都共享同一组前置中间件。这正是 chi 中间件模型的直观体现——在根路由上r.Use(...)注册的中间件会贯穿整棵路由树。r.Use(middleware.RequestID) r.Use(middleware.Logger) r.Use(middleware.Recoverer) r.Use(middleware.URLFormat) r.Use(render.SetContentType(render.ContentTypeJSON))见 main.go。routes.md 中每条路由都重复列出这五项逐一看它们的职责1.RequestID— 为每个请求注入唯一标识对应 middleware/request_id.go。它在进程启动时基于主机名与随机 base62 串生成前缀随后为每个请求注入形如host.example.com/random-0001的请求 ID。实现上若请求头已携带X-Request-Id则沿用否则由原子计数器累加生成request_id.go。该 ID 被存入请求上下文供 Logger、Recoverer 等下游中间件关联日志。2.Logger— 记录请求开始、结束与耗时对应 middleware/logger.go。它打印每个请求的起止时间、路径、状态码与耗时在 TTY 终端下还会输出彩色日志。源码注释特别强调Logger 应放在 Recoverer 等可能改写响应的中间件之前logger.go示例中的注册顺序恰好遵循了这一点。3.Recoverer— panic 恢复与 500 兜底对应 middleware/recoverer.go。任何处理器中未被捕获的 panic 都会被它接住打印格式化堆栈通过PrintPrettyStack输出到 stderr并尽可能向客户端返回 HTTP 500recoverer.go。这正是本文后面GET /panic测试路由能安全崩溃的底层保障。4.URLFormat— 解析 URL 扩展名对应 middleware/url_format.go。它从请求路径中解析出扩展名如/articles/1.json中的json存入middleware.URLFormatCtxKey对应的上下文键并把扩展名从路由路径中裁剪掉再继续匹配url_format.go。这意味着/articles/1、/articles/1.json、/articles/1.xml可以命中同一条GET /articles/{articleID}路由由处理器根据格式决定 JSON/XML 响应。5.render.SetContentType— 统一响应类型来自外部依赖github.com/go-chi/renderv1.0.1见 go.modSetContentType(render.ContentTypeJSON)为所有响应预置application/json。它是软性中间件处理器仍可显式覆盖。routes.md 中它以匿名函数形式SetContentType.func1出现对应 render 包的 content_type.go#L49JSON 版路由文档中anonymous: true标记了这一点routes.json。阅读提示routes.md 中这些中间件名都带源码锚点例如[RequestID](https://link.gitcode.com/i/d42c7c6017181d4581c039a74137ab25)在仓库内可直接跳转到对应定义行——这是 docgen 文档最具实用价值的地方。三、十条路由全景routes.md 末尾标注Total # of routes: 10。先总览全貌路由模式方法处理器含行内中间件源码位置/GET根路由匿名函数main.go/admin/*GETAdminOnly admin 索引main.go/admin/*/accountsGETAdminOnly 账户列表main.go/admin/*/users/{userId}GETAdminOnly 查看用户main.go/articles/*GET / POSTpaginateListArticles/CreateArticlemain.go main.go/articles/*/searchGETSearchArticlesmain.go/articles/*/{articleID}/*GET / PUT / DELETEArticleCtx 对应 CRUDmain.go/articles/*/{articleSlug:[a-z-]}GETArticleCtxGetArticlemain.go/panicGET触发 panic 的测试函数main.go/pingGET返回pong的函数main.go说明docgen 输出的模式如/articles/*、/admin/*带*后缀是 chi 树形路由在文档中的呈现形式——*表示该节点下有子路由分支并非要求请求路径本身带通配符。请求如/articles、/articles/123均能匹配。这批路由可分为三组理解基础探测路由、RESTy 资源路由articles、独立挂载的子路由admin。四、深入 articles 资源嵌套子路由、URL 参数与正则路由/articles是这份文档的核心它演示了 chi 最标志性的能力用嵌套的Route声明式地组织一个 REST 资源main.gor.Route(/articles, func(r chi.Router) { r.With(paginate).Get(/, ListArticles) r.Post(/, CreateArticle) // POST /articles r.Get(/search, SearchArticles) // GET /articles/search r.Route(/{articleID}, func(r chi.Router) { r.Use(ArticleCtx) // Load the *Article on the request context r.Get(/, GetArticle) // GET /articles/123 r.Put(/, UpdateArticle) // PUT /articles/123 r.Delete(/, DeleteArticle) // DELETE /articles/123 }) // GET /articles/whats-up r.With(ArticleCtx).Get(/{articleSlug:[a-z-]}, GetArticle) })4.1 列表与创建/articles/*GET /articles由 ListArticles 处理返回文章列表docgen 显示它带main.paginate行内中间件main.go。paginate在示例中只是空壳桩注释称完全可以实现查询参数处理逻辑但它示范了 chi 的With行内中间件用法只在单条路由上生效而不影响同级其他路由。POST /articles由 CreateArticle 处理通过render.Bind反序列化请求体写入内存模拟数据库后返回201 Created。4.2 单资源 CRUD/articles/{articleID}嵌套的r.Route(/{articleID}, ...)创建了一个子路由空间其中r.Use(ArticleCtx)让 GET/PUT/DELETE 三个方法共享同一个上下文加载中间件。ArticleCtxmain.go从chi.URLParam(r, articleID)取出 ID查询文章并把*Article存入请求上下文查不到时直接渲染404终止链条。于是下游处理器GetArticle、UpdateArticle、DeleteArticle只需从r.Context().Value(article)取数据即可彻底消除了每个方法各自解析 URL 参数 查询的重复代码。这正是 routes.md 中这三条方法都归在ArticleCtx之下的原因。4.3 正则参数路由/articles/{articleSlug:[a-z-]}GET /articles/whats-up由带正则约束的占位符{articleSlug:[a-z-]}匹配只接受小写字母与连字符组成的 slug。docgen 把正则原样展示在路由模式中一眼即可看出约束。它同样经过ArticleCtx此时 ArticleCtx 改走dbGetArticleBySlug分支最终复用同一个GetArticle渲染器。4.4 资源型 API 的完整方法矩阵将上述组合起来articles 资源覆盖了常见的 REST 方法面列表GET可扩展分页、创建POST、读取GET by ID / by slug、更新PUT、删除DELETE且每个环节都通过中间件做了解耦——这种方法共享上下文中间件的组织方式是 chi 官方推荐的 REST 服务骨架。五、admin 子路由Mount 挂载与 AdminOnly 鉴权中间件/admin/*三个分支展示的是 chi 的另一种组合方式独立构造的子路由器通过Mount挂载。r.Mount(/admin, adminRouter())main.go而adminRouter()main.go是一个全新的chi.NewRouter()func adminRouter() chi.Router { r : chi.NewRouter() r.Use(AdminOnly) r.Get(/, func(w http.ResponseWriter, r *http.Request) { w.Write([]byte(admin: index)) }) r.Get(/accounts, ...) r.Get(/users/{userId}, func(w http.ResponseWriter, r *http.Request) { w.Write([]byte(fmt.Sprintf(admin: view user id %v, chi.URLParam(r, userId)))) }) return r }代码注释明确指出Mount与r.Route(/admin, ...)效果相同main.go区别在于子路由器拥有独立、全新的中间件栈。AdminOnlymain.go是一个典型的鉴权中间件从上下文读取acl.admin布尔标记未授权时直接http.Error返回 403 Forbidden否则放行。routes.md 中/admin/*的三个分支全部列在AdminOnly之下正是这一子路由级中间件的文档化呈现——说明AdminOnly对 admin 路由器内的所有路由生效但不影响/articles等兄弟路由。这与全局五件套形成了清晰的两层中间件结构全局层RequestID→Logger→Recoverer→URLFormat→SetContentType 子路由层AdminOnly / ArticleCtx / paginate。六、基础探测路由/、/ping与/panicGET /返回字符串root.是服务存活与连通性的最小验证点main.go。GET /ping返回pongmain.go常被健康检查或探活脚本使用。GET /panic直接执行panic(test)main.go用于验证 Recoverer 中间件确实在工作客户端会收到 500服务端 stderr 打印格式化堆栈而进程不会崩溃。这个路由的存在本身就说明了 chi 中间件链的容错设计是可观察、可测试的。三条路由在 routes.md 中均显示为匿名函数main.main.func1等对应 routes.json 中anonymous: true的标记——它们是 main 包内联声明的闭包处理器。七、路由模式语法读懂{userId}、{articleID}、{articleSlug:[a-z-]}、*routes.md 中出现的四类模式在 chi.go 的包级文档中有权威定义具名占位符{name}匹配到下一个/或 URL 结尾的任意字符序列例如{userId}、{articleID}。注意它不匹配/因此/articles/{articleID}不会误吞多段路径。带正则的占位符{name:regexp}使用 Go 的 RE2 语法且正则中/永远不参与匹配例如{articleSlug:[a-z-]}只匹配纯小写字母与连字符。匿名正则{:regexp}name可留空。通配符*匹配 URL 剩余部分唯一能匹配/的占位符例如/page/*可匹配/page/intro/latest这也是 docgen 输出中*后缀的来源之一。处理器侧通过chi.URLParam(r, userId)等函数读取捕获值见 main.go 的 admin 用户路由或直接调用r.Context().Value(...)取已注入的对象。八、亲自动手运行示例并复现文档_examples/rest是一个可直接运行的完整示例依赖声明在 go.mod服务默认监听 3333 端口参照 _examples/README.md 的通用运行说明# 在示例目录内启动服务 go run . # 另开终端验证各路由输出与 main.go 头注释中的预期一致 curl http://localhost:3333/ # root. curl http://localhost:3333/ping # pong curl http://localhost:3333/articles # [{id:1,title:Hi},{id:2,title:sup}] curl http://localhost:3333/articles/1 # {id:1,title:Hi} curl -X DELETE http://localhost:3333/articles/1 curl http://localhost:3333/articles/1 # Not Found curl -X POST -d {id:will-be-omitted,title:awesomeness} http://localhost:3333/articles curl http://localhost:3333/articles/97 # {id:97,title:awesomeness}上述 curl 序列完整复现了 main.go 头注释中的交互示例其中 POST 返回id: 97的原因是 dbNewArticle 用rand.Intn(100)10生成新 ID且 ArticleRequest.Bind 会清空客户端传入的受保护id字段——这正是请求/响应分离 payload设计ArticleRequest 与 ArticleResponse的直观体现。重新生成路由文档go run . -routes routes.md go run . -routes | jq . # 若想生成 JSON 版可将 main.go 中的输出切换为 docgen.JSONRoutesDoc(r)生成结果即为 routes.md / routes.json 的原始来源。任何路由或中间件的增删改都会同步反映在重新生成的文档中让路由拓扑始终与代码保持一致。结语一份看似简单的 routes.md浓缩了 chi 路由器的全部核心设计Use注册的全局中间件链、Route嵌套组织的资源型路由、With注入的行内中间件、Mount挂载的独立子路由器、URL 参数与正则约束、以及 docgen 自动化的文档产出。结合 main.go、routes.json 与 middleware 目录下的各中间件源码你既可以在几分钟内搭出同构的 REST 服务也能把任何一份 docgen 路由文档当作运行中的架构图来阅读——这正是 chi 轻量、惯用、可组合设计哲学的最佳注脚。赞分享后端Web框架【免费下载链接】chilightweight, idiomatic and composable router for building Go HTTP services项目地址https://gitcode.com/gh_mirrors/ch/chi点击查看免费下载相关推荐Livedown的未来路线图实时协作和云同步功能的展望Livedown的未来路线图实时协作和云同步功能的展望 Livedown作为一款深受开发者喜爱的实时Markdown预览工具正通过持续迭代为用户带来更优质的开发工具go-chi/chi v5 完全指南轻量、可组合的 Go HTTP 路由与中间件框架go chi/chi v5 完全指南轻量、可组合的 Go HTTP 路由与中间件框架 chi 是一个基于 Go 标准库 net/http 构建的轻量级、惯用且后端API网关5分钟搞定Windows系统免费安装苹果平方字体的完整指南5分钟搞定Windows系统免费安装苹果平方字体的完整指南 还在为Windows系统上中文字体显示效果不够清晰而烦恼吗想让您的文档、网页和设计作品拥有苹果M前端上一篇termbox-go输入模式详解Esc模式、Alt模式和鼠标事件处理下一篇如何调试termbox-go应用常见问题与解决方案终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 chi REST 路由文档全解读：从 routes.md 读懂 chi 的路由组织、中间件链与资源型 API 设计
后端Web框架【免费下载链接】chilightweight, idiomatic and composable router for building Go HTTP services项目地址https://gitcode.com/gh_mirrors/ch/chi点击查看免费下载导读本文以 chi 官方 REST 示例_examples/rest自动生成的路由文档 routes.md 为骨架逐条剖析其中的 10 条路由及其背后的中间件链、嵌套子路由、URL 参数与正则匹配模式。读完本文你将能熟练反向阅读任何一份 chi 的 docgen 路由文档并能参照 main.go 亲手搭建一个同样结构清晰、可维护的 REST API 服务。一、这份路由文档从何而来docgen 与-routes标志routes.md 并不是手写的文档而是 chi 官方 REST 示例通过docgen工具自动生成的路由快照。它精确记录了一个chi.Router在某一时刻的完整路由拓扑每条路由匹配的模式、可用的 HTTP 方法、挂载的中间件、以及最终处理函数在源码中的位置。生成机制就在 main.go 的 flag 定义中var routes flag.Bool(routes, false, Generate router documentation)当以-routes参数启动程序时main.go 会调用docgen输出文档并提前退出if *routes { // fmt.Println(docgen.JSONRoutesDoc(r)) fmt.Println(docgen.MarkdownRoutesDoc(r, docgen.MarkdownOpts{ ProjectPath: github.com/go-chi/chi/v5, Intro: Welcome to the chi/_examples/rest generated docs., })) return }也就是说在_examples/rest目录下执行go run . -routes即可在标准输出看到本文的原始素材而目录下的 routes.json 则是同一路由树以 JSON 结构导出的版本其router.routes字段与 Markdown 版一一对应适合程序化消费。该示例依赖的docgen版本为 v1.2.0见 go.mod。附带一提-routes分支只是打印文档不传该 flag 时程序才会真正以http.ListenAndServe(:3333, r)启动服务main.go。二、每条路由前的五件套全局中间件链浏览 routes.md 会发现一个显著规律十条路由中的每一条都共享同一组前置中间件。这正是 chi 中间件模型的直观体现——在根路由上r.Use(...)注册的中间件会贯穿整棵路由树。r.Use(middleware.RequestID) r.Use(middleware.Logger) r.Use(middleware.Recoverer) r.Use(middleware.URLFormat) r.Use(render.SetContentType(render.ContentTypeJSON))见 main.go。routes.md 中每条路由都重复列出这五项逐一看它们的职责1.RequestID— 为每个请求注入唯一标识对应 middleware/request_id.go。它在进程启动时基于主机名与随机 base62 串生成前缀随后为每个请求注入形如host.example.com/random-0001的请求 ID。实现上若请求头已携带X-Request-Id则沿用否则由原子计数器累加生成request_id.go。该 ID 被存入请求上下文供 Logger、Recoverer 等下游中间件关联日志。2.Logger— 记录请求开始、结束与耗时对应 middleware/logger.go。它打印每个请求的起止时间、路径、状态码与耗时在 TTY 终端下还会输出彩色日志。源码注释特别强调Logger 应放在 Recoverer 等可能改写响应的中间件之前logger.go示例中的注册顺序恰好遵循了这一点。3.Recoverer— panic 恢复与 500 兜底对应 middleware/recoverer.go。任何处理器中未被捕获的 panic 都会被它接住打印格式化堆栈通过PrintPrettyStack输出到 stderr并尽可能向客户端返回 HTTP 500recoverer.go。这正是本文后面GET /panic测试路由能安全崩溃的底层保障。4.URLFormat— 解析 URL 扩展名对应 middleware/url_format.go。它从请求路径中解析出扩展名如/articles/1.json中的json存入middleware.URLFormatCtxKey对应的上下文键并把扩展名从路由路径中裁剪掉再继续匹配url_format.go。这意味着/articles/1、/articles/1.json、/articles/1.xml可以命中同一条GET /articles/{articleID}路由由处理器根据格式决定 JSON/XML 响应。5.render.SetContentType— 统一响应类型来自外部依赖github.com/go-chi/renderv1.0.1见 go.modSetContentType(render.ContentTypeJSON)为所有响应预置application/json。它是软性中间件处理器仍可显式覆盖。routes.md 中它以匿名函数形式SetContentType.func1出现对应 render 包的 content_type.go#L49JSON 版路由文档中anonymous: true标记了这一点routes.json。阅读提示routes.md 中这些中间件名都带源码锚点例如[RequestID](https://link.gitcode.com/i/d42c7c6017181d4581c039a74137ab25)在仓库内可直接跳转到对应定义行——这是 docgen 文档最具实用价值的地方。三、十条路由全景routes.md 末尾标注Total # of routes: 10。先总览全貌路由模式方法处理器含行内中间件源码位置/GET根路由匿名函数main.go/admin/*GETAdminOnly admin 索引main.go/admin/*/accountsGETAdminOnly 账户列表main.go/admin/*/users/{userId}GETAdminOnly 查看用户main.go/articles/*GET / POSTpaginateListArticles/CreateArticlemain.go main.go/articles/*/searchGETSearchArticlesmain.go/articles/*/{articleID}/*GET / PUT / DELETEArticleCtx 对应 CRUDmain.go/articles/*/{articleSlug:[a-z-]}GETArticleCtxGetArticlemain.go/panicGET触发 panic 的测试函数main.go/pingGET返回pong的函数main.go说明docgen 输出的模式如/articles/*、/admin/*带*后缀是 chi 树形路由在文档中的呈现形式——*表示该节点下有子路由分支并非要求请求路径本身带通配符。请求如/articles、/articles/123均能匹配。这批路由可分为三组理解基础探测路由、RESTy 资源路由articles、独立挂载的子路由admin。四、深入 articles 资源嵌套子路由、URL 参数与正则路由/articles是这份文档的核心它演示了 chi 最标志性的能力用嵌套的Route声明式地组织一个 REST 资源main.gor.Route(/articles, func(r chi.Router) { r.With(paginate).Get(/, ListArticles) r.Post(/, CreateArticle) // POST /articles r.Get(/search, SearchArticles) // GET /articles/search r.Route(/{articleID}, func(r chi.Router) { r.Use(ArticleCtx) // Load the *Article on the request context r.Get(/, GetArticle) // GET /articles/123 r.Put(/, UpdateArticle) // PUT /articles/123 r.Delete(/, DeleteArticle) // DELETE /articles/123 }) // GET /articles/whats-up r.With(ArticleCtx).Get(/{articleSlug:[a-z-]}, GetArticle) })4.1 列表与创建/articles/*GET /articles由 ListArticles 处理返回文章列表docgen 显示它带main.paginate行内中间件main.go。paginate在示例中只是空壳桩注释称完全可以实现查询参数处理逻辑但它示范了 chi 的With行内中间件用法只在单条路由上生效而不影响同级其他路由。POST /articles由 CreateArticle 处理通过render.Bind反序列化请求体写入内存模拟数据库后返回201 Created。4.2 单资源 CRUD/articles/{articleID}嵌套的r.Route(/{articleID}, ...)创建了一个子路由空间其中r.Use(ArticleCtx)让 GET/PUT/DELETE 三个方法共享同一个上下文加载中间件。ArticleCtxmain.go从chi.URLParam(r, articleID)取出 ID查询文章并把*Article存入请求上下文查不到时直接渲染404终止链条。于是下游处理器GetArticle、UpdateArticle、DeleteArticle只需从r.Context().Value(article)取数据即可彻底消除了每个方法各自解析 URL 参数 查询的重复代码。这正是 routes.md 中这三条方法都归在ArticleCtx之下的原因。4.3 正则参数路由/articles/{articleSlug:[a-z-]}GET /articles/whats-up由带正则约束的占位符{articleSlug:[a-z-]}匹配只接受小写字母与连字符组成的 slug。docgen 把正则原样展示在路由模式中一眼即可看出约束。它同样经过ArticleCtx此时 ArticleCtx 改走dbGetArticleBySlug分支最终复用同一个GetArticle渲染器。4.4 资源型 API 的完整方法矩阵将上述组合起来articles 资源覆盖了常见的 REST 方法面列表GET可扩展分页、创建POST、读取GET by ID / by slug、更新PUT、删除DELETE且每个环节都通过中间件做了解耦——这种方法共享上下文中间件的组织方式是 chi 官方推荐的 REST 服务骨架。五、admin 子路由Mount 挂载与 AdminOnly 鉴权中间件/admin/*三个分支展示的是 chi 的另一种组合方式独立构造的子路由器通过Mount挂载。r.Mount(/admin, adminRouter())main.go而adminRouter()main.go是一个全新的chi.NewRouter()func adminRouter() chi.Router { r : chi.NewRouter() r.Use(AdminOnly) r.Get(/, func(w http.ResponseWriter, r *http.Request) { w.Write([]byte(admin: index)) }) r.Get(/accounts, ...) r.Get(/users/{userId}, func(w http.ResponseWriter, r *http.Request) { w.Write([]byte(fmt.Sprintf(admin: view user id %v, chi.URLParam(r, userId)))) }) return r }代码注释明确指出Mount与r.Route(/admin, ...)效果相同main.go区别在于子路由器拥有独立、全新的中间件栈。AdminOnlymain.go是一个典型的鉴权中间件从上下文读取acl.admin布尔标记未授权时直接http.Error返回 403 Forbidden否则放行。routes.md 中/admin/*的三个分支全部列在AdminOnly之下正是这一子路由级中间件的文档化呈现——说明AdminOnly对 admin 路由器内的所有路由生效但不影响/articles等兄弟路由。这与全局五件套形成了清晰的两层中间件结构全局层RequestID→Logger→Recoverer→URLFormat→SetContentType 子路由层AdminOnly / ArticleCtx / paginate。六、基础探测路由/、/ping与/panicGET /返回字符串root.是服务存活与连通性的最小验证点main.go。GET /ping返回pongmain.go常被健康检查或探活脚本使用。GET /panic直接执行panic(test)main.go用于验证 Recoverer 中间件确实在工作客户端会收到 500服务端 stderr 打印格式化堆栈而进程不会崩溃。这个路由的存在本身就说明了 chi 中间件链的容错设计是可观察、可测试的。三条路由在 routes.md 中均显示为匿名函数main.main.func1等对应 routes.json 中anonymous: true的标记——它们是 main 包内联声明的闭包处理器。七、路由模式语法读懂{userId}、{articleID}、{articleSlug:[a-z-]}、*routes.md 中出现的四类模式在 chi.go 的包级文档中有权威定义具名占位符{name}匹配到下一个/或 URL 结尾的任意字符序列例如{userId}、{articleID}。注意它不匹配/因此/articles/{articleID}不会误吞多段路径。带正则的占位符{name:regexp}使用 Go 的 RE2 语法且正则中/永远不参与匹配例如{articleSlug:[a-z-]}只匹配纯小写字母与连字符。匿名正则{:regexp}name可留空。通配符*匹配 URL 剩余部分唯一能匹配/的占位符例如/page/*可匹配/page/intro/latest这也是 docgen 输出中*后缀的来源之一。处理器侧通过chi.URLParam(r, userId)等函数读取捕获值见 main.go 的 admin 用户路由或直接调用r.Context().Value(...)取已注入的对象。八、亲自动手运行示例并复现文档_examples/rest是一个可直接运行的完整示例依赖声明在 go.mod服务默认监听 3333 端口参照 _examples/README.md 的通用运行说明# 在示例目录内启动服务 go run . # 另开终端验证各路由输出与 main.go 头注释中的预期一致 curl http://localhost:3333/ # root. curl http://localhost:3333/ping # pong curl http://localhost:3333/articles # [{id:1,title:Hi},{id:2,title:sup}] curl http://localhost:3333/articles/1 # {id:1,title:Hi} curl -X DELETE http://localhost:3333/articles/1 curl http://localhost:3333/articles/1 # Not Found curl -X POST -d {id:will-be-omitted,title:awesomeness} http://localhost:3333/articles curl http://localhost:3333/articles/97 # {id:97,title:awesomeness}上述 curl 序列完整复现了 main.go 头注释中的交互示例其中 POST 返回id: 97的原因是 dbNewArticle 用rand.Intn(100)10生成新 ID且 ArticleRequest.Bind 会清空客户端传入的受保护id字段——这正是请求/响应分离 payload设计ArticleRequest 与 ArticleResponse的直观体现。重新生成路由文档go run . -routes routes.md go run . -routes | jq . # 若想生成 JSON 版可将 main.go 中的输出切换为 docgen.JSONRoutesDoc(r)生成结果即为 routes.md / routes.json 的原始来源。任何路由或中间件的增删改都会同步反映在重新生成的文档中让路由拓扑始终与代码保持一致。结语一份看似简单的 routes.md浓缩了 chi 路由器的全部核心设计Use注册的全局中间件链、Route嵌套组织的资源型路由、With注入的行内中间件、Mount挂载的独立子路由器、URL 参数与正则约束、以及 docgen 自动化的文档产出。结合 main.go、routes.json 与 middleware 目录下的各中间件源码你既可以在几分钟内搭出同构的 REST 服务也能把任何一份 docgen 路由文档当作运行中的架构图来阅读——这正是 chi 轻量、惯用、可组合设计哲学的最佳注脚。赞分享后端Web框架【免费下载链接】chilightweight, idiomatic and composable router for building Go HTTP services项目地址https://gitcode.com/gh_mirrors/ch/chi点击查看免费下载相关推荐Livedown的未来路线图实时协作和云同步功能的展望Livedown的未来路线图实时协作和云同步功能的展望 Livedown作为一款深受开发者喜爱的实时Markdown预览工具正通过持续迭代为用户带来更优质的开发工具go-chi/chi v5 完全指南轻量、可组合的 Go HTTP 路由与中间件框架go chi/chi v5 完全指南轻量、可组合的 Go HTTP 路由与中间件框架 chi 是一个基于 Go 标准库 net/http 构建的轻量级、惯用且后端API网关5分钟搞定Windows系统免费安装苹果平方字体的完整指南5分钟搞定Windows系统免费安装苹果平方字体的完整指南 还在为Windows系统上中文字体显示效果不够清晰而烦恼吗想让您的文档、网页和设计作品拥有苹果M前端上一篇termbox-go输入模式详解Esc模式、Alt模式和鼠标事件处理下一篇如何调试termbox-go应用常见问题与解决方案终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考