go list命令介绍

偏执的太偏执、 2022-03-17 02:26 606阅读 0赞

功能：用于输出路径包的详细信息  
go list 默认情况下只输出后边的路径包信息，用的最多的标记是 -f , -json，后边会说明。

\-json 标记，后面若跟有路径包则已 json 格式打印出代码包的结构体形式，若不写路径包，比如：go list -json 则打印出当前所在目录包中的结构体样式。其中 json 结构体输出会参照一个模板输出说明，如下：

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>类型</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Dir</td> 
   <td>string</td> 
   <td>代码包所在的目录</td> 
  </tr> 
  <tr> 
   <td>ImportPath</td> 
   <td>string</td> 
   <td>代码包的导入路径</td> 
  </tr> 
  <tr> 
   <td>Name</td> 
   <td>string</td> 
   <td>代码包名</td> 
  </tr> 
  <tr> 
   <td>Doc</td> 
   <td>string</td> 
   <td>代码包文档字符串</td> 
  </tr> 
  <tr> 
   <td>Target</td> 
   <td>string</td> 
   <td>代码包编译后的 .a 文件安装路径</td> 
  </tr> 
  <tr> 
   <td>Shlib</td> 
   <td>string</td> 
   <td>该代码包共享库的名称</td> 
  </tr> 
  <tr> 
   <td>Goroot</td> 
   <td>bool</td> 
   <td>该代码包是否在go语言的安装目录</td> 
  </tr> 
  <tr> 
   <td>Standard</td> 
   <td>bool</td> 
   <td>该代码包是否是go标准库中的一部分</td> 
  </tr> 
  <tr> 
   <td>Stale</td> 
   <td>bool</td> 
   <td>该代码包的最新版本是否安装了</td> 
  </tr> 
  <tr> 
   <td>StaleReason</td> 
   <td>string</td> 
   <td>对Stale = true 时进行解释说明</td> 
  </tr> 
  <tr> 
   <td>Root</td> 
   <td>string</td> 
   <td>该代码包所在的go安装目录或go工作区目录</td> 
  </tr> 
  <tr> 
   <td>ConflictDir</td> 
   <td>string</td> 
   <td>在工作区中的隐藏目录</td> 
  </tr> 
  <tr> 
   <td>BinaryOnly</td> 
   <td>bool</td> 
   <td>该二进制包是否可以重新编译</td> 
  </tr> 
  <tr> 
   <td>ForTest</td> 
   <td>string</td> 
   <td>仅用户测试用的测试包名字</td> 
  </tr> 
  <tr> 
   <td>Export</td> 
   <td>string</td> 
   <td>包含导出数据的文件（使用 -export 标记情况下）</td> 
  </tr> 
  <tr> 
   <td>有关源文件输出字段说明</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>GoFiles</td> 
   <td>string[]</td> 
   <td>路径包的 go 源码文件，不包含“c”文件，和源码测试文件</td> 
  </tr> 
  <tr> 
   <td>CgoFiles</td> 
   <td>stringp[]</td> 
   <td>导入代码包“c”的 go 源码文件</td> 
  </tr> 
  <tr> 
   <td>CompiledGoFiles</td> 
   <td>string[]</td> 
   <td>路径包编译过的 go 源码文件（仅加上 -compiled 生效）</td> 
  </tr> 
  <tr> 
   <td>IgnoredGoFiles</td> 
   <td>string[]</td> 
   <td>忽略路径包下编译过的 源码文件列表</td> 
  </tr> 
  <tr> 
   <td>CFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.c”文件列表</td> 
  </tr> 
  <tr> 
   <td>CXXFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.cc,.cxx,.cpp”文件列表，比如c++文件</td> 
  </tr> 
  <tr> 
   <td>MFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.m”文件列表</td> 
  </tr> 
  <tr> 
   <td>HFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.h,.hh,.hpp,.hxx”文件列表</td> 
  </tr> 
  <tr> 
   <td>FFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.f,.F,.for,.f90”文件列表</td> 
  </tr> 
  <tr> 
   <td>SFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.s”文件列表</td> 
  </tr> 
  <tr> 
   <td>SwigFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.swig”文件列表</td> 
  </tr> 
  <tr> 
   <td>SwigCXXFiles</td> 
   <td>string[]</td> 
   <td>路径包下“.swigcxx”文件列表</td> 
  </tr> 
  <tr> 
   <td>SysoFiles</td> 
   <td>string[]</td> 
   <td>路径包下可用于存档的“.syso”文件列表</td> 
  </tr> 
  <tr> 
   <td>TestGoFiles</td> 
   <td>string[]</td> 
   <td>路径包下“_test.go”文件列表</td> 
  </tr> 
  <tr> 
   <td>XTestGoFiles</td> 
   <td>string[]</td> 
   <td>路径包外“_test.go”文件列表</td> 
  </tr> 
  <tr> 
   <td>代码结构体中与Cgo指令有关模板字段说明</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>CgoCFLAGS</td> 
   <td>string[]</td> 
   <td>需要传递给"C编译器"标记的 cgo 指令</td> 
  </tr> 
  <tr> 
   <td>CgoCPPFLAGS</td> 
   <td>string[]</td> 
   <td>需要传递给"C预处理器"标记的 cgo 指令</td> 
  </tr> 
  <tr> 
   <td>CgoCXXFLAGS</td> 
   <td>string[]</td> 
   <td>需要传递给"C++编译器"标记的 cgo 指令</td> 
  </tr> 
  <tr> 
   <td>CgoFFLAGS</td> 
   <td>string[]</td> 
   <td>需要传递给 <a href="https://baike.baidu.com/item/Fortran%E7%BC%96%E8%AF%91%E5%99%A8/22042710?fr=aladdin" rel="nofollow">Fortran编译器</a> 标记的 cgo 指令</td> 
  </tr> 
  <tr> 
   <td>CgoLDFLAGS</td> 
   <td>string[]</td> 
   <td>需要传递给"连接器"的标记的 cgo 指令</td> 
  </tr> 
  <tr> 
   <td>CgoPkgConfig</td> 
   <td>string[]</td> 
   <td>pkg-config 名称列表</td> 
  </tr> 
  <tr> 
   <td>代码包中结构体中依赖信息有关字段</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Imports</td> 
   <td>[]string</td> 
   <td>当前路径包下显示导入其他包的信息列表</td> 
  </tr> 
  <tr> 
   <td>Deps</td> 
   <td>[]string</td> 
   <td>路径包下所有包信息（包括间接依赖信息）</td> 
  </tr> 
  <tr> 
   <td>TestImports</td> 
   <td>[]string</td> 
   <td>路径包下测试文件中显示导入的代码包列表</td> 
  </tr> 
  <tr> 
   <td>XTestImports</td> 
   <td>[]string</td> 
   <td>路径包之外的测试文件中显示导入的代码包列表</td> 
  </tr> 
  <tr> 
   <td>结构体中错误信息的模板</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Incomplete</td> 
   <td>bool</td> 
   <td>路径包或及其依赖包是否有错误信息</td> 
  </tr> 
  <tr> 
   <td>Error</td> 
   <td>*PackageError</td> 
   <td>载入或分析代码包时出错</td> 
  </tr> 
  <tr> 
   <td>DepsErrors</td> 
   <td>[]*PackageError</td> 
   <td>载入或分析依赖包是出错</td> 
  </tr> 
 </tbody> 
</table>

其他标记含义：  
\-deps 标记不仅会把路径包打印出来，并把其依赖包信息也打印出来。  
包层级越深优先打印出来，所以当前路径包最后打印出来。命令行下将不会显示列出信息包，除非将 DepOnly 字段设置为true。  
**-e** 标记将会忽略路径包下错误信息输出。默认情况下命令行将会以标准形式输出路径吧的错误信息  
**-export** 标记将输出路径包下  
**-find** 将会打印出自身路径包（不包括去依赖包，Imports 和 Deps 模板字段将不会打印出来）  
**-test** 标记会打印出自身路径包已经包下对应的二进制可执行文件信息。二进制文件路径所在信息最后是已 “.test” 结尾的，比如：math/rand.test.  
这里只列出了 go list 命令标记的其中之一，更多详情[可以查看光放文档][Link 1]

[Link 1]: https://golang.google.cn/cmd/go/