当您的代码使用外部包时,这些包(作为模块分发)成为依赖项。随着时间的推移,您可能需要升级或更换它们。Go 提供了依赖管理工具,可帮助您在合并外部依赖项时确保 Go 应用程序的安全。
10年积累的成都网站设计、成都做网站经验,可以快速应对客户对网站的新想法和需求。提供各种问题对应的解决方案。让选择我们的客户得到更好、更有力的网络服务。我虽然不认识你,你也不认识我。但先网站设计制作后付款的网站建设流程,更有黑山免费网站建设让你可以放心的选择与我们合作。
本主题介绍如何执行任务以管理您在代码中承担的依赖项。您可以使用 Go 工具执行其中的大部分操作。本主题还介绍了如何执行其他一些您可能会觉得有用的依赖相关任务。
您可以通过 Go 工具获取和使用有用的包。在 pkg.go.dev 上,您可以搜索您可能觉得有用的包,然后使用go命令将这些包导入您自己的代码中以调用它们的功能。
下面列出了最常见的依赖项管理步骤。
在 Go 中,您将依赖项作为包含您导入的包的模块来管理。此过程由以下机构支持:
您可以搜索pkg.go.dev以查找具有您可能觉得有用的功能的软件包。
找到要在代码中使用的包后,在页面顶部找到包路径,然后单击复制路径按钮将路径复制到剪贴板。在您自己的代码中,将路径粘贴到导入语句中,如下例所示:
在您的代码导入包后,启用依赖项跟踪并获取包的代码进行编译。
要跟踪和管理您添加的依赖项,您首先要将代码放入其自己的模块中。这会在源代码树的根目录创建一个 go.mod 文件。您添加的依赖项将列在该文件中。
要将您的代码添加到它自己的模块中,请使用 go mod init命令。例如,从命令行切换到代码的根目录,然后按照以下示例运行命令:
该go mod init命令的参数是您的模块的模块路径。如果可能,模块路径应该是源代码的存储库位置。
如果一开始您不知道模块的最终存储库位置,请使用安全的替代品。这可能是您拥有的域的名称或您控制的另一个名称(例如您的公司名称),以及来自模块名称或源目录的路径。
当您使用 Go 工具管理依赖项时,这些工具会更新 go.mod 文件,以便它维护您的依赖项的当前列表。
添加依赖项时,Go 工具还会创建一个 go.sum 文件,其中包含您所依赖的模块的校验和。Go 使用它来验证下载的模块文件的完整性,特别是对于在您的项目上工作的其他开发人员。
在代码中包含存储库中的 go.mod 和 go.sum 文件。
当您运行go mod init创建用于跟踪依赖项的模块时,您指定一个模块路径作为模块的名称。模块路径成为模块中包的导入路径前缀。一定要指定一个不会与其他模块的模块路径冲突的模块路径。
至少,一个模块路径只需要表明它的来源,例如公司或作者或所有者名称。但是路径也可能更能描述模块是什么或做什么。
模块路径通常采用以下形式:
1、Go 工具可以在其中找到模块源代码的存储库的位置。
例如,它可能是github.com/ /.
如果您认为您可能会发布模块供其他人使用,请使用此最佳实践。
2、一个你控制的名字。
如果您不使用存储库名称,请务必选择一个您确信不会被其他人使用的前缀。一个不错的选择是您公司的名称。避免使用常用术语,例如widgets、utilities或 app。
Go 保证以下字符串不会在包名称中使用。
1、test– 您可以将test用作模块路径前缀以便代码用于在另一个模块中本地测试功能进行测试。
使用test作为模块路径前缀是测试的一部分。例如,您的测试本身可能会运行go mod init test,然后以某种特定方式设置该模块,以便使用 Go 源代码分析工具进行测试。
2、example– 在某些 Go 文档中用作模块路径前缀,例如在创建模块以跟踪依赖关系的教程中。
请注意,Go 文档还用于example.com说明示例何时可能是已发布的模块。
(GitBook) 是一个使用 Git 和 Markdown 来构建书籍的现代化的文档平台工具,虽然已经很好了,但由于gitbook有时候由于网络等原因会导致访问书写草稿不是很方便,所以结合群友的实用情况,对其他的一些工具也做一推荐,这也是写这一篇的主要原因
目前来看是国内最靠谱的选择,支持电子出版
看云为免费用户提供
官网地址: 看云 | 专注技术文档在线创作、阅读、分享和托管
看云文档示例:序言 · ThinkPHP3.2.3完全开发手册 · 看云
在线文档编辑与协同工具,免费用户一共有10GB上传流量
官网地址:
帮助文档示例:
BookStack 是基于 Mindoc、使用Go语言的Beego框架开发的功能类似GitBook和看云的在线文档管理系统,实现了文档采集、导入、电子书生成以及版本管理的文档功能,并推出了配套的开源微信小程序 BookChat 和配套的开源手机APP BookChatApp 。
详细 安装部署文档
在线文档管理系统,相当完备,需要有一台服务器自建
演示官网:
开源地址: TruthHun/BookStack
非常轻量级的文档,可以托管在Github page
官网及演示:
开源地址:
这是一个开源文档,可以托管在Github page等平台,支持markdown
演示以及文档:
开源地址:
这是一个开源接口文档在线管理系统
官网地址:
说明文档及演示:
开源wiki系统,支持多人协作,以及丰富的后台管理设置,个人觉得比mediawiki好看多了
官网及演示:
开源wiki程序
官网及演示:
开源地址:
这里我介绍两种方法!
一 :用IIS或者Apache之类的web服务器软件实现http文件共享
这里我以IIS为例介绍下用常用的web服务器实现文件共享的方法,具体如下(以我机器为例):
1、打开IIS,打开“网站 -- 默认网站”,右键点击“属性”,点击“主目录”,勾选“目录浏览”选项,如下图所示:
2、进入文件夹C:\Inetpub\wwwroot,拷贝文件“1.7z“到这个目录:
3、打开浏览器,输入本机ip(比如我的:192.168.1.123),即可看到共享的文件并可以下载:
点击“1.7z”即可下载。
二 :用python或者go语言实现http文件共享
1、python实现http文件共享:
用过python的都知道python有一个很牛x的命令:
python -m SimpleHTTPServer
在C:\Python27下运行命令:
打开浏览器,可以看到如下效果:
这个命令的默认端口是8000,如果我再加一个端口参数,可以用其它端口进行访问,命令如下:
打开浏览器:
知道了这个原理,可以写个bat文件,在需要的时候copy到相应的目录双击即可,比如我的httpShare.bat文件如下:
python -m SimpleHTTPServer 80
默认用80端口,访问时候只需要输入我的ip地址即可。
2、go语言实现http文件共享:
上面的方法很方便,windows和linux通吃,不过前提是要安装python
这里我有个用go语言实现的,也是windows和linux通吃(windows下不知道怎么配置的可以参考我之前的文章:,类似C/C++,是代码可移植,使用前你只需编译一次。
下面是示例代码(httpShare.go):
package main
import (
"http"
"fmt"
)
func main(){
h := http.FileServer(http.Dir("."))
var port string
fmt.Printf("Please input port Number: ")
fmt.Scanf("%s",port)
http.ListenAndServe(":"+port, h)
}
运行效果: