模块zip文件
3 分钟阅读
Module zip files 模块zip文件
模块版本是以.zip文件的形式发布的。很少有必要直接与这些文件互动，因为go命令会自动从module proxies（模块代理）和版本控制库中创建、下载和提取这些文件。但是，了解这些文件对了解跨平台的兼容性约束或在实现模块代理时仍然很有用。
go mod download命令下载一个或多个模块的zip文件，然后将这些文件提取到模块缓存中。根据GOPROXY和其他环境变量，go命令可以从代理下载zip文件，或者克隆源码管理存储库并从中创建zip文件。-json标志可以用来查找下载的 zip文件及其在模块缓存中提取的内容的位置。
golang.org/x/mod/zip包可以用来以编程方式创建、提取或检查压缩文件的内容。
File path and size constraints 文件路径和大小约束
对模块zip文件的内容有一些限制。这些限制确保zip文件可以在各种平台上安全和一致地被提取。
模块 zip文件最多可以有500 MiB的大小。
go.mod文件被限制在16 MB以内。LICENSE文件也被限制在16 MB以内。这些限制的存在是为了减轻对用户、代理和模块生态系统的其他部分的拒绝服务攻击。在模块目录树中包含超过500 MiB的文件的存储库应该在提交时标记模块版本，只包括构建模块包所需的文件；视频、模型和其他大型资产通常不需要构建。模块zip文件中的每个文件必须以前缀
$module@$version/开始，其中$module是模块路径，$version是版本，例如golang.org/x/mod@v0.3.0/。模块路径必须是有效的，版本必须是有效的和经典的，并且版本必须与模块路径的主版本后缀匹配。具体定义和限制，请参见Module paths and versions（模块路径和版本）。文件模式、时间戳和其他元数据被忽略。
空目录（路径以斜线结尾的条目）可能包含在模块zip文件中，但不会被提取。
go命令在它创建的压缩文件中不包括空目录。符号链接和其他不规则的文件在创建zip文件时被忽略，因为它们在不同的操作系统和文件系统中是不可移植的，也没有可移植的方法在zip文件格式中表示它们。
在创建zip文件时，名为
vendor的目录内的文件被忽略，因为主模块外的vendor目录从不被使用。在创建zip文件时，包含
go.mod文件的目录中的文件(模块根目录除外)将被忽略，因为它们不是模块的一部分。go命令在提取文件时忽略了包含go.mod文件的子目录。在Unicode大小写折叠下，zip文件中的任何两个文件的路径都不可能相等（见strings.EqualFold）。这保证了在不区分大小写的文件系统中提取文件时不会出现冲突。
go.mod文件可能出现在顶层目录（$module@$version/go.mod）中，也可能不出现。如果出现，它的名字必须是go.mod（全小写）。名为go.mod的文件不允许出现在任何其他目录中。模块中的文件和目录名可以由Unicode字母、ASCII数字、ASCII空格字符（U+0020）和ASCII标点字符
!#$%&()+,-.=@[]^_{}~组成。注意，包的路径可能不包含所有这些字符。参见module.CheckFilePath和module.CheckImportPath的区别。在Windows上，第一个点之前的文件或目录名不能是保留文件名，无论大小写(
CON、com1、NuL等)。