Go 学习 (二) Go 项目基本工程管理

小咪咪 2023-05-22 22:01 5阅读 0赞

1.应用场景

<table> 
 <tbody> 
 <tr> 
 <td>学习&nbsp;Go 项目基本工程管理, 继续学习了解go</td> 
 </tr> 
 </tbody> 
</table>

2.学习/操作

<table> 
 <tbody> 
 <tr> 
 <td> <h2>环境</h2> 
 <blockquote> 
 Windows 10 64位 
 vscode 
 go 1.14 
 
 或者 
 
 Mac Pro 
 go 1.17 
 </blockquote> <img alt="" src="https://img-blog.csdnimg.cn/img_convert/29ae7cfc31fab0187b041c1ada4670a3.png"> &nbsp; <img alt="" src="https://img-blog.csdnimg.cn/img_convert/13032df1a33d1ac550f5aa14e4710bba.png"> &nbsp; <h1>1. 文档</h1> 
 <blockquote> 
 <a href="https://xueyuanjun.com/post/19712" title="零基础入门（二）：Go 项目基本工程管理示例 | 快速入门 | Go 入门教程" rel="nofollow">零基础入门（二）：Go 项目基本工程管理示例 | 快速入门 | Go 入门教程</a> 
 <a href="https://github.com/golang/go/wiki/SettingGOPATH#windows-10-command-line" title="配置GOPATH" rel="nofollow">配置GOPATH</a> 
 <a href="https://blog.csdn.net/william_n/article/details/105586305" title="Go 学习 (一) 第一个go程序_william_n的博客-CSDN博客_go程序" rel="nofollow">Go 学习 (一) 第一个go程序_william_n的博客-CSDN博客_go程序</a> 
 </blockquote> <h1>2. 整理输出</h1> <h2>2.1 工程管理概述</h2> 
 <blockquote> 
 <a href="https://blog.csdn.net/william_n/article/details/105586305" title="Go 学习 (一) 第一个go程序_william_n的博客-CSDN博客_go程序" rel="nofollow">Go 学习 (一) 第一个go程序_william_n的博客-CSDN博客_go程序</a>&nbsp;中搭建起了本地开发环境，并且编写了第一个 Go 程序，向世界问好。 
 
 不过在实际开发过程中，直接调用编译器进行编译和链接（调用 <code>go build</code> 或 <code>go run</code> 命令）的场景很少，因为在项目工程中不会简单到只有一个源文件，往往有很多源文件并且源文件之间会有相互依赖的关系，如果这样一个文件一个文件逐步编译，那简直无法想象。 
 Go 语言的设计者作为行业老将，自然不会忽略这一点。说到这里，我们来看看 Go 语言的主要设计者都是何方神圣： 
 <img alt="" height="263" src="https://img-blog.csdnimg.cn/20200418121416266.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="583"> 
 个顶个的都是大神级人物。早期 Go 语言使用 <code>makefile</code> 作为临时方案，到了 Go 1 发布时引入了强大无比的 <a href="https://golang.org/cmd/go/" title="Go 命令行工具" rel="nofollow">Go 命令行工具</a>，Go 命令行工具彻底消除了工程文件的概念，完全用目录结构和包名来推导工程结构和构建顺序。 
 
 想想 C 语言编译、链接和安装可执行程序的繁琐步骤，首先要通过 <code>configure</code> 脚本对特定平台进行检测，比如是否包含 GCC 等编译工具，然后生成 Makefile 文件，该文件定义了编译、链接规则，为下一步编译工作做准备，接下来就是执行 <code>make</code> 命令进行编译工作，最后再执行 <code>make install</code> 命令完成应用程序的安装，经历过这些步骤才可以实现将 C 程序源代码编译为可执行程序。 
 
 与之相比，Go 语言则要简单的多，针对只有一个源文件的情况（如上篇教程所示），引入工程管理看起来比较多余，因为直接用 <code>go run</code> 和 <code>go build</code> 搞定，下面我们通过 Go 语言构建一个简单的计算器项目来演示 Go 语言的基本工程管理方法。 
 </blockquote> <h2>2.2 这里以 编写计算器工程源码 项目为例</h2> 
 <blockquote> 
 具体代码见下方链接&nbsp; ---- 编写计算器工程源码 很详细 
 <a href="https://xueyuanjun.com/post/19712" title="零基础入门（二）：Go 项目基本工程管理示例 | 快速入门 | Go 入门教程" rel="nofollow">零基础入门（二）：Go 项目基本工程管理示例 | 快速入门 | Go 入门教程</a> 
 
 本地截图 
 <img alt="" height="328" src="https://img-blog.csdnimg.cn/20200418133200755.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="488"> 
 
 备注: 
 同时新建.go文件时, vscode会提醒安装go插件 
 <img alt="" height="97" src="https://img-blog.csdnimg.cn/20200418122817297.png" width="490"> 
 点击 '安装'即可 
 <img alt="" height="193" src="https://img-blog.csdnimg.cn/20200418122844169.png" width="321"> 
 
 如果书写go 换行错误错误,保存,则会提示安装 goreturns插件 
 <img alt="" height="223" src="https://img-blog.csdnimg.cn/20200418122934301.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="688"> 
 <img alt="" height="122" src="https://img-blog.csdnimg.cn/20200418123009937.png" width="484"> 
 点击 'Install' 即可. 
 这里可以先不用'Install All', 后面在操作 
 
 
 补充: 
 这里我点击了 'Install All', 但是安装基本都是失败 
 <img alt="" height="450" src="https://img-blog.csdnimg.cn/20200418123227848.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="549"> 
 失败原因: 
 应该是网络无法访问导致 
 <img alt="" height="177" src="https://img-blog.csdnimg.cn/20200418123818451.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="796"> 
 
 
 解决办法: 
 方式一: 
 能够访问google. //这里使用了代理 
 <img alt="" height="182" src="https://img-blog.csdnimg.cn/20200418130835620.png" width="723"> 
 
 方式二: 
 TBD [是否能配置新的进行地址] 
 </blockquote> <h2>2.3 配置 GOPATH 环境变量</h2> 
 <blockquote> 
 Windows下: 
 通过配置环境变量 <code>GOPATH</code> 来实现，将你的项目根目录完整路径拷贝过去就好 了。 
 和 <code>PATH</code> 环境变量一样，<code>GOPATH</code> 也可以支持一次配置多个路径，并且路径和路径之间用冒号分隔。 
 <code>GOPATH</code> 的用处是 Go 语言在编译程序时，会从 <code>GOPATH</code> 配置的路径里面去查找源文件并完成构建。 
 <img alt="" height="224" src="https://img-blog.csdnimg.cn/20200418124723786.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="594"> 
 
 Linux下或者GoLand, 查看 
 <a href="https://xueyuanjun.com/post/19712" title="https://xueyuanjun.com/post/19712&nbsp;&nbsp; //&nbsp;" rel="nofollow">https://xueyuanjun.com/post/19712&nbsp;&nbsp; //&nbsp;</a>配置 GOPATH 环境变量 
 
 查看go 相关变量 
 go env 
 <img alt="" height="685" src="https://img-blog.csdnimg.cn/20200418131728204.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="505"> 
 </blockquote> <h2>2.4 构建 Go 工程</h2> 
 <blockquote> 
 设置完 <code>GOPATH</code> 后，现在我们开始构建工程。假设我们希望把生成的可执行文件放到 <code>calc/bin</code> 目录中，需要执行的一系列指令如下： 
 cd ~/go/calc mkdir bin cd bin go build calc 
 这样就会在 <code>calc/bin</code> 目录下生成可执行文件 <code>calc</code>： 
 <img alt="" height="393" src="https://img-blog.csdnimg.cn/20200418133304199.png" width="265"> 
 
 然后我们就可以执行 <code>calc</code> 程序了： 
 <img alt="" height="457" src="https://img-blog.csdnimg.cn/20200418133745158.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="393"> 
 运行成功！！ 
 
 这就是为什么说 Go 命令行工具是非常强大的。 
 我们不需要写 <code>makefile</code>，因为这个工具会替我们分析，知道目标代码的编译结果应该是一个包还是一个可执行文件，并分析 <code>import</code> 语句以了解包的依赖关系，从而在编译 <code>calc.go</code> 之前先把依赖的 <code>simplemath</code> 编译打包好。 
 
 Go 命令行程序制定的目录结构规则让代码管理变得非常简单。 
 当然，这里只是一个最简单、最基本工程管理的构建示例，后面我们还会就更复杂的工程项目管理进行介绍，比如工程组织、文档与代码风格、跨平台开发、单元测试、打包分发等. 
 </blockquote> 后续补充 ... </td> 
 </tr> 
 </tbody> 
</table>

3.问题/补充

<table> 
 <tbody> 
 <tr> 
 <td> <h3>1.go build calc 编译出现报错:</h3> 
 <blockquote> 
 can't load package: package calc: cannot find package "calc" in any of:&nbsp; ... 
 <img alt="" height="198" src="https://img-blog.csdnimg.cn/20200417183726739.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="661"> 
 解决办法: 
 <img alt="" height="108" src="https://img-blog.csdnimg.cn/20200417184512551.png" width="662"> 
 但是, 依然报错 
 <img alt="" height="267" src="https://img-blog.csdnimg.cn/20200417184544200.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="670"> 
 
 只好暂时先使用下面方式 
 在新开发cmd窗口中, 执行go builg calc 
 <img alt="" height="158" src="https://img-blog.csdnimg.cn/20200417184437755.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="535"> 
 执行程序: 
 <img alt="" height="190" src="https://img-blog.csdnimg.cn/2020041718500937.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dpbGxpYW1fbg==,size_16,color_FFFFFF,t_70" width="537"> 
 
 运行提示正常. 
 
 如果依然没有解决, 重启电脑试试. 
 还有一个原因: 
 保证拼写没有错误, 这里就犯了这个错误, 找了好久才发现. 
 </blockquote> <h3>2.常见的go标准库</h3> 
 <blockquote> 
 &nbsp;&nbsp;gocode 
 &nbsp;&nbsp;gopkgs 
 &nbsp;&nbsp;go-outline 
 &nbsp;&nbsp;go-symbols 
 &nbsp;&nbsp;guru 
 &nbsp;&nbsp;gorename 
 &nbsp;&nbsp;gotests 
 &nbsp;&nbsp;gomodifytags 
 &nbsp;&nbsp;impl 
 &nbsp;&nbsp;fillstruct 
 &nbsp;&nbsp;goplay 
 &nbsp;&nbsp;godoctor 
 &nbsp;&nbsp;dlv 
 &nbsp;&nbsp;gocode-gomod 
 &nbsp;&nbsp;godef 
 &nbsp;&nbsp;goreturns 
 &nbsp;&nbsp;golint 
 </blockquote> </td> 
 </tr> 
 </tbody> 
</table>

4.参考

<table> 
 <tbody> 
 <tr> 
 <td> <a href="https://xueyuanjun.com/post/19712" title="https://xueyuanjun.com/post/19712&nbsp;" rel="nofollow">https://xueyuanjun.com/post/19712&nbsp;</a>// 零基础入门（二） —— Go 项目基本工程管理示例 <a href="https://github.com/golang/go/wiki/SettingGOPATH#windows-10-command-line" title="https://github.com/golang/go/wiki/SettingGOPATH#windows-10-command-line&nbsp;&nbsp;" rel="nofollow">https://github.com/golang/go/wiki/SettingGOPATH#windows-10-command-line&nbsp;&nbsp;</a>// 配置GOPATH </td> 
 </tr> 
 </tbody> 
</table>

后续补充

...