{"@attributes":{"version":"2.0"},"channel":{"title":"Google Go \u7f16\u7a0b\u89c4\u8303 on Google Style Guides","link":"https:\/\/gocn.github.io\/styleguide\/","description":"Recent content in Google Go \u7f16\u7a0b\u89c4\u8303 on Google Style Guides","generator":"Hugo -- gohugo.io","language":"zh","item":[{"title":{},"link":"https:\/\/gocn.github.io\/styleguide\/docs\/01-overview\/","pubDate":"Mon, 01 Jan 0001 00:00:00 +0000","guid":"https:\/\/gocn.github.io\/styleguide\/docs\/01-overview\/","description":"\u6982\u89c8 # \u539f\u6587\uff1ahttps:\/\/google.github.io\/styleguide\/go\n\u6982\u8ff0 | \u98ce\u683c\u6307\u5357 | \u98ce\u683c\u51b3\u7b56 | \u6700\u4f73\u5b9e\u8df5\n\u5173\u4e8e # \u672c\u7cfb\u5217\u7684 Go \u98ce\u683c\u6307\u5357\u548c\u76f8\u5173\u6587\u6863\u6574\u7406\u4e86\u5f53\u524d\uff0c\u6700\u4f73\u7684\u4e00\u4e2a\u7f16\u5199\u6613\u8bfb\u548c\u60ef\u7528\u65b9\u5f0f\u7684 Go \u5199\u6cd5\u3002 \u9075\u5b88\u98ce\u683c\u6307\u5357\u5e76\u4e0d\u662f\u7edd\u5bf9\u7684\uff0c\u8fd9\u4efd\u6587\u4ef6\u4e5f\u6c38\u8fdc\u4e0d\u4f1a\u8be6\u5c3d\u65e0\u9057\u3002\u6211\u4eec\u7684\u76ee\u7684\u662f\u5c3d\u91cf\u51cf\u5c11\u7f16\u5199\u53ef\u8bfb Go \u4ee3\u7801\u7684\u731c\u6d4b\uff0c\u4ee5\u4fbf\u8be5\u8bed\u8a00\u7684\u65b0\u624b\u53ef\u4ee5\u907f\u514d\u5e38\u89c1\u7684\u9519\u8bef\u3002\u6b64\u98ce\u683c\u6307\u5357\u4e5f\u7528\u4e8e\u7edf\u4e00 Google \u5185 Go \u4ee3\u7801 review \u8005\u7684\u98ce\u683c\u6307\u5357\u3002\n\u6587\u6863 \u94fe\u63a5 \u4e3b\u8981\u53d7\u4f17 \u89c6\u4e3a\u6807\u51c6(Normative) \u89c6\u4e3a\u89c4\u8303(Canonical) \u98ce\u683c\u6307\u5357 https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/ \u6240\u6709\u4eba Yes Yes \u98ce\u683c\u51b3\u7b56 https:\/\/gocn.github.io\/styleguide\/docs\/03-decisions\/ \u53ef\u8bfb\u6027\u5bfc\u5e08 Yes No \u6700\u4f73\u5b9e\u8df5 https:\/\/gocn.github.io\/styleguide\/docs\/04-best-practices\/ \u4efb\u4f55\u6709\u5174\u8da3\u7684\u4eba No No \u6587\u6863\u8bf4\u660e # \u98ce\u683c\u6307\u5357(Style Guide) (https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/) \u6982\u8ff0\u4e86 Google Go \u98ce\u683c\u7684\u57fa\u7840\u3002\u672c\u6587\u6863\u4e3a\u5b9a\u4e49\u540d\u8bcd\u6027\u8d28\u7684\u6587\u4ef6\uff0c\u7528\u4f5c\u98ce\u683c\u51b3\u7b56\u548c\u6700\u4f73\u5b9e\u8df5\u4e2d\u5efa\u8bae\u7684\u57fa\u7840\u3002\n\u98ce\u683c\u51b3\u7b56(Style Decisions) (https:\/\/gocn.github.io\/styleguide\/docs\/03-decisions\/) \u662f\u4e00\u4efd\u66f4\u8be6\u7ec6\u7684\u6587\u6863\uff0c\u5b83\u603b\u7ed3\u4e86\u7279\u5b9a\u573a\u666f\u4e0b\u98ce\u683c\u7684\u51b3\u7b56\u7406\u7531\uff0c\u5e76\u5728\u9002\u5f53\u7684\u65f6\u5019\u8ba8\u8bba\u4e86\u51b3\u7b56\u80cc\u540e\u7684\u539f\u56e0\u3002\n\u8fd9\u4e9b\u51b3\u5b9a\u53ef\u80fd\u5076\u5c14\u4f1a\u6839\u636e\u65b0\u6570\u636e\u3001\u65b0\u8bed\u8a00\u7279\u6027\u3001\u65b0\u4ee3\u7801\u5e93\u6216\u65b0\u51fa\u73b0\u7684\u6a21\u5f0f\u800c\u6539\u53d8\uff0c\u4f46\u4e0d\u671f\u671b Google \u7684 Go \u7a0b\u5e8f\u5458\u80fd\u53ca\u65f6\u4e86\u89e3\u672c\u6587\u6863\u7684\u66f4\u65b0\u3002\n\u6700\u4f73\u5b9e\u8df5(Best Practices) (https:\/\/gocn.github.io\/styleguide\/docs\/04-best-practices\/) \u63cf\u8ff0\u4e86\u4e00\u4e9b\u968f\u65f6\u95f4\u6f14\u53d8\u7684\u6a21\u5f0f\uff0c\u8fd9\u4e9b\u6a21\u5f0f\u53ef\u4ee5\u89e3\u51b3\u901a\u7528\u95ee\u9898\uff0c\u53ef\u8bfb\u6027\u5f3a\uff0c\u5e76\u4e14\u5bf9\u4ee3\u7801\u53ef\u7ef4\u62a4\u7684\u9700\u8981\u6709\u5f88\u597d\u7684\u5065\u58ee\u6027\u3002\n\u8fd9\u4e9b\u6700\u4f73\u5b9e\u8df5\u5e76\u4e0d\u89c4\u8303\uff0c\u4f46\u9f13\u52b1 Google \u7684 Go \u7a0b\u5e8f\u5458\u5c3d\u53ef\u80fd\u4f7f\u7528\u5b83\u4eec\uff0c\u4ee5\u4fdd\u6301\u4ee3\u7801\u5e93\u7684\u7edf\u4e00\u548c\u4e00\u81f4\u3002"},{"title":{},"link":"https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/","pubDate":"Mon, 01 Jan 0001 00:00:00 +0000","guid":"https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/","description":"Go \u98ce\u683c\u6307\u5357 # \u539f\u6587\uff1ahttps:\/\/google.github.io\/styleguide\/go\n\u6982\u8ff0 | \u98ce\u683c\u6307\u5357 | \u98ce\u683c\u51b3\u7b56 | \u6700\u4f73\u5b9e\u8df5\n\u98ce\u683c\u539f\u5219 # \u4ee5\u4e0b\u51e0\u6761\u603b\u4f53\u539f\u5219\u603b\u7ed3\u4e86\u5982\u4f55\u7f16\u5199\u53ef\u8bfb\u7684 Go \u4ee3\u7801\u3002\u4ee5\u4e0b\u4e3a\u5177\u6709\u53ef\u8bfb\u6027\u7684\u4ee3\u7801\u7279\u5f81\uff0c\u6309\u91cd\u8981\u6027\u6392\u5e8f\uff1a\n\u6e05\u6670\uff1a\u4ee3\u7801\u7684\u76ee\u7684\u548c\u8bbe\u8ba1\u539f\u7406\u5bf9\u8bfb\u8005\u6765\u8bf4\u662f\u6e05\u695a\u7684\u3002 \u7b80\u7ea6\uff1a\u4ee3\u7801\u4ee5\u6700\u7b80\u5355\u7684\u65b9\u5f0f\u6765\u5b8c\u6210\u5b83\u7684\u76ee\u7684\u3002 \u7b80\u6d01\uff1a\u4ee3\u7801\u5177\u6709\u5f88\u9ad8\u7684\u4fe1\u566a\u6bd4\uff0c\u5373\u5199\u51fa\u6765\u7684\u4ee3\u7801\u662f\u6709\u610f\u4e49\u7684\uff0c\u975e\u53ef\u6709\u53ef\u65e0\u7684\u3002 \u53ef\u7ef4\u62a4\u6027\uff1a\u4ee3\u7801\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u88ab\u7ef4\u62a4\u3002 \u4e00\u81f4\uff1a\u4ee3\u7801\u4e0e\u66f4\u5e7f\u6cdb\u7684 Google \u4ee3\u7801\u5e93\u4e00\u81f4\u3002 \u6e05\u6670 # \u53ef\u8bfb\u6027\u7684\u6838\u5fc3\u76ee\u6807\u662f\u5199\u51fa\u5bf9\u8bfb\u8005\u6765\u8bf4\u5f88\u6e05\u6670\u7684\u4ee3\u7801\u3002\n\u6e05\u6670\u6027\u4e3b\u8981\u662f\u901a\u8fc7\u6709\u6548\u7684\u547d\u540d\u3001\u6709\u7528\u7684\u6ce8\u91ca\u548c\u6709\u6548\u7684\u4ee3\u7801\u7ec4\u7ec7\u6765\u5b9e\u73b0\u7684\u3002\n\u6e05\u6670\u6027\u8981\u4ece\u8bfb\u8005\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u800c\u4e0d\u662f\u4ece\u4ee3\u7801\u7684\u4f5c\u8005\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u4ee3\u7801\u7684\u6613\u8bfb\u6027\u6bd4\u6613\u5199\u6027\u66f4\u91cd\u8981\u3002\u4ee3\u7801\u7684\u6e05\u6670\u6027\u6709\u4e24\u4e2a\u4e0d\u540c\u7684\u65b9\u9762\uff1a\n\u8be5\u4ee3\u7801\u5b9e\u9645\u4e0a\u5728\u505a\u4ec0\u4e48\uff1f \u4e3a\u4ec0\u4e48\u4ee3\u7801\u4f1a\u8fd9\u4e48\u505a\uff1f \u8be5\u4ee3\u7801\u5b9e\u9645\u4e0a\u5728\u505a\u4ec0\u4e48 # Go \u88ab\u8bbe\u8ba1\u5f97\u5e94\u8be5\u662f\u53ef\u4ee5\u6bd4\u8f83\u76f4\u63a5\u5730\u770b\u5230\u4ee3\u7801\u5728\u505a\u4ec0\u4e48\u3002\u5728\u4e0d\u786e\u5b9a\u7684\u60c5\u51b5\u4e0b\u6216\u8005\u8bfb\u8005\u53ef\u80fd\u9700\u8981\u5148\u9a8c\u77e5\u8bc6\u624d\u80fd\u7406\u89e3\u4ee3\u7801\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u503c\u5f97\u6295\u5165\u65f6\u95f4\u4ee5\u4f7f\u4ee3\u7801\u7684\u610f\u56fe\u5bf9\u672a\u6765\u7684\u8bfb\u8005\u66f4\u52a0\u660e\u786e\u3002\u4f8b\u5982\uff0c\u5b83\u53ef\u80fd\u6709\u52a9\u4e8e\uff1a\n\u4f7f\u7528\u66f4\u5177\u63cf\u8ff0\u6027\u7684\u53d8\u91cf\u540d\u79f0 \u6dfb\u52a0\u989d\u5916\u7684\u8bc4\u8bba \u4f7f\u7528\u7a7a\u767d\u4e0e\u6ce8\u91ca\u6765\u5212\u5206\u4ee3\u7801 \u5c06\u4ee3\u7801\u91cd\u6784\u4e3a\u72ec\u7acb\u7684\u51fd\u6570\/\u65b9\u6cd5\uff0c\u4f7f\u5176\u66f4\u52a0\u6a21\u5757\u5316 \u8fd9\u91cc\u6ca1\u6709\u4e00\u4e2a\u653e\u4e4b\u56db\u6d77\u800c\u7686\u51c6\u7684\u65b9\u6cd5\uff0c\u4f46\u5728\u5f00\u53d1 Go \u4ee3\u7801\u65f6\uff0c\u4f18\u5148\u8003\u8651\u6e05\u6670\u6027\u662f\u5f88\u91cd\u8981\u7684\u3002\n\u4e3a\u4ec0\u4e48\u4ee3\u7801\u4f1a\u8fd9\u4e48\u505a # \u4ee3\u7801\u7684\u903b\u8f91\u901a\u5e38\u7531\u53d8\u91cf\u3001\u51fd\u6570\u3001\u65b9\u6cd5\u6216\u5305\u7684\u540d\u79f0\u5145\u5206\u4f20\u8fbe\u3002\u5982\u679c\u4e0d\u662f\u8fd9\u6837\uff0c\u6dfb\u52a0\u6ce8\u91ca\u662f\u5f88\u91cd\u8981\u7684\u3002\u5f53\u4ee3\u7801\u4e2d\u5305\u542b\u8bfb\u8005\u53ef\u80fd\u4e0d\u719f\u6089\u7684\u7ec6\u8282\u65f6\uff0c\u201c\u4e3a\u4ec0\u4e48\uff1f\u201d\u5c31\u663e\u5f97\u5c24\u4e3a\u91cd\u8981\uff0c\u4f8b\u5982\uff1a\n\u7f16\u7a0b\u8bed\u8a00\u4e2d\u7684\u7ec6\u5fae\u5dee\u522b\uff0c\u4f8b\u5982\uff0c\u4e00\u4e2a\u95ed\u5305\u5c06\u6355\u83b7\u4e00\u4e2a\u5faa\u73af\u53d8\u91cf\uff0c\u4f46\u95ed\u5305\u5728\u8bb8\u591a\u884c\u4e4b\u5916 \u4e1a\u52a1\u903b\u8f91\u7684\u7ec6\u5fae\u5dee\u522b\uff0c\u4f8b\u5982\uff0c\u9700\u8981\u533a\u5206\u5b9e\u9645\u7528\u6237\u548c\u865a\u5047\u7528\u6237\u7684\u8bbf\u95ee\u63a7\u5236\u68c0\u67e5 \u4e00\u4e2a API \u53ef\u80fd\u9700\u8981\u5c0f\u5fc3\u7ffc\u7ffc\u624d\u80fd\u6b63\u786e\u4f7f\u7528\u3002\u4f8b\u5982\uff0c\u7531\u4e8e\u6027\u80fd\u539f\u56e0\uff0c\u4e00\u6bb5\u4ee3\u7801\u53ef\u80fd\u9519\u7efc\u590d\u6742\uff0c\u96be\u4ee5\u7406\u89e3\uff0c\u6216\u8005\u4e00\u8fde\u4e32\u590d\u6742\u7684\u6570\u5b66\u8fd0\u7b97\u53ef\u80fd\u4ee5\u4e00\u79cd\u610f\u60f3\u4e0d\u5230\u7684\u65b9\u5f0f\u4f7f\u7528\u7c7b\u578b\u8f6c\u6362\u3002\u5728\u8fd9\u4e9b\u4ee5\u53ca\u66f4\u591a\u7684\u60c5\u51b5\u4e0b\uff0c\u9644\u5e26\u7684\u6ce8\u91ca\u548c\u6587\u6863\u5bf9\u8fd9\u4e9b\u65b9\u9762\u8fdb\u884c\u89e3\u91ca\u662f\u5f88\u91cd\u8981\u7684\uff0c\u8fd9\u6837\u672a\u6765\u7684\u7ef4\u62a4\u8005\u5c31\u4e0d\u4f1a\u72af\u9519\uff0c\u8bfb\u8005\u4e5f\u53ef\u4ee5\u7406\u89e3\u4ee3\u7801\u800c\u4e0d\u9700\u8981\u8fdb\u884c\u9006\u5411\u5de5\u7a0b\u3002\n\u540c\u6837\u91cd\u8981\u7684\u662f\uff0c\u6211\u4eec\u8981\u610f\u8bc6\u5230\uff0c\u4e00\u4e9b\u57fa\u4e8e\u6e05\u6670\u6027\u8003\u8651\u7684\u5c1d\u8bd5\uff08\u5982\u6dfb\u52a0\u989d\u5916\u7684\u6ce8\u91ca\uff09\uff0c\u5b9e\u9645\u4e0a\u4f1a\u901a\u8fc7\u589e\u52a0\u6742\u4e71\u65e0\u7ae0\u7684\u5185\u5bb9\u3001\u91cd\u8ff0\u4ee3\u7801\u5df2\u7ecf\u8bf4\u8fc7\u7684\u5185\u5bb9\u3001\u4e0e\u4ee3\u7801\u76f8\u77db\u76fe\u6216\u589e\u52a0\u7ef4\u62a4\u8d1f\u62c5\u6765\u4fdd\u6301\u6ce8\u91ca\u7684\u6700\u65b0\u6027\uff0c\u4ee5\u6b64\u6765\u63a9\u76d6\u4ee3\u7801\u7684\u76ee\u7684\u3002\u8ba9\u4ee3\u7801\u81ea\u5df1\u8bf4\u8bdd\uff08\u4f8b\u5982\uff0c\u901a\u8fc7\u4ee3\u7801\u4e2d\u7684\u540d\u79f0\u672c\u8eab\u8fdb\u884c\u63cf\u8ff0\uff09\uff0c\u800c\u4e0d\u662f\u6dfb\u52a0\u591a\u4f59\u7684\u6ce8\u91ca\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6ce8\u91ca\u6700\u597d\u662f\u89e3\u91ca\u4e3a\u4ec0\u4e48\u8981\u505a\u67d0\u4e8b\uff0c\u800c\u4e0d\u662f\u89e3\u91ca\u4ee3\u7801\u5728\u505a\u4ec0\u4e48\u3002\nGoogle \u7684\u4ee3\u7801\u5e93\u57fa\u672c\u4e0a\u662f\u7edf\u4e00\u548c\u4e00\u81f4\u7684\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u90a3\u4e9b\u6bd4\u8f83\u7a81\u5140\u7684\u4ee3\u7801\uff08\u4f8b\u5982\uff0c\u5e94\u7528\u4e00\u4e2a\u4e0d\u719f\u6089\u7684\u6a21\u5f0f\uff09\u662f\u57fa\u4e8e\u5145\u5206\u7684\u7406\u7531\uff0c\u901a\u5e38\u662f\u4e3a\u4e86\u6027\u80fd\u3002\u4fdd\u6301\u8fd9\u79cd\u7279\u6027\u5f88\u91cd\u8981\uff0c\u53ef\u4ee5\u8ba9\u8bfb\u8005\u5728\u9605\u8bfb\u4e00\u6bb5\u65b0\u7684\u4ee3\u7801\u65f6\u6e05\u695a\u5730\u77e5\u9053\u4ed6\u4eec\u5e94\u8be5\u628a\u6ce8\u610f\u529b\u653e\u5728\u54ea\u91cc\u3002\n\u6807\u51c6\u5e93\u4e2d\u5305\u542b\u4e86\u8bb8\u591a\u8fd9\u4e00\u539f\u5219\u53d1\u6325\u4f5c\u7528\u7684\u4f8b\u5b50\u3002\u4f8b\u5982\uff1a\n\u5728 package sort \u4e2d\u7684\u7ef4\u62a4\u8005\u6ce8\u91ca \u597d\u7684\u5728\u540c\u4e00\u5305\u4e2d\u53ef\u8fd0\u884c\u7684\u4f8b\u5b50\uff0c\u8fd9\u5bf9\u7528\u6237\uff08\u4ed6\u4eec\u4f1a\u67e5\u770b godoc\uff09\u548c\u7ef4\u62a4\u8005\uff08\u4ed6\u4eec\u4f5c\u4e3a\u6d4b\u8bd5\u7684\u4e00\u90e8\u5206\u8fd0\u884c\uff09\u90fd\u6709\u5229 strings.Cut \u53ea\u6709\u56db\u884c\u4ee3\u7801\uff0c\u4f46\u5b83\u4eec\u63d0\u9ad8\u4e86 callsites \u7684\u6e05\u6670\u6027\u548c\u6b63\u786e\u6027 \u7b80\u7ea6 # \u4f60\u7684 Go \u4ee3\u7801\u5bf9\u4e8e\u4f7f\u7528\u3001\u9605\u8bfb\u548c\u7ef4\u62a4\u5b83\u7684\u4eba\u6765\u8bf4\u5e94\u8be5\u662f\u7b80\u5355\u7684\u3002\nGo \u4ee3\u7801\u5e94\u8be5\u4ee5\u6700\u7b80\u5355\u7684\u65b9\u5f0f\u7f16\u5199\uff0c\u4ee5\u5b9e\u73b0\u5176\u884c\u4e3a\u548c\u6027\u80fd\u65b9\u9762\u7684\u76ee\u6807\u3002\u5728 Google Go \u4ee3\u7801\u5e93\u4e2d\uff0c\u7b80\u5355\u7684\u4ee3\u7801\uff1a"},{"title":{},"link":"https:\/\/gocn.github.io\/styleguide\/docs\/03-decisions\/","pubDate":"Mon, 01 Jan 0001 00:00:00 +0000","guid":"https:\/\/gocn.github.io\/styleguide\/docs\/03-decisions\/","description":"Go \u98ce\u683c\u51b3\u7b56 # \u539f\u6587\uff1ahttps:\/\/google.github.io\/styleguide\/go\n\u6982\u8ff0 | \u98ce\u683c\u6307\u5357 | \u98ce\u683c\u51b3\u7b56 | \u6700\u4f73\u5b9e\u8df5\n\u6ce8\u610f\uff1a \u672c\u6587\u662f Google Go \u98ce\u683c \u7cfb\u5217\u6587\u6863\u7684\u4e00\u90e8\u5206\u3002\u672c\u6587\u6863\u662f \u89c4\u8303\u6027(normative) \u4f46\u4e0d\u662f\u5f3a\u5236\u89c4\u8303(canonical)\uff0c\u5e76\u4e14\u4ece\u5c5e\u4e8eGoogle \u98ce\u683c\u6307\u5357\u3002\u8bf7\u53c2\u9605\u6982\u8ff0\u83b7\u53d6\u66f4\u591a\u8be6\u7ec6\u4fe1\u606f\u3002\n\u5173\u4e8e # \u672c\u6587\u5305\u542b\u65e8\u5728\u7edf\u4e00\u548c\u4e3a Go \u53ef\u8bfb\u6027\u5bfc\u5e08\u7ed9\u51fa\u7684\u5efa\u8bae\u63d0\u4f9b\u6807\u51c6\u6307\u5bfc\u3001\u89e3\u91ca\u548c\u793a\u4f8b\u7684\u98ce\u683c\u51b3\u7b56\u3002\n\u672c\u6587\u6863\u5e76\u4e0d\u8be6\u5c3d\uff0c\u4e14\u4f1a\u968f\u7740\u65f6\u95f4\u7684\u63a8\u79fb\u800c\u589e\u52a0\u3002\u5982\u679c\u98ce\u683c\u6307\u5357 \u4e0e\u6b64\u5904\u7ed9\u51fa\u7684\u5efa\u8bae\u76f8\u77db\u76fe\uff0c\u98ce\u683c\u6307\u5357\u4f18\u5148\uff0c\u5e76\u4e14\u672c\u6587\u6863\u5e94\u76f8\u5e94\u66f4\u65b0\u3002\n\u53c2\u89c1 \u5173\u4e8e \u83b7\u53d6 Go \u98ce\u683c\u7684\u5168\u5957\u6587\u6863\u3002\n\u4ee5\u4e0b\u90e8\u5206\u5df2\u4ece\u6837\u5f0f\u51b3\u7b56\u79fb\u81f3\u6307\u5357\u7684\u4e00\u90e8\u5206\uff1a\n\u6df7\u5408\u5927\u5199\u5b57\u6bcdMixedCaps: \u53c2\u89c1 https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/#\u5927\u5c0f\u5199\u6df7\u5408 \u683c\u5f0f\u5316Formatting: \u53c2\u89c1 https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/#\u683c\u5f0f\u5316 \u884c\u957f\u5ea6Line Length: \u53c2\u89c1 https:\/\/gocn.github.io\/styleguide\/docs\/02-guide\/#\u884c\u957f\u5ea6 \u547d\u540dNaming # \u6709\u5173\u547d\u540d\u7684\u603b\u4f53\u6307\u5bfc\uff0c\u8bf7\u53c2\u9605\u6838\u5fc3\u98ce\u683c\u6307\u5357 \u4e2d\u7684\u547d\u540d\u90e8\u5206\uff0c\u4ee5\u4e0b\u90e8\u5206\u5bf9\u547d\u540d\u4e2d\u7684\u7279\u5b9a\u533a\u57df\u63d0\u4f9b\u8fdb\u4e00\u6b65\u7684\u8bf4\u660e\u3002\n\u4e0b\u5212\u7ebfUnderscores # Go \u4e2d\u7684\u547d\u540d\u901a\u5e38\u4e0d\u5e94\u5305\u542b\u4e0b\u5212\u7ebf\u3002\u8fd9\u4e2a\u539f\u5219\u6709\u4e09\u4e2a\u4f8b\u5916\uff1a\n\u4ec5\u7531\u751f\u6210\u4ee3\u7801\u5bfc\u5165\u7684\u5305\u540d\u79f0\u53ef\u80fd\u5305\u542b\u4e0b\u5212\u7ebf\u3002\u6709\u5173\u5982\u4f55\u9009\u62e9\u591a\u8bcd\u5305\u540d\u79f0\u7684\u66f4\u591a\u8be6\u7ec6\u4fe1\u606f\uff0c\u8bf7\u53c2\u9605\u5305\u540d\u79f0\u3002 *_test.go \u6587\u4ef6\u4e2d\u7684\u6d4b\u8bd5\u3001\u57fa\u51c6\u548c\u793a\u4f8b\u51fd\u6570\u540d\u79f0\u53ef\u80fd\u5305\u542b\u4e0b\u5212\u7ebf\u3002 \u4e0e\u64cd\u4f5c\u7cfb\u7edf\u6216 cgo \u4e92\u64cd\u4f5c\u7684\u4f4e\u7ea7\u5e93\u53ef\u80fd\u4f1a\u91cd\u7528\u6807\u8bc6\u7b26\uff0c\u5982 syscall \u4e2d\u6240\u505a\u7684\u90a3\u6837\u3002\u5728\u5927\u591a\u6570\u4ee3\u7801\u5e93\u4e2d\uff0c\u8fd9\u9884\u8ba1\u662f\u975e\u5e38\u7f55\u89c1\u7684\u3002 \u5305\u540d\u79f0Package names # Go \u5305\u540d\u79f0\u5e94\u8be5\u7b80\u77ed\u5e76\u4e14\u53ea\u5305\u542b\u5c0f\u5199\u5b57\u6bcd\u3002\u7531\u591a\u4e2a\u5355\u8bcd\u7ec4\u6210\u7684\u5305\u540d\u79f0\u5e94\u5168\u90e8\u5c0f\u5199\u3002\u4f8b\u5982\uff0c\u5305 tabwriter \u4e0d\u5e94\u8be5\u547d\u540d\u4e3a tabWriter\u3001TabWriter \u6216 tab_writer\u3002"},{"title":{},"link":"https:\/\/gocn.github.io\/styleguide\/docs\/04-best-practices\/","pubDate":"Mon, 01 Jan 0001 00:00:00 +0000","guid":"https:\/\/gocn.github.io\/styleguide\/docs\/04-best-practices\/","description":"Go \u7f16\u7a0b\u98ce\u683c\u6307\u5357 - \u6700\u4f73\u5b9e\u8df5 # \u539f\u6587\uff1ahttps:\/\/google.github.io\/styleguide\/go\n\u6982\u8ff0 | \u98ce\u683c\u6307\u5357 | \u98ce\u683c\u51b3\u7b56 | \u6700\u4f73\u5b9e\u8df5\n\u6ce8\u610f\uff1a \u672c\u6587\u662f Google Go \u98ce\u683c \u7cfb\u5217\u6587\u6863\u7684\u4e00\u90e8\u5206\u3002\u672c\u6587\u6863\u662f \u89c4\u8303\u6027(normative) \u4f46\u4e0d\u662f\u5f3a\u5236\u89c4\u8303(canonical)\uff0c\u5e76\u4e14\u4ece\u5c5e\u4e8eGoogle \u98ce\u683c\u6307\u5357\u3002\u8bf7\u53c2\u9605\u6982\u8ff0\u83b7\u53d6\u66f4\u591a\u8be6\u7ec6\u4fe1\u606f\u3002\n\u5173\u4e8e # \u672c\u6587\u4ef6\u8bb0\u5f55\u4e86\u5173\u4e8e\u5982\u4f55\u66f4\u597d\u5730\u5e94\u7528 Go \u98ce\u683c\u6307\u5357\u7684\u6307\u5bfc\u610f\u89c1\u3002\u8be5\u6307\u5bfc\u65e8\u5728\u89e3\u51b3\u7ecf\u5e38\u51fa\u73b0\u7684\u901a\u7528\u95ee\u9898\uff0c\u4f46\u4e0d\u4e00\u5b9a\u9002\u7528\u4e8e\u6240\u6709\u60c5\u51b5\u3002\u5728\u53ef\u80fd\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u8ba8\u8bba\u4e86\u591a\u79cd\u66ff\u4ee3\u65b9\u6cd5\uff0c\u4ee5\u53ca\u51b3\u5b9a\u4f55\u65f6\u8be5\u7528\u548c\u4f55\u65f6\u4e0d\u8be5\u7528\u8fd9\u4e9b\u65b9\u6cd5\u7684\u8003\u8651\u56e0\u7d20\u3002\n\u67e5\u770b\u6982\u8ff0\u6765\u83b7\u53d6\u5b8c\u6574\u7684\u98ce\u683c\u6307\u5bfc\u6587\u6863\n\u547d\u540d # \u51fd\u6570\u548c\u65b9\u6cd5\u540d\u79f0 # \u907f\u514d\u91cd\u590d # \u5728\u4e3a\u4e00\u4e2a\u51fd\u6570\u6216\u65b9\u6cd5\u9009\u62e9\u540d\u79f0\u65f6\uff0c\u8981\u8003\u8651\u8be5\u540d\u79f0\u5c06\u88ab\u9605\u8bfb\u7684\u73af\u5883\u3002\u8bf7\u8003\u8651\u4ee5\u4e0b\u5efa\u8bae\uff0c\u4ee5\u907f\u514d\u5728\u8c03\u7528\u5730\u70b9\u51fa\u73b0\u8fc7\u591a\u7684\u91cd\u590d:\n\u4ee5\u4e0b\u5185\u5bb9\u4e00\u822c\u53ef\u4ee5\u4ece\u51fd\u6570\u548c\u65b9\u6cd5\u540d\u79f0\u4e2d\u7701\u7565\u3002\n\u8f93\u5165\u548c\u8f93\u51fa\u7684\u7c7b\u578b\uff08\u5f53\u6ca1\u6709\u51b2\u7a81\u7684\u65f6\u5019\uff09 \u65b9\u6cd5\u7684\u63a5\u6536\u5668\u7684\u7c7b\u578b \u4e00\u4e2a\u8f93\u5165\u6216\u8f93\u51fa\u662f\u5426\u662f\u4e00\u4e2a\u6307\u9488 \u5bf9\u4e8e\u51fd\u6570\uff0c\u4e0d\u8981\u91cd\u590d\u8f6f\u4ef6\u5305\u7684\u540d\u79f0\u3002\n\/\/ Bad: package yamlconfig func ParseYAMLConfig(input string) (*Config, error) \/\/ Good: package yamlconfig func Parse(input string) (*Config, error) \u5bf9\u4e8e\u65b9\u6cd5\u4e0d\u8981\u91cd\u590d\u65b9\u6cd5\u63a5\u6536\u5668\u7684\u540d\u79f0\u3002\n\/\/ Bad: func (c *Config) WriteConfigTo(w io.Writer) (int64, error) \/\/ Good: func (c *Config) WriteTo(w io."}]}}