# 我们以前是这么做的

if mobile.startswith('+86'):
send_with_luosimao(mobile, message)
else:
send_with_twilio(mobile, message)

「构造函数」的本质是「无中生有」，第三种是「有中生有」，不配称作「构造函数」。

func (s *testStruct) New() *testStruct

项目很容易找，写个博客，多设计些功能，就能整微服务了：
账号系统（注册、登录、权限）
文章系统（读写、转发、搜索）
评论系统（评论文章、用户、动态）
社交系统（关注、订阅、点赞、提醒）
标签系统（ CRUD 、标签继承）

@DoctorCat 我用 go 写 API，没用过 framework，都是用的 library，自己手写 model + generate 通用的 model 级别的 API 。
听你这么说 APIJSON 还会接管 ORM，应该是 framework 了。

有几年没用 go 了，看到这个话题，回顾一下在 go 项目中使用 swagger 历程。
注：我也一直讨厌写不必要的 API 文档，尤其是 API 输入、输出格式等本应该能自动生成的文档。

1. 最初是自己写的代码，根据 request, response 对象生成 swagger.json 文件（ python 也自己写过……）：
https://www.v2ex.com/t/390148?p=1#r_4746014
2. 后来某个项目使用过 https://github.com/MarkSonghurst/swag （印象中某些 feature 支持不够好，我还改过少量代码）
3. 另外看到其他 v 友选择过 https://github.com/Tencent/APIJSON，也许以后会尝试？
https://v2ex.com/t/556593?p=2#r_7208890

我一般是这样：「按我提的方案做，有问题我会负责到底，否则一概不管」。

1. 确定项目使用的编程语言；
2. 找能分析该语言依赖，并能输出文档 /图片的工具；
3. 运行该工具。

面试者时的代码里有 “~~” 是会被我扣分的。

你调用 `create_all` 函数，当然会 `create all`了。你不指定，`create_all` 怎么知道你想排除哪些表呢。

AWS 比他们还便宜？感觉不是很科学。
AWS 最便宜的 2C8G Linux 虚拟机: t3a.large 按需 251.85 元 /月 全付费预留平均 86.92 元 /月

https://cloud.actwill.com.cn/cost/calculator

用了 https://github.com/psf/black 后，再也不用管单引号、双引号、空格的问题了。

1. 按照 quick-start 生成配置，编译并查看基本文档
2. 研究如何递归地生成模块文档
3. 研究配置特定插件（如 Django Flask gRPC 等）
4. 规划文档架构（ Quick Start / Tutorial / References)，编写 rst 文件

@neoblackcap 我的回复只是说明 gin 框架没有按照 go 官方推荐的方式组织代码，按我的设想，应该用 NewRouter，DefaultRouter 等含义更清晰的函数名。详细解释如下：

按 go 的官方规范，有区分度的结构体应该是由最后一层 `package + struct name` 组成。举例如下： http.Router, rpc.Request, websocket.Message, router.New(), mux.Default() （其中一些是现编的）等，还有上面有人提到的 gin.Middleware, gin.Engine （虽然不知道 Engine 具体是什么，但可以猜测是某种实体）。

而 gin.New(), gin.Default() 等的返回值是什么？参照对 router.New(), message.New() （分别返回 Router / Message ）等的理解，应该是返回一个叫「 Gin 」的东西，而 Gin 是什么呢？我的理解是一个框架，框架名作为实体？这样的代码读起来就很困惑了。

问题出在哪呢？ New / Default 不带有任何实体标识符，而实体由 `package + structname` 确定，既然不能用 struct name 来表示类型， 那就应该用 package 的最后一层来表示了。但 gin 这里没有，导致了一部分人对 gin.New(), gin.Default() 这样的代码不明所以。

如果 go 官方代码有最后一层 `package + struct name` 仍然定义不清晰的，欢迎打脸。

https://blog.golang.org/package-names 「 Go code is organized into packages. Within a package, code can refer to any identifier (name) defined within, while clients of the package may only reference the package's exported types, functions, constants, and variables. Such references always include the package name as a prefix: foo.Bar refers to the exported name Bar in the imported package named foo.」

恐怕问题不在变量 r，而是在 API gin.Default 上，听过没用过 gin 的根本不知道 Default 返回值是什么。
r := gin.DefaultRouter() 这样是不是就比较容易懂了？（没看过 gin 源码，姑且认为返回的是叫 Router 的东西）

给几个我觉得不错的 API 命名供参考：

net/http.DefaultServeMux
github.com/go-chi/chi.NewRouter()
github.com/gorilla/mux.NewRouter()

@dacapoday 编程语言是对自然语言拙劣的模仿吗？我认为是对自然语言的改进，至少解决了自然语言歧义太多的问题。