Comment

本文由 yanglbme 原创，首发于公众号“Doocs开源社区”，欢迎转载。选中多行代码添加 Comment一些朋友可能或多或少都会在 GitHub 参与一些项目的Code Review（以下都简称CR） 工作。以前的 GitHub，CR 体验并不好，你无法同时选中多行代码进行 comment。 然而很多时候，我们是需要针对一个代码块进行 comment 的，只能选中一行代码进行 comment 并不满足我们的需求。可能会有一些第三方工具提供相关的功能，但是仅仅一个 CR 的小需求，还有借助其他工具完成，确实是有点麻烦。 好消息就是，现在，没错，就是现在，GitHub 终于为我们已经提供了多行代码 comment 的相关功能。 举个栗子。 比如说，如果你想在第 3-8 行的代码块添加 comment，那么你只需要按住行号 3 后面的蓝色+按钮，往下拖拽到第 8 行，就能选中这个代码块了，之后进行 comment 就可以了，简直完美。 不止于 CR其实，GitHub 近一年已经推出了不少强大的功能或服务，包括： GitHub Actions GitHub Actions 可以为项目自动构建工作流，比如代码检查、自动化打包、自动化测试、发布版本等等，目前该功能处于 beta 测试阶段。 GitHub Package Registry GitHub Package Registry，也即是包管理服务，可以方便地伴随源代码发布公共或私有包。 官方是这样说的： With GitHub Package Registry you can safely publish and consume packages within your organization or with the entire world.目前 GitHub 包管理功能仍处于 beta 测试阶段，想优先体验的朋友，可以进行申请。 ...

自从上篇总结了一下Go 编程： 交叉编译 vs 条件编译之后，觉得有必要对于类似条件编译标签等特殊注释做一次简单收集。 原文发布于个人站点: GitDiG.com, 原文链接: Go 编程： 那些奇怪的注释1. 常规注释每种开发语言都有自己的注释语法和格式，也大多类似。 Go 语言和市面上其它多种高级语言的注释语法也类似，主要有以下两种语法格式: 注释行 以符合 // 开头注释块 以符号 /* 注释内容 */ 包括通常情况下， 对外公开的包、函数、常量、变量均需要进行注释。代码是否注释完全，可以通过lint工具进行审查。不了解的话，可以参考像 Awesome-Go 一样提升企业 Go 项目代码质量一文。 但是，以上也就仅仅是正常情况。在很多特殊情况下，一些看似符合以上注释语法的地方，却不是注释，也是本文整理的重点。 2. “奇怪”的注释2.1 条件编译在一些特殊的 Go 代码实现文件中，可以看到 // +build 开头的注释，而且此类 Go 代码实现中的函数常常还会在其它类似的文件中出现不同的实现。此类注释，称之为条件编译标签。它有明显的特征，即单独一行或多行，均以// +build 开头，同时和其它代码或者注释之间通过空行隔开。 例如： // +build linux,386 darwin,!cgo条件编译组合结果是： (linux AND 386) OR (darwin AND (NOT cgo)) // +build linux darwin// +build 386条件编译组合结果是：(linux OR darwin) AND 386 具体详细的条件编译的内容参考: Go 编程： 交叉编译 vs 条件编译. ...