{"id":26289,"date":"2024-09-18T16:41:03","date_gmt":"2024-09-18T08:41:03","guid":{"rendered":"https:\/\/17aitech.com\/?p=26289"},"modified":"2024-10-08T15:05:43","modified_gmt":"2024-10-08T07:05:43","slug":"%e3%80%90%e9%a1%b9%e7%9b%ae%e5%ae%9e%e6%88%98%e3%80%91%e5%9f%ba%e4%ba%8eagent%e7%9a%84%e9%87%91%e8%9e%8d%e9%97%ae%e7%ad%94%e7%b3%bb%e7%bb%9f%ef%bc%9a%e4%bb%a3%e7%a0%81%e9%87%8d%e6%9e%84","status":"publish","type":"post","link":"https:\/\/17aitech.com\/?p=26289","title":{"rendered":"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_85 ez-toc-wrap-left-text counter-hierarchy ez-toc-counter ez-toc-light-blue ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">\u6587\u7ae0\u76ee\u5f55<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E5%89%8D%E8%A8%80\" >\u524d\u8a00<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%AE%80%E4%BB%8B\" >\u4ee3\u7801\u91cd\u6784\u7b80\u4ecb<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%80%E4%B9%88%E6%98%AF%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84\" >\u4ec0\u4e48\u662f\u4ee3\u7801\u91cd\u6784<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E7%9B%AE%E7%9A%84\" >\u4ee3\u7801\u91cd\u6784\u7684\u76ee\u7684<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E9%87%8D%E8%A6%81%E6%80%A7\" >\u4ee3\u7801\u91cd\u6784\u7684\u91cd\u8981\u6027<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E9%9A%BE%E7%82%B9\" >\u4ee3\u7801\u91cd\u6784\u7684\u96be\u70b9<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E8%BF%87%E7%A8%8B\" >\u4ee3\u7801\u91cd\u6784\u7684\u8fc7\u7a0b<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/17aitech.com\/?p=26289\/#1%E3%80%81%E6%90%AD%E5%BB%BA%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%E4%BB%A5%E5%8F%8A%E7%94%A8%E4%BE%8B%E9%9B%86\" >1\u3001\u642d\u5efa\u6d4b\u8bd5\u6846\u67b6\u4ee5\u53ca\u7528\u4f8b\u96c6<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/17aitech.com\/?p=26289\/#2%E3%80%81%E6%B6%88%E7%81%AD%E4%BB%A3%E7%A0%81%E4%B8%AD%E7%9A%84%E5%9D%8F%E5%91%B3%E9%81%93\" >2\u3001\u6d88\u706d\u4ee3\u7801\u4e2d\u7684\u574f\u5473\u9053<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/17aitech.com\/?p=26289\/#21%E3%80%81%E7%BB%9F%E4%B8%80%E7%AE%A1%E7%90%86%E9%85%8D%E7%BD%AE%E7%9B%B8%E5%85%B3%E5%86%85%E5%AE%B9\" >2.1\u3001\u7edf\u4e00\u7ba1\u7406\u914d\u7f6e\u76f8\u5173\u5185\u5bb9<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/17aitech.com\/?p=26289\/#22%E3%80%81%E5%A4%84%E7%90%86%E5%8F%82%E6%95%B0%E8%BF%87%E9%95%BF%E7%9A%84%E9%97%AE%E9%A2%98\" >2.2\u3001\u5904\u7406\u53c2\u6570\u8fc7\u957f\u7684\u95ee\u9898<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/17aitech.com\/?p=26289\/#23%E3%80%81%E5%87%8F%E5%B0%91%E9%87%8D%E5%A4%8D%E4%BB%A3%E7%A0%81\" >2.3\u3001\u51cf\u5c11\u91cd\u590d\u4ee3\u7801<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/17aitech.com\/?p=26289\/#24%E3%80%81%E4%BD%BF%E7%94%A8%E9%9D%99%E6%80%81%E6%89%AB%E6%8F%8F%E5%B7%A5%E5%85%B7%E4%BC%98%E5%8C%96%E4%BB%A3%E7%A0%81%E9%A3%8E%E6%A0%BC\" >2.4\u3001\u4f7f\u7528\u9759\u6001\u626b\u63cf\u5de5\u5177\u4f18\u5316\u4ee3\u7801\u98ce\u683c<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/17aitech.com\/?p=26289\/#3%E3%80%81%E5%9B%9E%E5%BD%92%E6%B5%8B%E8%AF%95\" >3\u3001\u56de\u5f52\u6d4b\u8bd5<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-15\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E5%86%85%E5%AE%B9%E5%B0%8F%E7%BB%93\" >\u5185\u5bb9\u5c0f\u7ed3<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-16\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E9%99%84%E5%BD%95\" >\u9644\u5f55<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-17\" href=\"https:\/\/17aitech.com\/?p=26289\/#Python_%E7%BC%96%E7%A0%81%E9%A3%8E%E6%A0%BC%E4%B8%8E%E8%A7%84%E8%8C%83\" >Python \u7f16\u7801\u98ce\u683c\u4e0e\u89c4\u8303<\/a><ul class='ez-toc-list-level-4' ><li class='ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-18\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E8%AF%B4%E6%98%8E\" >\u8bf4\u660e<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-19\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%B8%80%E3%80%81%E7%BC%96%E7%A0%81%E9%A3%8E%E6%A0%BC\" >\u4e00\u3001\u7f16\u7801\u98ce\u683c<\/a><ul class='ez-toc-list-level-5' ><li class='ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-20\" href=\"https:\/\/17aitech.com\/?p=26289\/#11_%E7%BC%A9%E8%BF%9B\" >1.1 \u7f29\u8fdb<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-21\" href=\"https:\/\/17aitech.com\/?p=26289\/#12_%E6%AF%8F%E8%A1%8C%E6%9C%80%E5%A4%A7%E9%95%BF%E5%BA%A6\" >1.2 \u6bcf\u884c\u6700\u5927\u957f\u5ea6<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-22\" href=\"https:\/\/17aitech.com\/?p=26289\/#13_%E7%A9%BA%E7%99%BD%E7%AC%A6\" >1.3 \u7a7a\u767d\u7b26<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-23\" href=\"https:\/\/17aitech.com\/?p=26289\/#14_%E6%93%8D%E4%BD%9C%E7%AC%A6\" >1.4 \u64cd\u4f5c\u7b26<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-24\" href=\"https:\/\/17aitech.com\/?p=26289\/#15_%E6%8B%AC%E5%8F%B7\" >1.5 \u62ec\u53f7<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-25\" href=\"https:\/\/17aitech.com\/?p=26289\/#16_%E7%A9%BA%E8%A1%8C\" >1.6 \u7a7a\u884c<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-26\" href=\"https:\/\/17aitech.com\/?p=26289\/#17_%E6%BA%90%E6%96%87%E4%BB%B6%E7%BC%96%E7%A0%81\" >1.7 \u6e90\u6587\u4ef6\u7f16\u7801<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-27\" href=\"https:\/\/17aitech.com\/?p=26289\/#18_Shebang\" >1.8 Shebang<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-28\" href=\"https:\/\/17aitech.com\/?p=26289\/#19_%E6%A8%A1%E5%9D%97%E5%BC%95%E7%94%A8import\" >1.9 \u6a21\u5757\u5f15\u7528(import)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-29\" href=\"https:\/\/17aitech.com\/?p=26289\/#110_%E6%A8%A1%E5%9D%97%E4%B8%AD%E7%9A%84%E9%AD%94%E6%9C%AF%E5%8F%98%E9%87%8Fdunders\" >1.10 \u6a21\u5757\u4e2d\u7684\u9b54\u672f\u53d8\u91cf(dunders)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-30\" href=\"https:\/\/17aitech.com\/?p=26289\/#111_%E6%B3%A8%E9%87%8A\" >1.11 \u6ce8\u91ca<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-31\" href=\"https:\/\/17aitech.com\/?p=26289\/#112_%E6%96%87%E6%A1%A3%E5%AD%97%E7%AC%A6%E4%B8%B2\" >1.12 \u6587\u6863\u5b57\u7b26\u4e32<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-32\" href=\"https:\/\/17aitech.com\/?p=26289\/#113_%E7%B1%BB%E5%9E%8B%E6%8F%90%E7%A4%BA\" >1.13 \u7c7b\u578b\u63d0\u793a<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-33\" href=\"https:\/\/17aitech.com\/?p=26289\/#114_%E5%AD%97%E7%AC%A6%E4%B8%B2\" >1.14 \u5b57\u7b26\u4e32<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-34\" href=\"https:\/\/17aitech.com\/?p=26289\/#115_%E6%96%87%E4%BB%B6%E5%92%8Csockets\" >1.15 \u6587\u4ef6\u548csockets<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-35\" href=\"https:\/\/17aitech.com\/?p=26289\/#116_%E8%AE%BF%E9%97%AE%E6%8E%A7%E5%88%B6\" >1.16 \u8bbf\u95ee\u63a7\u5236<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-36\" href=\"https:\/\/17aitech.com\/?p=26289\/#117_Main\" >1.17 Main<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-37\" href=\"https:\/\/17aitech.com\/?p=26289\/#118_%E5%91%BD%E5%90%8D\" >1.18 \u547d\u540d<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-38\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E4%BA%8C%E3%80%81%E7%BC%96%E7%A0%81%E8%A7%84%E8%8C%83\" >\u4e8c\u3001\u7f16\u7801\u89c4\u8303<\/a><ul class='ez-toc-list-level-5' ><li class='ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-39\" href=\"https:\/\/17aitech.com\/?p=26289\/#21_%E4%B8%89%E7%9B%AE%E8%BF%90%E7%AE%97%E7%AC%A6\" >2.1 \u4e09\u76ee\u8fd0\u7b97\u7b26<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-40\" href=\"https:\/\/17aitech.com\/?p=26289\/#22_None_%E6%9D%A1%E4%BB%B6%E7%9A%84%E5%88%A4%E6%96%AD\" >2.2 None \u6761\u4ef6\u7684\u5224\u65ad<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-41\" href=\"https:\/\/17aitech.com\/?p=26289\/#23_lambda%E5%8C%BF%E5%90%8D%E5%87%BD%E6%95%B0\" >2.3 lambda\u533f\u540d\u51fd\u6570<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-42\" href=\"https:\/\/17aitech.com\/?p=26289\/#24_%E5%BC%82%E5%B8%B8\" >2.4 \u5f02\u5e38<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-43\" href=\"https:\/\/17aitech.com\/?p=26289\/#25_%E6%9D%A1%E4%BB%B6%E8%A1%A8%E8%BE%BE%E5%BC%8F\" >2.5 \u6761\u4ef6\u8868\u8fbe\u5f0f<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-44\" href=\"https:\/\/17aitech.com\/?p=26289\/#26_TrueFalse_%E5%B8%83%E5%B0%94%E8%BF%90%E7%AE%97\" >2.6 True\/False \u5e03\u5c14\u8fd0\u7b97<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-45\" href=\"https:\/\/17aitech.com\/?p=26289\/#27_%E5%88%97%E8%A1%A8%E6%8E%A8%E5%AF%BC%E5%BC%8F\" >2.7 \u5217\u8868\u63a8\u5bfc\u5f0f<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-46\" href=\"https:\/\/17aitech.com\/?p=26289\/#28_%E5%87%BD%E6%95%B0\" >2.8 \u51fd\u6570<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-47\" href=\"https:\/\/17aitech.com\/?p=26289\/#29_%E5%8F%98%E9%87%8F\" >2.9 \u53d8\u91cf<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-48\" href=\"https:\/\/17aitech.com\/?p=26289\/#%E5%B7%A5%E5%85%B7%E4%B8%8E%E9%85%8D%E7%BD%AE\" >\u5de5\u5177\u4e0e\u914d\u7f6e<\/a><ul class='ez-toc-list-level-5' ><li class='ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-49\" href=\"https:\/\/17aitech.com\/?p=26289\/#flake8\" >flake8<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-50\" href=\"https:\/\/17aitech.com\/?p=26289\/#pylint\" >pylint<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-51\" href=\"https:\/\/17aitech.com\/?p=26289\/#black\" >black<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-5'><a class=\"ez-toc-link ez-toc-heading-52\" href=\"https:\/\/17aitech.com\/?p=26289\/#EditorConfig\" >EditorConfig<\/a><\/li><\/ul><\/li><\/ul><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"%E5%89%8D%E8%A8%80\"><\/span>\u524d\u8a00<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>\u5728\u4e0a\u4e00\u7ae0<a href=\"https:\/\/17aitech.com\/?p=26137\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u524d\u540e\u7aef\u6d41\u7a0b\u6253\u901a<\/a>\uff0c\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\u7684\u524d\u540e\u7aef\u642d\u5efa\uff0c\u5f62\u6210\u4e86\u53ef\u7528\u7684Demo\u3002\u672c\u7ae0\uff0c\u6211\u4eec\u5c06\u4ecb\u7ecd\u4ee3\u7801\u91cd\u6784\u7684\u8fc7\u7a0b\uff0c\u5e76\u4ecb\u7ecd\u4e00\u4e9b\u4f18\u5316\u70b9\u3002<\/p>\n<h2><span class=\"ez-toc-section\" id=\"%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%AE%80%E4%BB%8B\"><\/span>\u4ee3\u7801\u91cd\u6784\u7b80\u4ecb<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>\u5728\u5f00\u542f\u672c\u7ae0\u4ecb\u7ecd\u4e4b\u524d\uff0c\u8bf7\u5141\u8bb8\u6211\u82b1\u70b9\u65f6\u95f4\u5570\u55e6\u4e24\u53e5\uff0c\u804a\u4e00\u804a\u4ee3\u7801\u91cd\u6784\u7684\u54ea\u4e9b\u4e8b\u513f\u3002<\/p>\n<p>\u5728\u8fc7\u53bb\u7ecf\u5386\u7684\u9879\u76ee\u4e2d\uff0c\u4ee3\u7801\u91cd\u6784\u5f88\u5c11\u88ab\u4eba\u91cd\u89c6\u3002\u770b\u7740\u50cf\ud83d\udca9\u4e00\u6837\u7684\u4ee3\u7801(\u62b1\u6b49\u7206\u7c97\u53e3\uff0c\u6211\u6240\u7ecf\u5386\u7684\u4e00\u4e9b\u9879\u76ee\u5305\u62ec\u6211\u81ea\u5df1\u66fe\u7ecf\u5199\u7684\u4ee3\u7801\uff0c\u56de\u770b\u786e\u5b9e\u50cf\ud83d\udca9\u4e00\u6837)\uff0c\u5b83\u4eec\u5e76\u6ca1\u6709\u88ab\u597d\u597d\u6e05\u7406\uff0c\u7136\u540e\u6211\u4eec\u5728\ud83d\udca9\u4e0a\u9762\u4e0d\u65ad\u52a0\u9700\u6c42\uff0c\u5bfc\u81f4\u9700\u6c42\u8fed\u4ee3\u8d8a\u6765\u8d8a\u96be\uff0cBug\u8d8a\u6765\u8d8a\u591a&#8230;<\/p>\n<p>\u8fd9\u79cd\u4e8b\u60c5\u73b0\u5728\u6bcf\u5929\u8fd8\u5728\u4e0d\u65ad\u5730\u53d1\u751f\u7740\uff0c\u6240\u4ee5\u6211\u51b3\u5b9a\u6709\u5fc5\u8981\u804a\u4e00\u804a\u4ee3\u7801\u91cd\u6784\u3002<\/p>\n<h3><span class=\"ez-toc-section\" id=\"%E4%BB%80%E4%B9%88%E6%98%AF%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84\"><\/span>\u4ec0\u4e48\u662f\u4ee3\u7801\u91cd\u6784<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p><strong>\u4ee3\u7801\u91cd\u6784<\/strong>\u662f\u6307\u5bf9\u73b0\u6709\u4ee3\u7801\u8fdb\u884c\u4fee\u6539\uff0c\u4ee5\u6539\u5584\u5176\u7ed3\u6784\u3001\u53ef\u8bfb\u6027\u548c\u53ef\u7ef4\u62a4\u6027\uff0c\u800c\u4e0d\u6539\u53d8\u5176\u5916\u90e8\u884c\u4e3a\u3002\u91cd\u6784\u7684\u4e3b\u8981\u76ee\u7684\u662f\u63d0\u9ad8\u4ee3\u7801\u8d28\u91cf\uff0c\u4f7f\u5176\u66f4\u6613\u4e8e\u7406\u89e3\u548c\u6269\u5c55\u3002<\/p>\n<h3><span class=\"ez-toc-section\" id=\"%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E7%9B%AE%E7%9A%84\"><\/span>\u4ee3\u7801\u91cd\u6784\u7684\u76ee\u7684<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<ul>\n<li><strong>\u63d0\u9ad8\u53ef\u8bfb\u6027<\/strong>\uff1a\u4f7f\u4ee3\u7801\u66f4\u6613\u4e8e\u7406\u89e3\uff0c\u4fbf\u4e8e\u56e2\u961f\u6210\u5458\u5feb\u901f\u4e0a\u624b\u3002<\/li>\n<li><strong>\u589e\u5f3a\u53ef\u7ef4\u62a4\u6027<\/strong>\uff1a\u964d\u4f4e\u540e\u7eed\u4fee\u6539\u548c\u6269\u5c55\u7684\u96be\u5ea6\uff0c\u51cf\u5c11\u6f5c\u5728\u7684\u9519\u8bef\u3002<\/li>\n<li><strong>\u4f18\u5316\u6027\u80fd<\/strong>\uff1a\u5728\u4e0d\u6539\u53d8\u529f\u80fd\u7684\u60c5\u51b5\u4e0b\uff0c\u63d0\u5347\u4ee3\u7801\u7684\u6267\u884c\u6548\u7387\u3002<\/li>\n<li><strong>\u6d88\u9664\u91cd\u590d\u4ee3\u7801<\/strong>\uff1a\u901a\u8fc7\u62bd\u8c61\u548c\u91cd\u7528\uff0c\u51cf\u5c11\u5197\u4f59\uff0c\u63d0\u9ad8\u4ee3\u7801\u7684\u6574\u6d01\u6027\u3002<\/li>\n<\/ul>\n<h3><span class=\"ez-toc-section\" id=\"%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E9%87%8D%E8%A6%81%E6%80%A7\"><\/span>\u4ee3\u7801\u91cd\u6784\u7684\u91cd\u8981\u6027<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>\u636e\u7edf\u8ba1\uff0c\u4e0d\u597d\u7684\u4ee3\u7801\u4f1a\u5360\u7528\u66f4\u591a\u5f00\u53d1\u7684\u65f6\u95f4\u3002<br \/>\n<a href=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u4ee3\u7801\u91cd\u6784.png\" data-fancybox=\"images\" data-fancybox=\"gallery\"><img decoding=\"async\" src=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u4ee3\u7801\u91cd\u6784.png\" alt=\"\" \/><\/a><\/p>\n<h3><span class=\"ez-toc-section\" id=\"%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E9%9A%BE%E7%82%B9\"><\/span>\u4ee3\u7801\u91cd\u6784\u7684\u96be\u70b9<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>\u901a\u8fc7\u4ee3\u7801\u91cd\u6784\u63d0\u5347\u4ee3\u7801\u8d28\u91cf\u65e2\u7136\u5982\u6b64\u91cd\u8981\uff0c\u90a3\u4e48\u4e3a\u4ec0\u4e48\u5f88\u5c11\u6709\u9879\u76ee\u5f00\u5c55\u5462\uff1f<\/p>\n<p>\u7a76\u5176\u539f\u56e0\uff0c\u53ef\u80fd\u6709\u4e09\u70b9\uff1a<\/p>\n<ul>\n<li>\n<p><strong>\u7b2c\u4e00\u79cd\uff1a\u6ca1\u6709\u7cbe\u529b\u91cd\u6784<\/strong>\u3002\u5f00\u53d1\u5de5\u7a0b\u5e08\u7ecf\u5e38\u6027\u88ab\u8001\u677f\u6216\u8005\u4ea7\u54c1\u7275\u7740\u9f3b\u5b50\u8d70\uff0c\u5b8c\u6210\u4e00\u4e2a\u9700\u6c42\u63a5\u7740\u4e00\u4e2a\u65b0\u7684\u9700\u6c42\uff0c\u6240\u4ee5\u5f88\u5c11\u5f00\u5c55\u91cd\u6784\u5de5\u4f5c\u3002\u8fd9\u79cd\u60c5\u51b5\u5728\u6280\u672f\u6027\u4e3a\u5bfc\u5411\u7684\u9879\u76ee\u8fd8\u597d\uff0c\u5728\u4ee5\u4ea7\u54c1\u6216\u5e02\u573a\u4e3a\u5bfc\u5411\u7684\u9879\u76ee\u4e2d\uff0c\u5c24\u5176\u4e25\u91cd\u3002<\/p>\n<\/li>\n<li>\n<p><strong>\u7b2c\u4e8c\u79cd\uff1a\u6ca1\u6709\u91cd\u6784\u7684\u601d\u7ef4<\/strong>\u3002\u5f88\u591a\u7684\u5f00\u53d1\u5de5\u7a0b\u5e08\u6ca1\u6709\u91cd\u6784\u7684\u601d\u7ef4\u751a\u81f3\u60f3\u6cd5\uff0c\u4ed6\u4eec\u4ee5\u5b8c\u6210\u9700\u6c42\u4ea4\u4ed8\u4e3a\u76ee\u7684\uff0c\u9700\u6c42\u4ea4\u4ed8\u4e86\u4e5f\u5c31\u4ee3\u8868\u4ed6\u7684\u5de5\u4f5c\u7ed3\u675f\u4e86\u3002<\/p>\n<blockquote>\n<p>\u6211\u66fe\u7ecf\u4e0e\u8c37\u6b4c\u56de\u6765\u7684\u4e00\u4f4d\u670b\u53cb\u6709\u6b21\u4ea4\u6d41\uff0c\u6211\u4eec\u63a2\u8ba8\u7684\u5185\u5bb9\u662f\uff1a\u4e3a\u4ec0\u4e48\u56fd\u5185\u7684\u7814\u53d1\u4eba\u5458\u4ee3\u7801\u8d28\u91cf\u610f\u8bc6\u8584\u5f31\uff1f\u4ed6\u8bf4\u5176\u4e2d\u4e00\u4e2a\u5f88\u91cd\u8981\u7684\u539f\u56e0\u662f\uff1a\u7845\u8c37\u7684\u5f88\u591a\u4ece\u4e1a\u8005\uff0c\u662f\u56e0\u4e3a\u70ed\u7231\uff0c\u70ed\u7231\u7f16\u7a0b\u3001\u70ed\u7231\u6280\u672f\uff0c\u6240\u4ee5\u89c6\u81ea\u5df1\u5199\u7684\u4ee3\u7801\u4e3a\u4e00\u4ef6\u827a\u672f\u54c1\uff0c\u529b\u6c42\u7cbe\u76ca\u6c42\u7cbe\uff1b\u800c\u56fd\u5185\u6709\u5f88\u591a\u4ece\u4e1a\u8005\uff0c\u662f\u56e0\u4e3a\u751f\u5b58\uff0c\u662f\u56e0\u4e3a\u505a\u5f00\u53d1\u7ed9\u94b1\u591a\uff0c\u662f\u4e00\u4efd\u517b\u5bb6\u7cca\u53e3\u7684\u4e00\u4efd\u5de5\u4f5c\u800c\u5df2\uff0c\u56e0\u4e3a\u7f3a\u5c11\u70ed\u7231\uff0c\u6240\u4ee5\u4ea4\u5dee\u4e86\u4e8b\u5373\u53ef\u3002\u5bf9\u6b64\uff0c\u6211\u6df1\u4ee5\u4e3a\u7136\u3002<\/p>\n<\/blockquote>\n<\/li>\n<li>\n<p><strong>\u7b2c\u4e09\u79cd\uff1a\u6ca1\u6709\u91cd\u6784\u7684\u65b9\u6cd5\u8bba<\/strong>\u3002\u867d\u7136\u6211\u4eec\u5f88\u50cf\u505a\u91cd\u6784\uff0c\u4f46\u662f\u91cd\u6784\u5de5\u4f5c\u5c31\u50cf\u4fee\u590d\u4e00\u8f86\u8d8a\u5f00\u8d8a\u6162\u7684\u8f66\u5b50\uff0c\u5982\u679c\u6ca1\u6709\u79d1\u5b66\u7684\u65b9\u6cd5\uff0c\u6709\u53ef\u80fd\u51fa\u73b0\u62c6\u4e86\u91cd\u88c5\u4e4b\u540e\uff0c\u53cd\u800c\u591a\u4e86\u51e0\u4e2a\u87ba\u4e1d\u7684\u95ee\u9898\uff0c\u8fd9\u4f1a\u8ba9\u8001\u677f\u66f4\u52a0\u6050\u6016\u3002<\/p>\n<\/li>\n<\/ul>\n<p>\u672c\u7ae0\uff0c\u6211\u5c06\u8bd5\u56fe\u4ee5\u8fd9\u4e2a\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\u4e3a\u4f8b\uff0c\u7b80\u5355\u4ecb\u7ecd\u4e00\u4e9b\u4ee3\u7801\u91cd\u6784\u7684\u539f\u5219\u3001\u65b9\u6cd5\u3002<\/p>\n<h2><span class=\"ez-toc-section\" id=\"%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84%E7%9A%84%E8%BF%87%E7%A8%8B\"><\/span>\u4ee3\u7801\u91cd\u6784\u7684\u8fc7\u7a0b<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<h3><span class=\"ez-toc-section\" id=\"1%E3%80%81%E6%90%AD%E5%BB%BA%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%E4%BB%A5%E5%8F%8A%E7%94%A8%E4%BE%8B%E9%9B%86\"><\/span>1\u3001\u642d\u5efa\u6d4b\u8bd5\u6846\u67b6\u4ee5\u53ca\u7528\u4f8b\u96c6<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>\u5728\u5f00\u5c55\u4ee3\u7801\u91cd\u6784\u524d\uff0c\u6211\u4eec\u8981\u642d\u5efa\u597d\u4e00\u4e2a\u4fbf\u4e8e\u56de\u5f52\u6d4b\u8bd5\u7684\u6d4b\u8bd5\u6846\u67b6\uff0c\u901a\u8fc7\u8fb9\u91cd\u6784\u8fb9\u56de\u5f52\u7684\u65b9\u5f0f\uff0c\u53ef\u4ee5\u5feb\u901f\u5b9a\u4f4d\u95ee\u9898\u6240\u5728\uff0c\u4ee5\u6b64\u964d\u4f4e\u95ee\u9898\u6392\u67e5\u7684\u6210\u672c\u3002<\/p>\n<p>\u6211\u4eec\u5728app\u76ee\u5f55\u4e0b\uff0c\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2atest_framework.py\u4e2d\uff0c\u7ee7\u7eed\u8865\u5145\u6d4b\u8bd5\u7528\u4f8b\u96c6\uff0c\u4f8b\u5982\uff1a<br \/>\n<a href=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u6d4b\u8bd5\u6846\u67b6\u5185\u5bb9.png\" data-fancybox=\"images\" data-fancybox=\"gallery\"><img decoding=\"async\" src=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u6d4b\u8bd5\u6846\u67b6\u5185\u5bb9.png\" alt=\"\" \/><\/a><\/p>\n<blockquote>\n<p>\u5728\u5927\u5382\u4e2d\uff0c\u56de\u5f52\u6d4b\u8bd5\u4e00\u822c\u4f1a\u4f7f\u7528\u5355\u5143\u6d4b\u8bd5\u6846\u67b6(\u5982pytest)\u6765\u8fdb\u884c\u6267\u884c\uff0c\u7531\u4e8e\u672c\u4f8b\u4e2d\u6211\u4eec\u7684\u65b9\u6cd5\u8f83\u4e3a\u7b80\u5355\uff0c\u6240\u4ee5\u5c31\u6ca1\u6709\u4f7f\u7528pytest\u3002<\/p>\n<\/blockquote>\n<h3><span class=\"ez-toc-section\" id=\"2%E3%80%81%E6%B6%88%E7%81%AD%E4%BB%A3%E7%A0%81%E4%B8%AD%E7%9A%84%E5%9D%8F%E5%91%B3%E9%81%93\"><\/span>2\u3001\u6d88\u706d\u4ee3\u7801\u4e2d\u7684\u574f\u5473\u9053<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<h4><span class=\"ez-toc-section\" id=\"21%E3%80%81%E7%BB%9F%E4%B8%80%E7%AE%A1%E7%90%86%E9%85%8D%E7%BD%AE%E7%9B%B8%E5%85%B3%E5%86%85%E5%AE%B9\"><\/span>2.1\u3001\u7edf\u4e00\u7ba1\u7406\u914d\u7f6e\u76f8\u5173\u5185\u5bb9<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u5728\u4e4b\u524d\u5b9e\u73b0\u7684RAG\u7ba1\u7406\u6a21\u5757\u4e2d\uff0c\u6709\u5f88\u591a\u7684\u914d\u7f6e\u662f\u786c\u7f16\u7801\u5199\u5728\u4ee3\u7801\u521d\u59cb\u5316\u4e2d\u7684\uff0c\u4f8b\u5982\uff1a<\/p>\n<pre><code class=\"language-python\"># \u539f\u59cb\u7684rag.py\nclass RagManager:\n    def __init__(self,\n                 chroma_server_type=&quot;http&quot;,\n                 host=&quot;localhost&quot;, port=8000,\n                 persist_path=&quot;chroma_db&quot;,\n                 llm=None, embed=None):\n        self.llm = llm\n        self.embed = embed\n\n        chrom_db = ChromaDB(chroma_server_type=chroma_server_type,\n                            host=host, port=port,\n                            persist_path=persist_path,\n                            embed=embed)\n        self.store = chrom_db.get_store()<\/code><\/pre>\n<p>\u6211\u4eec\u53ef\u4ee5\u5c06\u6240\u6709\u7684\u914d\u7f6e\u76f8\u5173\u62bd\u53d6\u5230\u4e00\u4e2asettings.py\u4e2d\uff0c\u7136\u540e\u5728\u4f7f\u7528\u7684\u4ee3\u7801\u4e2d\u901a\u8fc7\u5f15\u7528settings.py\u6765\u8fdb\u884c\u914d\u7f6e\u3002<\/p>\n<pre><code class=\"language-python\"># setttings.py\n\n&quot;&quot;&quot;\nChroma\u5411\u91cf\u6570\u636e\u5e93\u4f7f\u7528\u65f6\u7684\u76f8\u5173\u7684\u914d\u7f6e\n&quot;&quot;&quot;\n# \u9ed8\u8ba4\u7684ChromaDB\u7684\u670d\u52a1\u5668\u7c7b\u522b\nCHROMA_SERVER_TYPE = &quot;http&quot;\n# \u9ed8\u8ba4\u672c\u5730\u6570\u636e\u5e93\u7684\u6301\u4e45\u5316\u76ee\u5f55\nCHROMA_PERSIST_DB_PATH = &quot;chroma_db&quot;\n\nCHROMA_HOST = os.getenv(&quot;CHROMA_HOST&quot;, &quot;localhost&quot;)\nCHROMA_PORT = int(os.getenv(&quot;CHROMA_PORT&quot;, 8000))\nCHROMA_COLLECTION_NAME = &quot;langchain&quot;\n<\/code><\/pre>\n<p>\u8bf4\u660e\uff1a<\/p>\n<ul>\n<li>\u4e3a\u4e86\u6709\u522b\u4e8e\u53d8\u91cf\u7684\u547d\u540d\uff0c\u5bf9\u4e8e\u914d\u7f6e\u6211\u4eec\u4f7f\u7528\u5927\u5199\u7684\u53d8\u91cf\u540d\uff0c\u4f8b\u5982\uff1aCHROMA_HOST\u3001CHROMA_PORT\u7b49\u3002<\/li>\n<\/ul>\n<pre><code class=\"language-python\"># \u91cd\u6784\u7684rag.py\nimport settings\n\nclass RagManager:\n    def __init__(self,\n                 vector_db_class=ChromaDB,  # \u9ed8\u8ba4\u4f7f\u7528 ChromaDB\n                 db_config=None,  # \u6570\u636e\u5e93\u914d\u7f6e\u53c2\u6570\n                 llm=None, embed=None,\n                 retriever_cls=SimpleRetrieverWrapper, **retriever_kwargs):\n        self.llm = llm\n        self.embed = embed\n        logger.info(f&#039;\u521d\u59cb\u5316llm\u5927\u6a21\u578b\uff1a{self.llm}&#039;)\n        logger.info(f&#039;\u521d\u59cb\u5316embed\u6a21\u578b\uff1a{self.embed}&#039;)\n\n        # \u5982\u679c\u6ca1\u6709\u63d0\u4f9b db_config\uff0c\u4f7f\u7528\u9ed8\u8ba4\u914d\u7f6e\n        if db_config is None:\n            db_config = {\n                &quot;chroma_server_type&quot;: settings.CHROMA_SERVER_TYPE,\n                &quot;host&quot;: settings.CHROMA_HOST,\n                &quot;port&quot;: settings.CHROMA_PORT,\n                &quot;persist_path&quot;: settings.CHROMA_PERSIST_DB_PATH,\n                &quot;collection_name&quot;: settings.CHROMA_COLLECTION_NAME\n            }\n            logger.info(f&#039;\u521d\u59cb\u5316\u5411\u91cf\u6570\u636e\u5e93\u914d\u7f6e\uff1a{db_config}&#039;)\n\n        # \u521b\u5efa\u5411\u91cf\u6570\u636e\u5e93\u5b9e\u4f8b\n        self.vector_db = vector_db_class(**db_config, embed=self.embed)\n        self.store = self.vector_db.get_store()\n<\/code><\/pre>\n<p>\u8bf4\u660e\uff1a<\/p>\n<ul>\n<li>\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u901a\u8fc7<code>import settings<\/code>\uff0c\u5728\u4f7f\u7528\u914d\u7f6e\u65f6\u901a\u8fc7settings.CHROMA_SERVER_TYPE\u3001settings.CHROMA_HOST\u7b49\u6765\u5f15\u7528\u3002<\/li>\n<\/ul>\n<h4><span class=\"ez-toc-section\" id=\"22%E3%80%81%E5%A4%84%E7%90%86%E5%8F%82%E6%95%B0%E8%BF%87%E9%95%BF%E7%9A%84%E9%97%AE%E9%A2%98\"><\/span>2.2\u3001\u5904\u7406\u53c2\u6570\u8fc7\u957f\u7684\u95ee\u9898<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u5728\u539f\u59cb\u4ee3\u7801\u4e2d\uff0c\u968f\u7740\u6211\u4eec\u7684\u9700\u6c42\u8fed\u4ee3\uff0c\u5728\u521b\u5efaRAG\u65f6\u9700\u8981\u4f20\u5165\u591a\u4e2a\u7684\u53c2\u6570\uff0c\u4f8b\u5982\uff1a<\/p>\n<ul>\n<li>chroma_server_type<\/li>\n<li>host<\/li>\n<li>port<\/li>\n<li>persist_path<\/li>\n<li>collection_name<\/li>\n<\/ul>\n<p>\u5982\u679c\u6309\u7167\u539f\u6765\u7684\u65b9\u6cd5\u5199\u51fd\u6570\uff0c\u90a3\u4e48\u51fd\u6570\u7684\u53c2\u6570\u5217\u8868\u5c31\u4f1a\u975e\u5e38\u957f\uff0c\u5982\u4e0b\uff1a<\/p>\n<pre><code class=\"language-python\">RagManager(chroma_server_type=&quot;http&quot;, host=&quot;localhost&quot;, port=8000, persist_path=&quot;chroma_db&quot;, collection_name=&quot;langchain&quot;,llm , embed)<\/code><\/pre>\n<p>\u5bf9\u4e8e\u8fd9\u79cd\u53c2\u6570\u7684\u95ee\u9898\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u5b57\u5178\u6765\u5904\u7406\uff0c\u5982\u4e0b\uff1a<\/p>\n<pre><code class=\"language-python\">db_config = {\n                &quot;chroma_server_type&quot;: settings.CHROMA_SERVER_TYPE,\n                &quot;host&quot;: settings.CHROMA_HOST,\n                &quot;port&quot;: settings.CHROMA_PORT,\n                &quot;persist_path&quot;: settings.CHROMA_PERSIST_DB_PATH,\n                &quot;collection_name&quot;: settings.CHROMA_COLLECTION_NAME,\n            }\n\nRagManager(vector_db_class=ChromaDB, db_config=db_config, llm=self.llm, embed=self.embed)<\/code><\/pre>\n<p>\u8bf4\u660e\uff1a<\/p>\n<ul>\n<li><code>db_config<\/code>\u662f\u4e00\u4e2a\u5b57\u5178\uff0c\u53ef\u4ee5\u5305\u542b\u591a\u4e2a\u914d\u7f6e\u53c2\u6570\uff0c\u4f8b\u5982\uff1a<code>chroma_server_type<\/code>\u3001<code>host<\/code>\u3001<code>port<\/code>\u3001<code>persist_path<\/code>\u3001<code>collection_name<\/code>\u7b49\u3002<\/li>\n<li><code>db_config<\/code>\u4e2d\u7684\u53c2\u6570\u53ef\u4ee5\u901a\u8fc7<code>**<\/code>\u5173\u952e\u5b57\u6765\u89e3\u5305\uff0c\u4ece\u800c\u4f20\u5165\u5230\u51fd\u6570\u4e2d\u3002<\/li>\n<li><code>RagManager<\/code> \u7684\u521d\u59cb\u5316\u51fd\u6570\u4e2d\uff0c\u901a\u8fc7<code>**<\/code>\u5173\u952e\u5b57\u6765\u89e3\u5305<code>db_config<\/code>\uff0c\u4ece\u800c\u4f20\u5165\u5230ChromaDB\u7684\u521d\u59cb\u5316\u51fd\u6570\u4e2d\u3002 <\/li>\n<\/ul>\n<h4><span class=\"ez-toc-section\" id=\"23%E3%80%81%E5%87%8F%E5%B0%91%E9%87%8D%E5%A4%8D%E4%BB%A3%E7%A0%81\"><\/span>2.3\u3001\u51cf\u5c11\u91cd\u590d\u4ee3\u7801<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u5728<a href=\"https:\/\/17aitech.com\/?p=25969\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1aRAG\u68c0\u7d22\u6a21\u5757\u521d\u5efa\u6210<\/a>\u4e2d\uff0c\u6211\u4eec\u66fe\u5b9e\u73b0\u4e86\u4e00\u4e2a<code>pdf_processor.py<\/code>\uff0c \u8be5\u51fd\u6570\u4e3b\u8981\u7684\u5de5\u4f5c\u662f\uff1a<\/p>\n<pre><code class=\"language-python\">def process_pdfs(self)                            # \u5904\u7406pdf\u6587\u4ef6\ndef process_pdfs_group(self, pdf_files_group)     # \u5206\u7ec4\u5904\u7406pdf\u6587\u4ef6\ndef load_pdf_files(self)                          # \u52a0\u8f7dpdf\u6587\u4ef6\ndef load_pdf_content(self, pdf_path)              # \u8bfb\u53d6pdf\u6587\u4ef6\u5185\u5bb9\ndef split_text(self, documents)                   # \u5206\u5272\u8bfb\u53d6\u5230\u7684\u6587\u672c\ndef insert_docs_chromadb(self, docs, batch_size)  # \u5411\u5411\u91cf\u6570\u636e\u5e93\u4e2d\u63d2\u5165\u6570\u636e<\/code><\/pre>\n<p>\u5982\u679c\u6211\u4eec\u8981\u5c06PDF\u6587\u4ef6\u7ed9ElasticSearch\u670d\u52a1\u91cc\uff0c\u90a3\u4e48\u8fd9\u4e2a\u8fc7\u7a0b\u5927\u90e8\u5206\u5b9e\u73b0\u903b\u8f91\u90fd\u662f\u4e00\u6837\u7684\uff0c\u53ea\u662f\u63d2\u5165\u7684\u5bf9\u8c61\u4e0d\u540c\uff0c\u4e00\u4e2a\u662f\u5411\u5411\u91cf\u6570\u636e\u5e93\u4e2d\u63d2\u5165\uff0c\u4e00\u4e2a\u662f\u5411elasticsearch\u4e2d\u63d2\u5165\u3002<\/p>\n<p>\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c<\/p>\n<ul>\n<li><strong>\u4e0d\u597d\u7684\u505a\u6cd5<\/strong>\uff1a\u590d\u5236\u4e0a\u8ff0\u4ee3\u7801\u5230\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u4e2d\uff0c\u7136\u540e\u5c06\u6700\u540e\u4e00\u6b65insert_docs_chromadb()\u6539\u4e3ainsert_docs_elasticsearch()\uff0c\u8fd9\u6837\u4f1a\u5bfc\u81f4\u4ee3\u7801\u91cd\u590d\u3002<\/li>\n<li><strong>\u8f83\u597d\u7684\u505a\u6cd5<\/strong>\uff1a\u5bf9\u4e0a\u8ff0\u7684\u63d2\u5165\u8fc7\u7a0b\u8fdb\u884c\u91cd\u6784\uff0c\u5c06\u63d2\u5165\u51fd\u6570\u901a\u8fc7\u51fd\u6570\u7c7b\u6765\u8c03\u7528\uff0c\u901a\u8fc7\u4e00\u4e2a\u53c2\u6570<code>vector_db_class<\/code>\u6765\u51b3\u5b9a\u63d2\u5165\u5411\u91cf\u6570\u636e\u5e93\u8fd8\u662fElasticSearch\u3002<\/li>\n<\/ul>\n<pre><code class=\"language-python\"># \u91cd\u6784\u540e\u7684pdf_processor.py\n\nimport os\nimport logging\nimport time\nfrom tqdm import tqdm\nfrom langchain_community.document_loaders import PyMuPDFLoader\nfrom langchain_text_splitters import RecursiveCharacterTextSplitter\nfrom rag.vector_db import VectorDB\nfrom rag.elasticsearch_db import TraditionDB\nfrom utils.logger_config import LoggerManager\n\nlogger = LoggerManager().logger\n\nclass PDFProcessor:\n    def __init__(self, directory, db_type=&#039;vector&#039;, **kwargs):\n        &quot;&quot;&quot;\n        \u521d\u59cb\u5316 PDF \u5904\u7406\u5668\n        :param directory: PDF \u6587\u4ef6\u6240\u5728\u76ee\u5f55\n        :param db_type: \u6570\u636e\u5e93\u7c7b\u578b (&#039;vector&#039; \u6216 &#039;es&#039;)\n        :param kwargs: \u5176\u4ed6\u53c2\u6570\n        &quot;&quot;&quot;\n        self.directory = directory  # PDF \u6587\u4ef6\u6240\u5728\u76ee\u5f55\n        self.db_type = db_type  # \u6570\u636e\u5e93\u7c7b\u578b\n        self.file_group_num = kwargs.get(&#039;file_group_num&#039;, 20)  # \u6bcf\u7ec4\u5904\u7406\u7684\u6587\u4ef6\u6570\n        self.batch_num = kwargs.get(&#039;batch_num&#039;, 6)  # \u6bcf\u6b21\u63d2\u5165\u7684\u6279\u6b21\u6570\u91cf\n        self.chunksize = kwargs.get(&#039;chunksize&#039;, 500)  # \u5207\u5206\u6587\u672c\u7684\u5927\u5c0f\n        self.overlap = kwargs.get(&#039;overlap&#039;, 100)  # \u5207\u5206\u6587\u672c\u7684\u91cd\u53e0\u5927\u5c0f\n        logger.info(f&quot;&quot;&quot;\n                    \u521d\u59cb\u5316PDF\u6587\u4ef6\u5bfc\u5165\u5668:\n                    \u914d\u7f6e\u53c2\u6570\uff1a\n                    - \u5bfc\u5165\u7684\u6587\u4ef6\u8def\u5f84\uff1a{self.directory}\n                    - \u6bcf\u6b21\u5904\u7406\u6587\u4ef6\u6570\uff1a{self.file_group_num}\n                    - \u6bcf\u6279\u6b21\u5904\u7406\u6837\u672c\u6570\uff1a{self.batch_num}\n                    - \u5207\u5206\u6587\u672c\u7684\u5927\u5c0f\uff1a{self.chunksize}\n                    - \u5207\u5206\u6587\u672c\u91cd\u53e0\u5927\u5c0f\uff1a{self.overlap}\n                    &quot;&quot;&quot;)\n\n        # \u6839\u636e\u6570\u636e\u5e93\u7c7b\u578b\u521d\u59cb\u5316\u76f8\u5e94\u7684\u5ba2\u6237\u7aef\n        if db_type == &#039;vector&#039;:\n            self.vector_db = kwargs.get(&#039;vector_db&#039;)  # \u5411\u91cf\u6570\u636e\u5e93\u5b9e\u4f8b\n            self.es_client = None\n\n            logger.info(f&#039;\u5bfc\u5165\u7684\u76ee\u6807\u6570\u636e\u5e93\u4e3a\uff1a\u5411\u91cf\u6570\u636e\u5e93&#039;)\n        elif db_type == &#039;es&#039;:\n            self.vector_db = None\n            self.es_client = kwargs.get(&#039;es_client&#039;)  # Elasticsearch \u5ba2\u6237\u7aef\n\n            logger.info(f&#039;\u5bfc\u5165\u7684\u76ee\u6807\u6570\u636e\u5e93\u4e3a\uff1aES\u6570\u636e\u5e93&#039;)\n        else:\n            raise ValueError(&quot;db_type must be either &#039;vector&#039; or &#039;es&#039;.&quot;)\n\n    def load_pdf_files(self):\n        # \u8fd9\u90e8\u5206\u4ee3\u7801\u672a\u505a\u4fee\u6539\uff0c\u5177\u4f53\u5185\u5bb9\u7701\u7565\n\n    def load_pdf_content(self, pdf_path):\n        # \u8fd9\u90e8\u5206\u4ee3\u7801\u672a\u505a\u4fee\u6539\uff0c\u5177\u4f53\u5185\u5bb9\u7701\u7565\n\n    def split_text(self, documents):\n        # \u8fd9\u90e8\u5206\u4ee3\u7801\u672a\u505a\u4fee\u6539\uff0c\u5177\u4f53\u5185\u5bb9\u7701\u7565\n\n    def process_pdfs(self):\n        # \u8fd9\u90e8\u5206\u4ee3\u7801\u672a\u505a\u4fee\u6539\uff0c\u5177\u4f53\u5185\u5bb9\u7701\u7565\n\n    def insert_docs(self, docs, insert_function, batch_size=None):\n        &quot;&quot;&quot;\n        \u5c06\u6587\u6863\u63d2\u5165\u5230\u6307\u5b9a\u7684\u6570\u636e\u5e93\uff0c\u5e76\u663e\u793a\u8fdb\u5ea6\n        :param docs: \u8981\u63d2\u5165\u7684\u6587\u6863\u5217\u8868\n        :param insert_function: \u63d2\u5165\u51fd\u6570\n        :param batch_size: \u6279\u6b21\u5927\u5c0f\n        &quot;&quot;&quot;\n        if batch_size is None:\n            batch_size = self.batch_num\n\n        logging.info(f&quot;Inserting {len(docs)} documents.&quot;)\n        start_time = time.time()\n        total_docs_inserted = 0\n\n        total_batches = (len(docs) + batch_size - 1) \/\/ batch_size\n\n        with tqdm(total=total_batches, desc=&quot;Inserting batches&quot;, unit=&quot;batch&quot;) as pbar:\n            for i in range(0, len(docs), batch_size):\n                batch = docs[i:i + batch_size]\n                insert_function(batch)  # \u8c03\u7528\u4f20\u5165\u7684\u63d2\u5165\u51fd\u6570\n\n                total_docs_inserted += len(batch)\n\n                # \u8ba1\u7b97\u5e76\u663e\u793a\u5f53\u524d\u7684TPM\n                elapsed_time = time.time() - start_time\n                if elapsed_time &gt; 0:\n                    tpm = (total_docs_inserted \/ elapsed_time) * 60\n                    pbar.set_postfix({&quot;TPM&quot;: f&quot;{tpm:.2f}&quot;})\n\n                pbar.update(1)\n\n    def insert_to_vector_db(self, docs):\n        &quot;&quot;&quot;\n        \u5c06\u6587\u6863\u63d2\u5165\u5230 VectorDB\n        &quot;&quot;&quot;\n        self.vector_db.add_with_langchain(docs)\n\n    def insert_to_elasticsearch(self, docs):\n        &quot;&quot;&quot;\n        \u5c06\u6587\u6863\u63d2\u5165\u5230 Elasticsearch\n        &quot;&quot;&quot;\n        self.es_client.add_documents(docs)\n\n    def process_pdfs_group(self, pdf_files_group):\n        # \u8bfb\u53d6PDF\u6587\u4ef6\u5185\u5bb9\n        pdf_contents = []\n\n        for pdf_path in pdf_files_group:\n            # \u8bfb\u53d6PDF\u6587\u4ef6\u5185\u5bb9\n            documents = self.load_pdf_content(pdf_path)\n\n            # \u5c06documents \u9010\u4e00\u6dfb\u52a0\u5230pdf_contents\n            pdf_contents.extend(documents)\n\n        # \u5c06\u6587\u672c\u5207\u5206\u6210\u5c0f\u6bb5\n        docs = self.split_text(pdf_contents)\n\n        if self.db_type == &#039;vector&#039;:\n            # \u5c06\u6587\u6863\u63d2\u5165\u5230 VectorDB\n            self.insert_docs(docs, self.insert_to_vector_db)\n        elif self.db_type == &#039;es&#039;:\n            # \u5c06\u6587\u6863\u63d2\u5165\u5230 Elasticsearch\n            self.insert_docs(docs, self.insert_to_elasticsearch)\n        else:\n            raise ValueError(&quot;db_type must be either &#039;vector&#039; or &#039;es&#039;.&quot;)<\/code><\/pre>\n<p>\u8bf4\u660e\uff1a<\/p>\n<ul>\n<li>\u5728\u7c7b\u7684\u521d\u59cb\u5316\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u901a\u8fc7\u4e00\u4e2a\u53c2\u6570<code>vector_db<\/code>\u6765\u8fde\u63a5\u5bf9\u5e94\u7684\u6570\u636e\u5e93\u5b9e\u4f8b\uff0c\u540c\u65f6\u4f20\u5165<code>db_type<\/code>\u544a\u77e5PDF\u5904\u7406\u5668\u9700\u8981\u64cd\u4f5c\u7684\u6570\u636e\u5e93\u7c7b\u578b\u3002<\/li>\n<li>\u5728\u5904\u7406PDF\u6587\u4ef6\u65f6\uff0c\u6211\u4eec\u901a\u8fc7\u53c2\u6570<code>db_type<\/code>\u6765\u51b3\u5b9a\u63d2\u5165\u5411\u91cf\u6570\u636e\u5e93\u8fd8\u662fElasticSearch\u3002<\/li>\n<li>\u5728\u63d2\u5165\u6587\u6863 <code>insert_docs<\/code> \u4e2d\uff0c\u6839\u636e\u4e0a\u4e00\u6b65\u9aa4\u4f20\u5165\u7684 <code>insert_function<\/code> \u6765\u8c03\u7528\u5177\u4f53\u7684\u63d2\u5165\u51fd\u6570\uff1a\u5982\u679c\u662f\u63d2\u5165\u5411\u91cf\u6570\u636e\u5e93\uff0c\u5219\u4f20\u5165\u7684\u51fd\u6570\u4e3a<code>self.insert_to_vector_db<\/code>\uff0c\u90a3\u4e48\u8c03\u7528\u65f6\u4e5f\u4f1a\u8c03\u7528 <code>insert_to_vector_db<\/code> \uff1b\u5982\u679c\u662f\u63d2\u5165ElasticSearch\uff0c\u5219\u4f20\u5165\u7684\u51fd\u6570\u4e3a<code>self.insert_to_elasticsearch<\/code>\uff0c\u90a3\u4e48\u8c03\u7528\u65f6\u4f1a\u8c03\u7528 <code>insert_to_elasticsearch<\/code> \u3002<\/li>\n<\/ul>\n<h4><span class=\"ez-toc-section\" id=\"24%E3%80%81%E4%BD%BF%E7%94%A8%E9%9D%99%E6%80%81%E6%89%AB%E6%8F%8F%E5%B7%A5%E5%85%B7%E4%BC%98%E5%8C%96%E4%BB%A3%E7%A0%81%E9%A3%8E%E6%A0%BC\"><\/span>2.4\u3001\u4f7f\u7528\u9759\u6001\u626b\u63cf\u5de5\u5177\u4f18\u5316\u4ee3\u7801\u98ce\u683c<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u9759\u6001\u626b\u63cf\u5de5\u5177\u5bf9\u4ee3\u7801\u8fdb\u884c\u98ce\u683c\u4f18\u5316\uff0c\u5982Pylint\u3001Flake8\u7b49\uff0c\u4e00\u822c\u60c5\u51b5\u4e0bPyCharm\u4e2d\u4f1a\u81ea\u5e26\u8fd9\u4e9b\u5de5\u5177\u3002<\/p>\n<p>\u5177\u4f53\u65b9\u6cd5\uff1a<\/p>\n<ol>\n<li>\u542f\u52a8PyCharm<\/li>\n<li>\u6253\u5f00\u5de5\u7a0b\u65f6\uff0c\u9009\u62e9app\u76ee\u5f55<\/li>\n<li>\u6253\u5f00\u4efb\u610f.py\u6587\u4ef6\u540e\uff0c\u53f3\u4e0a\u89d2\u4f1a\u6709\u9759\u6001\u626b\u63cf\u95ee\u9898\u63d0\u793a(\u5982\u4e0b\u56fe)<\/li>\n<li>\u6839\u636e\u9759\u6001\u626b\u63cf\u7684\u95ee\u9898\uff0c\u8fdb\u884c\u4ee3\u7801\u98ce\u683c\u4fee\u6b63(\u5e38\u89c1\u4ee3\u7801\u98ce\u683c\u95ee\u9898\u8bf7\u89c1\u9644\u5f55\u90e8\u5206)<br \/>\n<a href=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u9759\u6001\u626b\u63cf\u63d0\u793a.png\" data-fancybox=\"images\" data-fancybox=\"gallery\"><img decoding=\"async\" src=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u9759\u6001\u626b\u63cf\u63d0\u793a.png\" alt=\"\" \/><\/a><\/li>\n<\/ol>\n<h3><span class=\"ez-toc-section\" id=\"3%E3%80%81%E5%9B%9E%E5%BD%92%E6%B5%8B%E8%AF%95\"><\/span>3\u3001\u56de\u5f52\u6d4b\u8bd5<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>\u5728\u8fdb\u884c\u4e0a\u9762\u6bcf\u4e00\u6b65\u91cd\u6784\u65f6\uff0c\u90fd\u9700\u8981\u4f7f\u7528test_framework.py\u8fdb\u884c\u56de\u5f52\u6d4b\u8bd5\uff0c\u786e\u4fdd\u91cd\u6784\u540e\u7684\u4ee3\u7801\u6ca1\u6709\u5f15\u5165\u65b0\u7684\u9519\u8bef\u3002<\/p>\n<p>\u7531\u4e8e\u672c\u9879\u76ee\u91cd\u6784\u7ec6\u8282\u7684\u5185\u5bb9\u975e\u5e38\u591a\uff0c\u4e0d\u80fd\u4e00\u4e00\u5217\u4e3e\uff0c\u91cd\u6784\u540e\u7684\u5185\u5bb9\u8bf7\u67e5\u770bGitee\u6216\u8005Github\u4ed3\u5e93\u7684\u4ee3\u7801\u3002<\/p>\n<h2><span class=\"ez-toc-section\" id=\"%E5%86%85%E5%AE%B9%E5%B0%8F%E7%BB%93\"><\/span>\u5185\u5bb9\u5c0f\u7ed3<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>\u4ee3\u7801\u91cd\u6784\u662f\u4e00\u4ef6\u975e\u5e38\u91cd\u8981\u7684\u5de5\u4f5c\uff0c\u5b83\u53ef\u4ee5\u5e2e\u52a9\u63d0\u9ad8\u4ee3\u7801\u8d28\u91cf\uff0c\u63d0\u5347\u4ee3\u7801\u53ef\u8bfb\u6027\u548c\u53ef\u7ef4\u62a4\u6027\uff0c\u8fdb\u800c\u4e3a\u540e\u7eed\u7684\u8fed\u4ee3\u5f00\u53d1\u63d0\u4f9b\u57fa\u7840\u3002<\/li>\n<li>\u91cd\u6784\u8fc7\u7a0b\u7684\u4e00\u822c\u6b65\u9aa4\uff1a\n<ul>\n<li>\u4ee3\u7801\u91cd\u6784\u524d\uff0c\u9700\u8981\u63d0\u524d\u51c6\u5907\u597d\u6d4b\u8bd5\u6846\u67b6\u548c\u6d4b\u8bd5\u7528\u4f8b\u3002<\/li>\n<li>\u4ee3\u7801\u91cd\u6784\u65f6\uff0c\u8fdb\u884c\u4ee3\u7801\u4f18\u5316\u4fee\u6539\uff0c\u5e76\u8fdb\u884c\u5355\u5143\u6d4b\u8bd5\u3002<\/li>\n<li>\u91cd\u6784\u5b8c\u4e00\u4e2a\u6a21\u5757\u5e76\u6d4b\u8bd5\u901a\u8fc7\u540e\uff0c\u518d\u8fdb\u884c\u4e0b\u4e00\u4e2a\u6a21\u5757\u7684\u91cd\u6784\u3002<\/li>\n<li>\u91cd\u6784\u5b8c\u6210\u540e\uff0c\u8fdb\u884c\u6574\u4f53\u6d4b\u8bd5\uff0c\u786e\u4fdd\u91cd\u6784\u540e\u7684\u4ee3\u7801\u6ca1\u6709\u5f15\u5165\u65b0\u7684\u9519\u8bef\u3002<\/li>\n<\/ul>\n<\/li>\n<li>\u4ee3\u7801\u91cd\u6784\u5e38\u89c1\u7684\u4f18\u5316\u65b9\u5411\uff1a\n<ul>\n<li>\u7edf\u4e00\u914d\u7f6e\u9879\u7684\u7ba1\u7406\uff0c\u4e0d\u8981\u5728\u4ee3\u7801\u4e2d\u5199\u6b7b\u914d\u7f6e\u3002<\/li>\n<li>\u51cf\u5c11\u91cd\u590d\u4ee3\u7801\uff0c\u4f7f\u7528\u51fd\u6570\u3001\u7c7b\u7b49\u5c01\u88c5\u4ee3\u7801\uff0c\u63d0\u9ad8\u4ee3\u7801\u590d\u7528\u6027\u3002<\/li>\n<li>\u5bf9\u4e8e\u53c2\u6570\u8d85\u957f\u7684\u60c5\u51b5\uff0c\u4f7f\u7528\u5b57\u5178\u6216\u5143\u7ec4\u7b49\u7ed3\u6784\u3002<\/li>\n<li>\u4f7f\u7528\u9759\u6001\u626b\u63cf\u5de5\u5177\u6765\u4f18\u5316\u4ee3\u7801\u98ce\u683c\u3002<\/li>\n<li>&#8230;&#8230;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"%E9%99%84%E5%BD%95\"><\/span>\u9644\u5f55<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>\u6b22\u8fce\u67e5\u770b\u8be5\u7cfb\u5217\u7684\u5176\u4ed6\u6587\u7ae0\uff1a<\/p>\n<ul>\n<li><a href=\"https:\/\/17aitech.com\/?p=25830\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u9879\u76ee\u7b80\u4ecb<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=25969\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1aRAG\u68c0\u7d22\u6a21\u5757\u521d\u5efa\u6210<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=25994\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1aAgent\u6846\u67b6\u7684\u6784\u5efa<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=26137\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u524d\u540e\u7aef\u6d41\u7a0b\u6253\u901a<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=26289\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=26700\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1aRAG\u7684\u68c0\u7d22\u589e\u5f3a\u4e4bElasticSearch<\/a><\/li>\n<li><a href=\"https:\/\/17aitech.com\/?p=26930\">\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1aRAG\u7684\u68c0\u7d22\u589e\u5f3a\u4e4b\u4e0a\u4e0b\u6587\u91cd\u6392\u548c\u538b\u7f29<\/a><\/li>\n<\/ul>\n<p align=\"center\">\u6b22\u8fce\u5173\u6ce8\u516c\u4f17\u53f7\u4ee5\u83b7\u5f97\u6700\u65b0\u7684\u6587\u7ae0\u548c\u65b0\u95fb<\/p>\n<p><a href=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u626b\u7801_\u641c\u7d22\u8054\u5408\u4f20\u64ad\u6837\u5f0f-\u767d\u8272\u7248.bmp\" data-fancybox=\"images\" data-fancybox=\"gallery\"><img decoding=\"async\" src=\"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u626b\u7801_\u641c\u7d22\u8054\u5408\u4f20\u64ad\u6837\u5f0f-\u767d\u8272\u7248.bmp\" alt=\"\" \/><\/a><\/p>\n<h3><span class=\"ez-toc-section\" id=\"Python_%E7%BC%96%E7%A0%81%E9%A3%8E%E6%A0%BC%E4%B8%8E%E8%A7%84%E8%8C%83\"><\/span>Python \u7f16\u7801\u98ce\u683c\u4e0e\u89c4\u8303<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<h4><span class=\"ez-toc-section\" id=\"%E8%AF%B4%E6%98%8E\"><\/span>\u8bf4\u660e<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u4e3a\u4e86\u8ba9\u4e0d\u540c\u7f16\u7801\u4e60\u60ef\u7684\u5f00\u53d1\u8005\u66f4\u597d\u7684\u534f\u4f5c\u914d\u5408\uff0c\u5e76\u4e14\u5f62\u6210\u826f\u597d\u7684\u57fa\u7840\u7f16\u7801\u89c4\u8303\u4e0e\u98ce\u683c\uff0c\u6211\u4eec\u4ee5 <a href=\"https:\/\/www.python.org\/dev\/peps\/pep-0008\/\">PEP8<\/a> \u4e3a\u57fa\u7840\uff0c\u4fee\u6539\u4e86\u9648\u65e7\u7684\u89c4\u5219\uff0c\u4e30\u5bcc\u4e86\u793a\u4f8b\uff0c\u5e76\u6574\u7406\u4e86\u5de5\u4f5c\u4e2d\u5e38\u89c1\u7684\u4e0d\u89c4\u8303\u64cd\u4f5c\uff0c\u6700\u7ec8\u5f62\u6210\u6b64 Python \u7f16\u7801\u89c4\u8303\u4e0e\u98ce\u683c\u3002<\/p>\n<p>\u672c\u89c4\u8303\u9002\u7528\u4e8e\u6240\u6709\u4f7f\u7528 Python \u8bed\u8a00\u4f5c\u4e3a\u5f00\u53d1\u8bed\u8a00\u7684\u8f6f\u4ef6\u4ea7\u54c1\u3002<\/p>\n<p>\u7531\u4e8e Python2 \u5728 <a href=\"https:\/\/www.python.org\/doc\/sunset-python-2\/\">2020 \u5e74\u505c\u6b62\u7ef4\u62a4<\/a>\uff0c\u5efa\u8bae\u65b0\u589e\u7684\u9879\u76ee\u4f7f\u7528 Python3.6+\uff0c\u53ef\u4ee5\u4f7f\u7528\u5230\u66f4\u591a\u7684\u9ad8\u7ea7\u7279\u6027\u3002\u5982\u679c\u9879\u76ee\u6709\u517c\u5bb9\u6027\u9700\u6c42\u9700\u8981\u652f\u6301\u8001\u7248\u672c Python \u7684\uff0c\u90a3\u4e48\u4e0d\u6d89\u53ca\u7684\u7279\u6027\u53ef\u4ee5\u5ffd\u7565\u3002 \u672c\u89c4\u8303\u7684\u793a\u4f8b\u91c7\u7528\u7b26\u5408 Python3.6+ \u7684\u8bed\u6cd5\u3002<\/p>\n<ul>\n<li><span style=\"color: red\"><strong>\u5fc5\u987b\uff08Mandatory\uff09<\/strong><\/span>\uff1a\u7528\u6237\u5fc5\u987b\u91c7\u7528\uff1b<\/li>\n<li><span style=\"color: orange\"><strong>\u63a8\u8350\uff08Preferable\uff09<\/strong><\/span>\uff1a\u7528\u6237\u7406\u5e94\u91c7\u7528\uff0c\u4f46\u5982\u6709\u7279\u6b8a\u60c5\u51b5\uff0c\u53ef\u4ee5\u4e0d\u91c7\u7528\uff1b<\/li>\n<li><span style=\"color: blue\"><strong>\u53ef\u9009\uff08Optional\uff09<\/strong><\/span>\uff1a\u7528\u6237\u53ef\u53c2\u8003\uff0c\u81ea\u884c\u51b3\u5b9a\u662f\u5426\u91c7\u7528\uff1b<\/li>\n<\/ul>\n<p>\u672a\u660e\u786e\u6307\u660e\u7684\u5219\u9ed8\u8ba4\u4e3a <span style=\"color: red\"><strong>\u5fc5\u987b\uff08Mandatory\uff09<\/strong><\/span>\u3002<\/p>\n<h4><span class=\"ez-toc-section\" id=\"%E4%B8%80%E3%80%81%E7%BC%96%E7%A0%81%E9%A3%8E%E6%A0%BC\"><\/span>\u4e00\u3001\u7f16\u7801\u98ce\u683c<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<p>\u89c4\u8303\u5730\u4ee3\u7801\u5e03\u5c40\u6709\u52a9\u4e8e\u5e2e\u52a9\u5f00\u53d1\u8005\u66f4\u5bb9\u6613\u5730\u7406\u89e3\u4e1a\u52a1\u903b\u8f91\u3002<\/p>\n<h5><span class=\"ez-toc-section\" id=\"11_%E7%BC%A9%E8%BF%9B\"><\/span>1.1 \u7f29\u8fdb<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.1.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5bf9\u4e8e\u6bcf\u7ea7\u7f29\u8fdb\uff0c\u7edf\u4e00\u8981\u6c42\u4f7f\u75284\u4e2a <kbd>\u7a7a\u683c<\/kbd> \uff0c\u800c\u975e <kbd>tab<\/kbd> \u952e\u3002 pylint:<code>bad-indentation<\/code>.<\/p>\n<p>1.1.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7eed\u884c\uff0c\u8981\u6c42\u4f7f\u7528\u62ec\u53f7\u7b49\u5b9a\u9650\u754c\u7b26\uff0c\u5e76\u4e14\u9700\u8981\u5782\u76f4\u5bf9\u9f50\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u4e0e\u5b9a\u754c\uff08\u62ec\u53f7\uff09\u7b26\u5bf9\u9f50\nfoo = long_function_name(var_one, var_two,\n                         var_three, var_four)\n\n# \u6362\u884c\u5e76\u589e\u52a04\u4e2a\u989d\u5916\u7684\u7a7a\u683c\uff08\u4e00\u7ea7\u7f29\u8fdb\uff09\ndef long_function_name(\n        var_one, var_two, var_three,\n        var_four):\n    print(var_one)\n\n# \u60ac\u6302\u9700\u8981\u589e\u52a0\u4e00\u7ea7\u7f29\u8fdb\nfoo = long_function_name(\n    var_one, var_two,\n    var_three, var_four)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">\n# \u5f53\u4e0d\u4f7f\u7528\u5782\u76f4\u5bf9\u9f50\u65f6\uff0c\u7b2c\u4e00\u884c\u4e0d\u5141\u8bb8\u52a0\u53c2\u6570\nfoo = long_function_name(var_one, var_two,\n    var_three, var_four)\n\n# \u4e0b\u9762\u8fd9\u79cd\u60c5\u51b5\uff0c\u9700\u8981\u589e\u52a0\u989d\u5916\u7684\u7f29\u8fdb\uff0c\u5426\u5219\u65e0\u6cd5\u533a\u5206\u4ee3\u7801\u6240\u5728\u7684\u7f29\u8fdb\u7ea7\u522b\ndef long_function_name(\n    var_one, var_two, var_three,\n    var_four):\n    print(var_one)\n<\/code><\/pre>\n<p>1.1.3 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5982\u679c\u5305\u542b\u5b9a\u754c\u7b26\uff08\u62ec\u53f7\uff0c\u4e2d\u62ec\u53f7\uff0c\u5927\u62ec\u53f7\uff09\u7684\u8868\u8fbe\u5f0f\u8de8\u8d8a\u591a\u884c\uff0c\u90a3\u4e48\u5b9a\u754c\u7b26\u7684\u6269\u56de\u7b26\uff0c \u53ef\u4ee5\u653e\u7f6e\u4e0e\u6700\u540e\u4e00\u884c\u7684\u975e\u7a7a\u5b57\u7b26\u5bf9\u9f50\u6216\u8005\u4e0e\u6784\u9020\u591a\u884c\u7684\u5f00\u59cb\u7b2c\u4e00\u4e2a\u5b57\u7b26\u5bf9\u9f50\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u4e0e\u6700\u540e\u4e00\u884c\u7684\u975e\u7a7a\u5b57\u7b26\u5bf9\u9f50\nmy_list = [\n    1, 2, 3,\n    4, 5, 6,\n    ]\nresult = some_function_that_takes_arguments(\n    &#039;a&#039;, &#039;b&#039;, &#039;c&#039;,\n    &#039;d&#039;, &#039;e&#039;, &#039;f&#039;,\n    )\n\n# \u6216\u8005\u4e0e\u5f00\u59cb\u6784\u9020\u591a\u884c\u7684\u7b2c\u4e00\u4e2a\u5b57\u7b26\u5bf9\u9f50\nmy_list = [\n    1, 2, 3,\n    4, 5, 6,\n]\nresult = some_function_that_takes_arguments(\n    &#039;a&#039;, &#039;b&#039;, &#039;c&#039;,\n    &#039;d&#039;, &#039;e&#039;, &#039;f&#039;,\n)<\/code><\/pre>\n<p>1.1.4 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5bf9\u4e8e\u4f1a\u7ecf\u5e38\u6539\u52a8\u7684\u51fd\u6570\u53c2\u6570\u3001\u5217\u8868\u3001\u5b57\u5178\u5b9a\u4e49\uff0c\u5efa\u8bae\u6bcf\u884c\u4e00\u4e2a\u5143\u7d20\uff0c\u5e76\u4e14\u6bcf\u884c\u589e\u52a0\u4e00\u4e2a<code>,<\/code> \u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">yes = (&#039;y&#039;, &#039;Y&#039;, &#039;yes&#039;, &#039;TRUE&#039;, &#039;True&#039;, &#039;true&#039;, &#039;On&#039;, &#039;on&#039;, &#039;1&#039;)  # \u57fa\u672c\u4e0d\u518d\u6539\u53d8\n\nkwlist = [\n    &#039;False&#039;,\n    &#039;None&#039;,\n    &#039;True&#039;,\n    &#039;and&#039;,\n    &#039;as&#039;,\n    &#039;assert&#039;,\n    ...\n    &#039;yield&#039;,  # \u6700\u540e\u4e00\u4e2a\u5143\u7d20\u4e5f\u589e\u52a0\u4e00\u4e2a\u9017\u53f7 \uff0c\u65b9\u4fbf\u4ee5\u540ediff\u4e0d\u663e\u793a\u6b64\u884c\n]\n\nperson = {\n    &#039;name&#039;: &#039;bob&#039;,\n    &#039;age&#039;: 12,      # \u53ef\u80fd\u7ecf\u5e38\u589e\u52a0\u5b57\u6bb5\n}<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u5173\u952e\u5b57\u4f1a\u4e0d\u65ad\u589e\u52a0\uff0c\u6bcf\u4e2a\u5143\u7d20\u90fd\u6362\u884c\nkwlist = [&#039;False&#039;, &#039;None&#039;, &#039;True&#039;, &#039;and&#039;, &#039;as&#039;,\n          &#039;assert&#039;, &#039;async&#039;, ...\n]\n\nperson = {&#039;name&#039;: &#039;bob&#039;, &#039;age&#039;: 12}<\/code><\/pre>\n<p>1.1.5 <span style=\"color:blue\"><strong>\u3010\u53ef\u9009\u3011<\/strong><\/span> \u5bf9\u4e8e if \u5224\u65ad\uff0c\u4e00\u822c\u6765\u8bf4\u5c3d\u91cf\u4e0d\u8981\u653e\u7f6e\u8fc7\u591a\u7684\u5224\u65ad\u6761\u4ef6\u3002\u6362\u884c\u65f6\u589e\u52a0 4 \u4e2a\u989d\u5916\u7684\u7a7a\u683c\u3002 pycodestyle:<code>E129 visually indented line with same indent as next logical line<\/code>.<\/p>\n<blockquote>\n<p>\u5907\u6ce8\uff1aPEP8\u6ca1\u6709\u660e\u786e\u89c4\u5b9a\uff0c\u4ee5\u4e0b\u51e0\u79cd\u90fd\u662f\u5141\u8bb8\u7684\u3002\u5efa\u8bae\u4f7f\u7528\u524d\u97622\u79cd\u65b9\u6cd5\uff0c\u540e2\u79cd\u4f1a\u4e0e\u5df2\u6709\u7684\u5f00\u6e90\u5de5\u5177\u51b2\u7a81\u3002<\/p>\n<\/blockquote>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u66f4\u63a8\u8350\uff1a\u5728\u7eed\u884c\u4e2d\uff0c\u589e\u52a0\u989d\u5916\u7684\u7f29\u8fdb\u7ea7\u522b\u3002\u5141\u8bb8 and \u64cd\u4f5c\u7b26\u5728\u524d\nif (this_is_one_thing\n        and that_is_another_thing):\n    do_something()\n\n# \u66f4\u63a8\u8350\uff1a\u5728\u7eed\u884c\u4e2d\uff0c\u589e\u52a0\u989d\u5916\u7684\u7f29\u8fdb\u7ea7\u522b\nif (this_is_one_thing and\n        that_is_another_thing):\n    do_something()\n\n# \u5141\u8bb8\uff1a\u4e0e\u5b9a\u754c\u7b26\uff08\u62ec\u53f7\uff09\u5bf9\u9f50\uff0c\u4e0d\u9700\u8981\u989d\u5916\u7684\u7f29\u8fdb\nif (this_is_one_thing and\n    that_is_another_thing):\n    do_something()\n\n# \u5141\u8bb8\uff1a\u589e\u52a0\u6ce8\u91ca\uff0c\u7f16\u8f91\u5668\u4f1a\u63d0\u793a\u8bed\u6cd5\u9ad8\u4eae\uff0c\u6709\u52a9\u4e8e\u533a\u5206\nif (this_is_one_thing and\n    that_is_another_thing):\n    # Since both conditions are true, we can frobnicate.\n    do_something()<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"12_%E6%AF%8F%E8%A1%8C%E6%9C%80%E5%A4%A7%E9%95%BF%E5%BA%A6\"><\/span>1.2 \u6bcf\u884c\u6700\u5927\u957f\u5ea6<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.2.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6bcf\u884c\u6700\u591a\u4e0d\u8d85\u8fc7<code>120<\/code>\u4e2a\u5b57\u7b26\u3002\u6bcf\u884c\u4ee3\u7801\u6700\u5927\u957f\u5ea6\u9650\u5236\u7684\u6839\u672c\u539f\u56e0\u662f\u8fc7\u957f\u7684\u884c\u4f1a\u5bfc\u81f4\u9605\u8bfb\u969c\u788d\uff0c\u4f7f\u5f97\u7f29\u8fdb\u5931\u6548\u3002 pylint:<code>line-too-long<\/code>.<\/p>\n<p>\u9664\u4e86\u4ee5\u4e0b\u4e24\u79cd\u60c5\u51b5\u4f8b\u5916\uff1a<\/p>\n<ol>\n<li>\u5bfc\u5165\u6a21\u5757\u8bed\u53e5\u3002<\/li>\n<li>\u6ce8\u91ca\u4e2d\u5305\u542b\u7684URL\u3002<\/li>\n<\/ol>\n<p>\u5982\u679c\u9700\u8981\u4e00\u4e2a\u957f\u7684\u5b57\u7b26\u4e32\uff0c\u53ef\u4ee5\u7528\u62ec\u53f7\u5b9e\u73b0\u9690\u5f62\u8fde\u63a5\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x = (&#039;This will build a very long long &#039;\n     &#039;long long long long long long string&#039;)<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"13_%E7%A9%BA%E7%99%BD%E7%AC%A6\"><\/span>1.3 \u7a7a\u767d\u7b26<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.3.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5728\u8868\u8fbe\u5f0f\u7684\u8d4b\u503c\u7b26\u53f7\u3001\u64cd\u4f5c\u7b26\u5de6\u53f3\u81f3\u5c11\u6709\u4e00\u4e2a\u7a7a\u683c\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x = y + 1<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x=y+1\nx = y+1<\/code><\/pre>\n<p>1.3.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7981\u6b62\u884c\u5c3e\u7a7a\u767d\u3002 pylint:<code>trailing-whitespace<\/code>.<\/p>\n<p>\u884c\u5c3e\u7a7a\u767d\u867d\u7136\u4e0d\u4f1a\u9020\u6210\u529f\u80fd\u6027\u5f02\u5e38\uff0c\u4f46\u662f\u8fd9\u4e9b\u7a7a\u767d\u5b57\u7b26\u4f1a\u88ab\u6e90\u7801\u7ba1\u7406\u7cfb\u7edf\u6807\u8bb0\u51fa\u6765\u663e\u793a\u4e3a\u5dee\u5f02\uff0c\u5bf9\u5f00\u53d1\u4eba\u5458\u9020\u6210\u56f0\u607c\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-diff\"># YES: \u5c3e\u90e8\u6ca1\u6709\u7a7a\u767d\u7b26\u53f7\n+ para = {}\n+ para = {}  # comment<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-diff\"># No: \u7ed3\u5c3e\u5b58\u5728\u591a\u4f59\u7a7a\u767d\u7b26\u53f7\n- para = {}\u2022\u2022\u2022\u2022\u2022\n- para = {}  # comment\u2022\u2022\u2022\u2022\u2022\u2022<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"14_%E6%93%8D%E4%BD%9C%E7%AC%A6\"><\/span>1.4 \u64cd\u4f5c\u7b26<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.4.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> Python \u6ca1\u6709\u4e09\u76ee\u64cd\u4f5c\u7b26\uff0c\u5bf9\u4e8e\u4e8c\u76ee\u64cd\u4f5c\u7b26\u6765\u8bf4\uff0c\u64cd\u4f5c\u7b26\u5141\u8bb8\u5728\u6362\u884c\u7b26\u4e4b\u540e\u51fa\u73b0\u3002<\/p>\n<blockquote>\n<p>\u5907\u6ce8\uff1apycodestyle \u5de5\u5177\u4e0e\u6b64\u6761\u76ee\u76f8\u53cd\uff0cPEP8 \u63a8\u8350\u64cd\u4f5c\u7b26\u5728\u8fd9\u4e4b\u524d\uff0c\u66f4\u5177\u5907\u53ef\u8bfb\u6027\u3002<a href=\"https:\/\/www.python.org\/dev\/peps\/pep-0008\/#should-a-line-break-before-or-after-a-binary-operator\">PEP8: Should a Line Break Before or After a Binary Operator?<\/a>\u3002 \u5c4f\u853d pycodestyle:<code>W503 line break before binary operator<\/code><\/p>\n<\/blockquote>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># YES: \u6613\u4e8e\u5c06\u8fd0\u7b97\u7b26\u4e0e\u64cd\u4f5c\u6570\u5339\u914d\uff0c\u53ef\u8bfb\u6027\u9ad8\nincome = (gross_wages\n          + taxable_interest\n          + (dividends - qualified_dividends)\n          - ira_deduction\n          - student_loan_interest)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># No: \u8fd0\u7b97\u7b26\u7684\u4f4d\u7f6e\u8fdc\u79bb\u5176\u64cd\u4f5c\u6570\nincome = (gross_wages +\n          taxable_interest +\n          (dividends - qualified_dividends) -\n          ira_deduction -\n          student_loan_interest)<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"15_%E6%8B%AC%E5%8F%B7\"><\/span>1.5 \u62ec\u53f7<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.5.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> tuple \u5143\u7ec4\u4e0d\u5141\u8bb8\u9017\u53f7\u7ed3\u5c3e\uff0c\u663e\u5f0f\u589e\u52a0\u62ec\u53f7\u89c4\u907f\u3002\u5373\u4f7f\u4e00\u4e2a\u5143\u7d20\u4e5f\u52a0\u4e0a\u62ec\u53f7\u3002 pylint:<code>trailing-comma-tuple<\/code>.<\/p>\n<p>\u884c\u5c3e\u7684\u9017\u53f7\u53ef\u80fd\u5bfc\u81f4\u672c\u6765\u8981\u5b9a\u4e49\u4e00\u4e2a\u7b80\u5355\u53d8\u91cf\uff0c\u7ed3\u679c\u53d8\u6210 tuple \u53d8\u91cf\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">trailingcomma = ([&#039;f&#039;],)\n\nreturn (1,)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">trailingcomma = [&#039;f&#039;],   # tuple\n\nreturn 1,<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"16_%E7%A9%BA%E8%A1%8C\"><\/span>1.6 \u7a7a\u884c<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.6.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6a21\u5757\u4e2d\u7684\u4e00\u7ea7\u51fd\u6570\u548c\u7c7b\u5b9a\u4e49\u4e4b\u95f4\uff0c\u9700\u8981<code>\u7a7a\u4e24\u884c<\/code>\u3002 pycodestyle:<code>E302 expected 2 blank lines<\/code>.<\/p>\n<p>1.6.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7c7b\u4e2d\u51fd\u6570\u5b9a\u4e49\u4e4b\u95f4\uff0c<code>\u7a7a\u4e00\u884c<\/code>\u3002 pycodestyle:<code>E302 expected 1 blank line<\/code>.<\/p>\n<p>1.6.3 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6e90\u6587\u4ef6\u987b\u4f7f\u7528\u4e14\u4ec5\u4f7f\u7528 <code>\u4e00\u4e2a\u6362\u884c\u7b26<\/code> \u4f5c\u4e3a\u7ed3\u5c3e\u3002 pylint:<code>missing-final-newline<\/code>, <code>trailing-newlines<\/code>.<\/p>\n<p>1.6.4 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u901a\u5e38\u6bcf\u4e2a\u8bed\u53e5\u5e94\u8be5\u72ec\u5360\u4e00\u884c\u3002 pylint:<code>multiple-statements<\/code>.<\/p>\n<p>\u5982\u679c\u6d4b\u8bd5\u7ed3\u679c\u4e0e\u6d4b\u8bd5\u8bed\u53e5\u5728\u4e00\u884c\u653e\u5f97\u4e0b\uff0c\u4f60\u4e5f\u53ef\u4ee5\u5c06\u5b83\u4eec\u653e\u5728\u540c\u4e00\u884c\u3002 \u5982\u679c\u662f<code>if<\/code>\u8bed\u53e5, \u53ea\u6709\u5728\u6ca1\u6709<code>else<\/code>\u65f6\u624d\u80fd\u8fd9\u6837\u505a\u3002 \u7279\u522b\u5730\uff0c\u7edd\u4e0d\u8981\u5bf9 <code>try<\/code>\/<code>except<\/code> \u8fd9\u6837\u505a\uff0c\u56e0\u4e3a<code>try<\/code>\u548c<code>except<\/code>\u4e0d\u80fd\u653e\u5728\u540c\u4e00\u884c\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if foo:\n    bar(foo)\nelse:\n    baz(foo)\n\ntry:\n    bar(foo)\nexcept ValueError:\n    baz(foo)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if foo: bar(foo)\nelse:   baz(foo)\n\ntry:               bar(foo)\nexcept ValueError: baz(foo)\n\ntry:\n  bar(foo)\nexcept ValueError: baz(foo)<\/code><\/pre>\n<p>1.6.5 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u53ef\u4ee5\u5728\u4ee3\u7801\u6bb5\u4e2d\u7684<code>\u7a7a\u4e00\u884c<\/code>\u6765\u533a\u5206\u4e0d\u540c\u4e1a\u52a1\u903b\u8f91\u5757\u3002<\/p>\n<pre><code class=\"language-python\">&quot;&quot;&quot;This is the example module.\n\nThis module does stuff.\n&quot;&quot;&quot;\n\nimport os\n\ndef foo():\n    pass\n\nclass MyClass():\n\n    def __init__(self):\n        pass\n\n    def foo(self):\n        pass\n\nclass AnotherClass(object):\n    &quot;&quot;&quot;Another class.\n\n    This is some comments for another class\n    &quot;&quot;&quot;\n\n    def __init__(self,\n                 a,\n                 b):\n        if a &gt; b:\n            self._min = b\n            self._max = a\n\n        else:\n            self._min = a\n            self._max = b\n\n        self._gap = self._max = self._min\n\n    def foo(self):\n        pass\n<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"17_%E6%BA%90%E6%96%87%E4%BB%B6%E7%BC%96%E7%A0%81\"><\/span>1.7 \u6e90\u6587\u4ef6\u7f16\u7801<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.7.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6e90\u6587\u4ef6\u7f16\u7801\u9700\u7edf\u4e00\u4f7f\u7528 <code>UTF-8<\/code> \u7f16\u7801\uff0c\u4ee5\u4e0b\u5185\u5bb9\u9700\u8981\u589e\u52a0\u5230\u6bcf\u4e00\u4e2apython\u6587\u4ef6\u7684\u5934\u90e8\u3002<\/p>\n<pre><code class=\"language-python\"># -*- coding: utf-8 -*-<\/code><\/pre>\n<p>1.7.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> <strong>\u907f\u514d\u4e0d\u540c\u64cd\u4f5c\u7cfb\u7edf\u5bf9\u6587\u4ef6\u6362\u884c\u5904\u7406\u7684\u65b9\u5f0f\u4e0d\u540c\uff0c\u4e00\u5f8b\u4f7f\u7528<code>LF<\/code><\/strong>\u3002 pylint:<code>mixed-line-endings<\/code>, <code>unexpected-line-ending-format<\/code>.<\/p>\n<h5><span class=\"ez-toc-section\" id=\"18_Shebang\"><\/span>1.8 Shebang<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.8.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7a0b\u5e8f\u7684main\u6587\u4ef6\u5e94\u8be5\u4ee5 <code>#!\/usr\/bin\/env python2<\/code> \u6216\u8005 <code>#!\/usr\/bin\/env python3<\/code> \u5f00\u59cb\uff0c \u53ef\u4ee5\u540c\u65f6\u652f\u6301Python2\u3001Python3\u7684<code>#!\/usr\/bin\/env python<\/code>\u3002<\/p>\n<p>\u975e\u7a0b\u5e8f\u5165\u53e3\u7684\u6587\u4ef6\u4e0d\u5e94\u8be5\u51fa\u73b0 Shebang \u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">#!\/usr\/bin\/env python3\n# -*- coding: utf-8 -*-\n#<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"19_%E6%A8%A1%E5%9D%97%E5%BC%95%E7%94%A8import\"><\/span>1.9 \u6a21\u5757\u5f15\u7528(import)<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.9.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6bcf\u4e2a\u5bfc\u5165\u5e94\u8be5\u72ec\u5360\u4e00\u884c\u3002 pylint:<code>multiple-imports<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import os\nimport sys<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import os, sys<\/code><\/pre>\n<p>1.9.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5bfc\u5165\u603b\u5e94\u8be5\u653e\u5728\u6587\u4ef6\u9876\u90e8\uff0c\u4f4d\u4e8e\u6a21\u5757\u6ce8\u91ca\u548c\u6587\u6863\u5b57\u7b26\u4e32\u4e4b\u540e\uff0c\u6a21\u5757\u5168\u5c40\u53d8\u91cf\u548c\u5e38\u91cf\u4e4b\u524d\u3002 pylint:<code>wrong-import-order<\/code>.<\/p>\n<p>\u5bfc\u5165\u5e94\u8be5\u6309\u7167\u4ece\u6700\u901a\u7528\u5230\u6700\u4e0d\u901a\u7528\u7684\u987a\u5e8f\u5206\u7ec4, \u6bcf\u4e2a\u5206\u7ec4\u4e4b\u95f4\uff0c\u9700\u8981\u7a7a\u4e00\u884c:<\/p>\n<ul>\n<li>\u6807\u51c6\u5e93\u5bfc\u5165<\/li>\n<li>\u7b2c\u4e09\u65b9\u5e93\u5bfc\u5165<\/li>\n<li>\u672c\u5730\u5bfc\u5165<\/li>\n<\/ul>\n<p>\u6bcf\u79cd\u5206\u7ec4\u4e2d\uff0c\u5efa\u8bae\u6bcf\u4e2a\u6a21\u5757\u7684\u5b8c\u6574\u5305\u8def\u5f84\u6309 <strong><em>\u5b57\u5178\u5e8f<\/em><\/strong> \u6392\u5e8f\uff0c\u5e76\u5ffd\u7565\u5927\u5c0f\u5199\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import foo\nfrom foo import bar\nfrom foo.bar import baz\nfrom foo.bar import Quux\nfrom Foob import ar<\/code><\/pre>\n<p>1.9.3 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u907f\u514d\u4f7f\u7528 <code>from &lt;module&gt; import *<\/code>\uff0c\u56e0\u4e3a\u53ef\u80fd\u4f1a\u9020\u6210\u547d\u540d\u7a7a\u95f4\u7684\u6c61\u67d3\u3002 pylint:<code>wildcard-import<\/code>.<\/p>\n<p>1.9.4 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7981\u6b62\u5bfc\u5165\u4e86\u6a21\u5757\u5374\u4e0d\u4f7f\u7528\u5b83\u3002 pylint:<code>unused-import<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import os  # used\n\ndir_path = os.path.abspath(&#039;.&#039;)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import os   # unused !\n\n# dir_path = os.path.abspath(&#039;.&#039;)<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"110_%E6%A8%A1%E5%9D%97%E4%B8%AD%E7%9A%84%E9%AD%94%E6%9C%AF%E5%8F%98%E9%87%8Fdunders\"><\/span>1.10 \u6a21\u5757\u4e2d\u7684\u9b54\u672f\u53d8\u91cf(dunders)<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.10.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5bf9\u4e8e\u4e24\u4e2a <code>_<\/code>  \u5f00\u5934\u548c\u4e24\u4e2a <code>_<\/code> \u7ed3\u5c3e\u7684\u53d8\u91cf\uff0c \u5982 <code>__all__<\/code>\uff0c<code>__author__<\/code>\uff0c<code>__version__<\/code>\u7b49\uff0c\u5e94\u8be5\u653e\u5728\u6a21\u5757\u6587\u6863\u4e4b\u540e\uff0c \u5176\u4ed6\u6a21\u5757\u5bfc\u5165\u4e4b\u524d\uff08<code>__future__<\/code> \u9664\u5916\uff09\u3002<\/p>\n<p>1.10.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> Python \u8981\u6c42 <code>future<\/code> \u5bfc\u5165\u5fc5\u987b\u51fa\u73b0\u5728\u5176\u4ed6\u6a21\u5757\u5bfc\u5165\u4e4b\u524d\u3002 pylint:<code>misplaced-future<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># -*- coding: utf-8 -*-\n#\n# Copyright @ 2020 Tencent.com\n\n&quot;&quot;&quot;This is the example module.\n\nThis module does stuff.\n&quot;&quot;&quot;\n\nfrom __future__ import barry_as_FLUFL\n\n__all__ = [&#039;a&#039;, &#039;b&#039;, &#039;c&#039;]\n__version__ = &#039;0.1&#039;\n__author__ = &#039;Cardinal Biggles&#039;\n\nimport os\nimport sys<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"111_%E6%B3%A8%E9%87%8A\"><\/span>1.11 \u6ce8\u91ca<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<blockquote>\n<p>\u6709\u6548\u7684\u6ce8\u91ca\u6709\u52a9\u4e8e\u5e2e\u52a9\u5f00\u53d1\u8005\u66f4\u5feb\u5730\u7406\u89e3\u4ee3\u7801\uff0c\u6a21\u5757\uff0c\u51fd\u6570\uff0c\u65b9\u6cd5\uff0c\u4ee5\u53ca\u884c\u5185\u6ce8\u91ca\u7684\u90fd\u6709\u5404\u81ea\u7684\u98ce\u683c\u3002<\/p>\n<\/blockquote>\n<p>1.11.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6240\u6709<code>#<\/code>\u5f00\u5934\u7684\u6ce8\u91ca\uff0c\u5fc5\u987b\u4e0e\u6240\u5728\u7684\u4ee3\u7801\u5757\u540c\u7ea7\uff0c\u5e76\u7f6e\u653e\u5728\u4ee3\u7801\u4e4b\u4e0a\u3002 pycodestyle:<code>E262 inline comment should start with &#039;# &#039;<\/code>.<\/p>\n<p>1.11.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6ce8\u91ca\u7684\u6bcf\u4e00\u884c\u90fd\u5e94\u8be5\u4ee5<code>#<\/code>\u548c\u4e00\u4e2a\u7a7a\u683c\u5f00\u5934\u3002 pycodestyle:<code>E266 too many leading &#039;#&#039; for block comment<\/code>, <code>E262 inline comment should start with &#039;# &#039;<\/code>.<\/p>\n<p>1.11.3 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u884c\u5185\u6ce8\u91ca<code>#<\/code>\u4e0e\u4ee3\u7801\u79bb\u5f00\u81f3\u5c112\u4e2a\u7a7a\u683c\u3002 pycodestyle:<code>E261 at least two spaces before inline comment<\/code>.<\/p>\n<p>1.11.4 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5757\u6ce8\u91ca\uff1a\u5bf9\u4e8e\u590d\u6742\u7684\u64cd\u4f5c\uff0c\u53ef\u4ee5\u5728\u4ee3\u7801\u4e4b\u524d\u5199\u82e5\u5e72\u884c\u6ce8\u91ca\uff0c\u5bf9\u7b80\u5355\u7684\u4ee3\u7801\uff0c\u53ef\u4ee5\u653e\u5728\u884c\u5185\u3002\u4e0e\u4ee3\u7801\u79bb\u5f00\u81f3\u5c112\u4e2a\u7a7a\u683c\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># this is a very complex operation, please\n# read this carefully\n\nif i &amp; (i-1) == 0:\n    # do my job ...\n\n# \u5355\u884c\u6ce8\u91ca\uff0c\u4e3a\u53ef\u8bfb\u6027\uff0c\u81f3\u5c11\u79bb\u5f00\u4ee3\u78012\u4e2a\u7a7a\u683c\nx = x + 1                 # Compensate for border<\/code><\/pre>\n<p>1.11.5 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> TODO \u6ce8\u91ca\u9700\u8981\u52a0\u4e0a\u540d\u5b57\u3002<\/p>\n<p>TODO\u6ce8\u91ca\u5e94\u8be5\u5728\u6240\u6709\u5f00\u5934\u5904\u5305\u542b<code>TODO<\/code>\u5b57\u7b26\u4e32\uff0c\u7d27\u8ddf\u7740\u662f\u7528\u62ec\u53f7\u62ec\u8d77\u6765\u7684\u4f60\u7684\u540d\u5b57\uff0c email\u5730\u5740\u6216\u5176\u5b83\u6807\u8bc6\u7b26\uff0c\u7136\u540e\u662f\u4e00\u4e2a\u53ef\u9009\u7684\u5192\u53f7\u3002 \u63a5\u7740\u5fc5\u987b\u6709\u4e00\u884c\u6ce8\u91ca\uff0c\u89e3\u91ca\u8981\u505a\u4ec0\u4e48\u3002 \u4e3b\u8981\u76ee\u7684\u662f\u4e3a\u4e86\u6709\u4e00\u4e2a\u7edf\u4e00\u7684TODO\u683c\u5f0f\uff0c\u8fd9\u6837\u6dfb\u52a0\u6ce8\u91ca\u7684\u4eba\u5c31\u53ef\u4ee5\u641c\u7d22\u5230(\u5e76\u53ef\u4ee5\u6309\u9700\u63d0\u4f9b\u66f4\u591a\u7ec6\u8282)\u3002 \u5199\u4e86TODO\u6ce8\u91ca\u5e76\u4e0d\u4fdd\u8bc1\u5199\u7684\u4eba\u4f1a\u4eb2\u81ea\u89e3\u51b3\u95ee\u9898\u3002 \u5f53\u4f60\u5199\u4e86\u4e00\u4e2aTODO\uff0c\u8bf7\u6ce8\u4e0a\u4f60\u7684\u540d\u5b57\u3002<\/p>\n<blockquote>\n<p>\u4e3a\u4e34\u65f6\u4ee3\u7801\u4f7f\u7528TODO\u6ce8\u91ca, \u5b83\u662f\u4e00\u79cd\u77ed\u671f\u89e3\u51b3\u65b9\u6848\u3002\u5e38\u89c1\u7684IDE\u5728\u63d0\u4ea4\u4ee3\u7801\u65f6\uff0c \u4f1a\u68c0\u67e5\u53d8\u66f4\u4e2d\u5305\u542b\u4e86TODO\u5e76\u63d0\u9192\u5f00\u53d1\u8005\uff0c\u9632\u6b62\u63d0\u4ea4\u662f\u5fd8\u8bb0\u8fd8\u6709\u672a\u5b8c\u6210\u7684\u4ee3\u7801\u3002<br \/>\n\u5982\u679cTODO\u662f<code>\u5c06\u6765\u505a\u67d0\u4e8b<\/code>\u7684\u5f62\u5f0f, \u90a3\u4e48\u8bf7\u786e\u4fdd\u5305\u542b\u4e00\u4e2a\u6307\u5b9a\u7684\u65e5\u671f\u6216\u8005\u4e00\u4e2a\u7279\u5b9a\u7684\u4e8b\u4ef6\uff08\u6761\u4ef6\uff09\u3002<br \/>\n\u76f8\u540c\u5730\uff0c\u4e5f\u53ef\u4ee5\u7559\u4e0b<code>FIXME<\/code>, <code>NOTES<\/code> \u6ce8\u91ca\u3002<\/p>\n<\/blockquote>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># TODO(zhangsan): Change this to use relations.\n# FIXME(zhangsan@xx.com): Please fix me here.\n# NOTES(zhangsan): This is some notes.<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"112_%E6%96%87%E6%A1%A3%E5%AD%97%E7%AC%A6%E4%B8%B2\"><\/span>1.12 \u6587\u6863\u5b57\u7b26\u4e32<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>Docstring \u6587\u6863\u5b57\u7b26\u4e32\u63d0\u4f9b\u4e86\u5c06\u6587\u6863\u4e0e Python \u6a21\u5757\uff0c\u51fd\u6570\uff0c\u7c7b\u548c\u65b9\u6cd5\u76f8\u5173\u8054\u7684\u4fbf\u6377\u65b9\u6cd5\u3002<\/p>\n<pre><code class=\"language-python\">def foobar():\n    &quot;&quot;&quot;Return a foobang\n\n    Optional plotz says to frobnicate the bizbaz first.\n    &quot;&quot;&quot;<\/code><\/pre>\n<p><a href=\"https:\/\/www.python.org\/dev\/peps\/pep-0257\/\">PEP 257<\/a> \u5168\u9762\u63cf\u8ff0\u4e86\u6587\u6863\u5b57\u7b26\u4e32\u7684\u98ce\u683c\u3002<\/p>\n<p>1.12.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u9700\u5bf9\u5916\u53d1\u5e03\u7684public \u6a21\u5757\uff0c\u51fd\u6570\uff0c\u7c7b\uff0c\u65b9\u6cd5\u7b49\u9700\u8981\u5305\u542b\u6587\u6863\u5b57\u7b26\u4e32\u3002\u5185\u90e8\u4f7f\u7528\u7684\u65b9\u6cd5\uff0c\u51fd\u6570\u7b49\uff0c\u8981\u6c42\u4f7f\u7528\u7b80\u5355\u7684\u6ce8\u91ca\u63cf\u8ff0\u529f\u80fd\u3002 pylint:<code>missing-module-docstring<\/code>, <code>missing-class-docstring<\/code>, <code>missing-function-docstring<\/code>.<\/p>\n<p>\u4e00\u4e2a\u51fd\u6570\u6216\u65b9\u6cd5\uff0c\u5982\u679c\u53ef\u4ee5\u76f4\u63a5\u88ab\u5176\u4ed6\u5f00\u53d1\u8005\u4f7f\u7528\uff0c\u9700\u8981\u63d0\u4f9b\u6587\u6863\u660e\u786e\u5176\u542b\u4e49\uff0c\u9700\u8981\u6307\u51fa\u8f93\u5165\uff0c\u8f93\u51fa\uff0c\u4ee5\u53ca\u5f02\u5e38\u5185\u5bb9\u3002<\/p>\n<p>1.12.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7b2c\u4e00\u884c\u5e94\u4e3a\u6587\u6863\u540d\uff0c\u7a7a\u4e00\u884c\u540e\uff0c\u8f93\u5165\u6587\u6863\u63cf\u8ff0\u3002<\/p>\n<p>1.12.3 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5728\u4f7f\u7528\u6587\u6863\u5b57\u7b26\u4e32\u65f6\uff0c\u63a8\u8350\u4f7f\u7528 <code>reStructuredText<\/code> \u98ce\u683c\u7c7b\u578b\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def fetch_bigtable_rows(big_table, keys, other_silly_variable=None):\n    &quot;&quot;&quot;Fetches rows from a Bigtable.\n\n    Retrieves rows pertaining to the given keys from the Table instance\n    represented by big_table.  Silly things may happen if\n    other_silly_variable is not None.\n\n    :param big_table: An open Bigtable Table instance.\n    :param keys: A sequence of strings representing the key of each table row\n        to fetch.\n    :param other_silly_variable: Another optional variable, that has a much\n        longer name than the other args, and which does nothing.\n\n    :return: A dict mapping keys to the corresponding table row data\n        fetched. Each row is represented as a tuple of strings. For\n        example:\n\n        {&#039;Serak&#039;: (&#039;Rigel VII&#039;, &#039;Preparer&#039;),\n         &#039;Zim&#039;: (&#039;Irk&#039;, &#039;Invader&#039;),\n         &#039;Lrrr&#039;: (&#039;Omicron Persei 8&#039;, &#039;Emperor&#039;)}\n\n        If a key from the keys argument is missing from the dictionary,\n        then that row was not found in the table.\n\n    :raises ValueError: if `keys` is empty.\n    :raises IOError: An error occurred accessing the bigtable.Table object.\n    &quot;&quot;&quot;\n    pass<\/code><\/pre>\n<p>1.12.4 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u7c7b\u5e94\u8be5\u5728\u5176\u5b9a\u4e49\u4e0b\u6709\u4e00\u4e2a\u7528\u4e8e\u63cf\u8ff0\u8be5\u7c7b\u7684\u6587\u6863\u5b57\u7b26\u4e32\u3002 \u5982\u679c\u7c7b\u6709\u516c\u5171\u5c5e\u6027(Attributes)\uff0c\u90a3\u4e48\u6587\u6863\u4e2d\u5e94\u8be5\u6709\u4e00\u4e2a\u5c5e\u6027(Attributes)\u6bb5\uff0c \u5e76\u4e14\u5e94\u8be5\u9075\u5b88\u548c\u51fd\u6570\u53c2\u6570\u76f8\u540c\u7684\u683c\u5f0f\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">class SampleClass(object):\n    &quot;&quot;&quot;Summary of class here.\n\n    Longer class information....\n    Longer class information....\n\n    :ivar likes_spam: A boolean indicating if we like SPAM or not.\n    :ivar eggs: An integer count of the eggs we have laid.\n    &quot;&quot;&quot;\n\n    def __init__(self, likes_spam=False):\n        &quot;&quot;&quot;Inits SampleClass with blah.&quot;&quot;&quot;\n        self.likes_spam = likes_spam\n        self.eggs = 0\n\n    def public_method(self):\n        &quot;&quot;&quot;Performs operation blah.&quot;&quot;&quot;<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"113_%E7%B1%BB%E5%9E%8B%E6%8F%90%E7%A4%BA\"><\/span>1.13 \u7c7b\u578b\u63d0\u793a<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>Python \u662f\u52a8\u6001\u8bed\u8a00\uff0c\u5728\u8fd0\u884c\u65f6\u65e0\u9700\u6307\u5b9a\u53d8\u91cf\u7c7b\u578b\u3002<br \/>\n\u867d\u7136\u8fd0\u884c\u65f6\u4e0d\u4f1a\u6267\u884c\u51fd\u6570\u4e0e\u53d8\u91cf\u7c7b\u578b\u6ce8\u89e3\uff0c\u4f46\u7c7b\u578b\u63d0\u793a\u6709\u52a9\u4e8e\u9605\u8bfb\u4ee3\u7801\u3001\u91cd\u6784\u3001\u9759\u6001\u4ee3\u7801\u68c0\u67e5\u4e0eIDE\u7684\u8bed\u6cd5\u63d0\u793a\u3002<br \/>\n\u63a8\u8350\u5728\u9879\u76ee\u4e2d\u4f7f\u7528\u8be5\u7279\u6027\u3002<br \/>\n\u66f4\u591a\u4f7f\u7528\u53ef\u4ee5\u53c2\u8003 <a href=\"https:\/\/docs.python.org\/zh-cn\/3\/library\/typing.html\">\u7c7b\u578b\u6807\u6ce8\u652f\u6301<\/a>\u3002<\/p>\n<p>\u7c7b\u578b\u63d0\u793a\u793a\u4f8b\u4ee3\u7801<\/p>\n<pre><code class=\"language-python\">from typing import List\n\nclass Container(object):\n    def __init__(self) -&gt; None:\n        self.elements: List[int] = []\n\n    def append(self, element: int) -&gt; None:\n        self.elements.append(element)\n\ndef greeting(name: str) -&gt; str:\n    return &#039;Hello &#039; + name\n\n# \u53d8\u91cf\u5b9a\u4e49\nlang: str = &#039;zh&#039;\nsuccess_code: int = 0<\/code><\/pre>\n<p>1.13.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6a21\u5757\u7ea7\u53d8\u91cf\uff0c\u7c7b\u548c\u5b9e\u4f8b\u53d8\u91cf\u4ee5\u53ca\u5c40\u90e8\u53d8\u91cf\u7684\u6ce8\u91ca\u5e94\u5728\u5192\u53f7\u540e\u9762\u6709\u4e00\u4e2a\u7a7a\u683c\u3002 pycodestyle:<code>E231 missing whitespace after &#039;:&#039;<\/code>.<\/p>\n<p>1.13.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5192\u53f7\u524d\u4e0d\u5e94\u6709\u7a7a\u683c\u3002<\/p>\n<p>1.13.3 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5982\u679c\u6709\u8d4b\u503c\u7b26\uff0c\u5219\u7b49\u53f7\u5728\u4e24\u8fb9\u5e94\u6070\u597d\u6709\u4e00\u4e2a\u7a7a\u683c\u3002 pycodestyle:<code>E225 missing whitespace around operator<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">code: int = 10\n\nclass Point(object):\n    coords: Tuple[int, int] = (0, 0)\n    label: str = &#039;&lt;unknown&gt;&#039;\n\ndef broadcast(servers: Sequence[Server],\n              message: str = &#039;spaces around equality sign&#039;) -&gt; None:\n    pass<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">code:int  # No space after colon\ncode : int  # Space before colon\n\nclass Test(object):\n    result: int=0  # No spaces around equality sign<\/code><\/pre>\n<p>1.13.4 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5f53\u4f7f\u7528\u7c7b\u578b\u63d0\u793a\u51fa\u73b0\u5faa\u73af\u5f15\u7528\u65f6\uff0c\u53ef\u4ee5\u5728\u5bfc\u5165\u7684\u5934\u90e8\u4f7f\u7528 <code>if typing.TYPE_CHECKING<\/code> \uff0c \u4e14\u5bf9\u7c7b\u578b\u6ce8\u89e3\u4f7f\u7528<code>\u53cc\u5f15\u53f7<\/code>\u6216<code>\u5355\u5f15\u53f7<\/code>\u8fdb\u884c\u4fee\u9970\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">import typing\n\nif typing.TYPE_CHECKING:  # \u8fd0\u884c\u65f6\u4e0d\u5bfc\u5165\n    # For type annotation\n    from typing import Any, Dict, List, Sequence  # NOQA\n    from sphinx.application import Sphinx  # NOQA\n\nclass Parser(docutils.parsers.Parser):\n\n    def set_application(self, app: &quot;Sphinx&quot;) -&gt; None:  # \u540c\u65f6\u91c7\u7528\u5f15\u53f7\n        pass<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"114_%E5%AD%97%E7%AC%A6%E4%B8%B2\"><\/span>1.14 \u5b57\u7b26\u4e32<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.14.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5373\u4f7f\u53c2\u6570\u90fd\u662f\u5b57\u7b26\u4e32, \u4e5f\u8981\u4f7f\u7528%\u64cd\u4f5c\u7b26\u6216\u8005\u683c\u5f0f\u5316\u65b9\u6cd5\u683c\u5f0f\u5316\u5b57\u7b26\u4e32\u3002\u4e0d\u8fc7\u4e5f\u4e0d\u80fd\u4e00\u6982\u800c\u8bba, \u4f60\u9700\u8981\u5728+\u548c%\u4e4b\u95f4\u6743\u8861\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u66f4\u63a8\u8350\nx = f&#039;name: {name}; score: {n}&#039;  # Python3.6+ \u4ee5\u4e0a\u652f\u6301\nx = &#039;name: {name}; score: {n}&#039;.format(name=name, n=n)\nx = &#039;name: {name}; score: {n}&#039;.format(**{&quot;name&quot;: name, &quot;n&quot;: n})\nx = &#039;name: %(name)s; score: %(n)d&#039; % {&quot;name&quot;: name, &quot;n&quot;: n}\n\n# \u53ef\u63a5\u53d7\nx = &#039;%s, %s!&#039; % (imperative, expletive)\nx = &#039;{}, {}!&#039;.format(imperative, expletive)\nx = &#039;name: %s; score: %d&#039; % (name, n)\nx = &#039;name: {}; score: {}&#039;.format(name, n)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x = &#039;%s%s&#039; % (a, b)  # use + in this case\nx = &#039;{}{}&#039;.format(a, b)  # use + in this case\nx = imperative + &#039;, &#039; + expletive + &#039;!&#039;\nx = &#039;name: &#039; + name + &#039;; score: &#039; + str(n)<\/code><\/pre>\n<p>1.14.2 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u907f\u514d\u5728\u5faa\u73af\u4e2d\u7528<code>+<\/code>\u548c<code>+=<\/code>\u64cd\u4f5c\u7b26\u6765\u7d2f\u52a0\u5b57\u7b26\u4e32\u3002 \u7531\u4e8e\u5b57\u7b26\u4e32\u662f\u4e0d\u53ef\u53d8\u7684, \u8fd9\u6837\u505a\u4f1a\u521b\u5efa\u4e0d\u5fc5\u8981\u7684\u4e34\u65f6\u5bf9\u8c61, \u5e76\u4e14\u5bfc\u81f4\u4e8c\u6b21\u65b9\u800c\u4e0d\u662f\u7ebf\u6027\u7684\u8fd0\u884c\u65f6\u95f4\u3002 \u4f5c\u4e3a\u66ff\u4ee3\u65b9\u6848, \u4f60\u53ef\u4ee5\u5c06\u6bcf\u4e2a\u5b50\u4e32\u52a0\u5165\u5217\u8868, \u7136\u540e\u5728\u5faa\u73af\u7ed3\u675f\u540e\u7528 <code>.join<\/code> \u8fde\u63a5\u5217\u8868\u3002 (\u4e5f\u53ef\u4ee5\u5c06\u6bcf\u4e2a\u5b50\u4e32\u5199\u5165\u4e00\u4e2a io.StringIO \u7f13\u5b58\u4e2d\u3002) pylint:<code>consider-using-join<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">items = [&#039;&lt;table&gt;&#039;]\nfor last_name, first_name in employee_list:\n    items.append(&#039;&lt;tr&gt;&lt;td&gt;%s, %s&lt;\/td&gt;&lt;\/tr&gt;&#039; % (last_name, first_name))\nitems.append(&#039;&lt;\/table&gt;&#039;)\nemployee_table = &#039;&#039;.join(items)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">employee_table = &#039;&lt;table&gt;&#039;\nfor last_name, first_name in employee_list:\n    employee_table += &#039;&lt;tr&gt;&lt;td&gt;%s, %s&lt;\/td&gt;&lt;\/tr&gt;&#039; % (last_name, first_name)\nemployee_table += &#039;&lt;\/table&gt;&#039;<\/code><\/pre>\n<p>1.14.3 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5728\u540c\u4e00\u4e2a\u6587\u4ef6\u4e2d, \u4fdd\u6301\u4f7f\u7528\u5b57\u7b26\u4e32\u5f15\u53f7\u7684\u4e00\u81f4\u6027\u3002 \u4f7f\u7528\u5355\u5f15\u53f7<code>&#039;<\/code>\u6216\u8005\u53cc\u5f15\u53f7<code>&quot;<\/code>\u5f15\u7528\u5b57\u7b26\u4e32, \u5e76\u5728\u540c\u4e00\u6587\u4ef6\u4e2d\u4e00\u76f4\u6cbf\u7528\u8fd9\u79cd\u98ce\u683c\u3002 \u5f53\u5b57\u7b26\u4e32\u4e2d\u5305\u542b\u5355\u5f15\u53f7\u6216\u8005\u53cc\u5f15\u53f7\u65f6\uff0c\u4e3a\u63d0\u9ad8\u53ef\u8bfb\u6027\uff0c\u4f7f\u7528\u53e6\u5916\u4e00\u79cd\u5f15\u53f7\uff0c\u4ee3\u66ff\u8f6c\u4e49\u5b57\u7b26\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">Python(&#039;Why are you hiding your eyes?&#039;)\nGollum(&quot;I&#039;m scared of lint errors.&quot;)\nNarrator(&#039;&quot;Good!&quot; thought a happy Python reviewer.&#039;)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">Python(&quot;Why are you hiding your eyes?&quot;)\nGollum(&#039;The lint. It burns. It burns us.&#039;)\nGollum(&quot;Always the great lint. Watching. Watching.&quot;)<\/code><\/pre>\n<p>1.14.4 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5982\u679c\u8981\u5f15\u7528\u7684\u5b57\u7b26\u4e32\u4e3a\u591a\u884c\u65f6\uff0c\u9700\u8981\u4f7f\u7528\u53cc\u5f15\u53f7\u5f15\u7528\u5b57\u7b26\u4e32\u3002<\/p>\n<p>1.14.5 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6587\u6863\u5b57\u7b26\u4e32\uff08docstring\uff09\u5fc5\u987b\u4f7f\u7528\u4e09\u91cd\u53cc\u5f15\u53f7 <code>&quot;&quot;&quot;<\/code>\u3002<\/p>\n<p>1.14.6 <span style=\"color:blue\"><strong>\u3010\u53ef\u9009\u3011<\/strong><\/span> \u907f\u514d\u5728\u4ee3\u7801\u4e2d\u4f7f\u7528\u4e09\u91cd\u5f15\u53f7<code>&quot;&quot;&quot;<\/code>\uff0c\u56e0\u4e3a\u5f53\u4f7f\u7528\u4e09\u91cd\u5f15\u53f7\u65f6\uff0c\u7f29\u8fdb\u65b9\u5f0f\u4e0e\u5176\u4ed6\u90e8\u5206\u4e0d\u4e00\u81f4\uff0c\u5bb9\u6613\u5f15\u8d77\u8bef\u5bfc\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">print(&quot;This is much nicer.\\n&quot;\n      &quot;Do it this way.\\n&quot;)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">print(&quot;&quot;&quot;This is pretty ugly.\nDon&#039;t do this.\n&quot;&quot;&quot;)<\/code><\/pre>\n<p>1.14.7 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u68c0\u67e5\u524d\u7f00\u548c\u540e\u7f00\u65f6\uff0c\u4f7f\u7528 <code>.startswith()<\/code> \u548c <code>.endswith()<\/code> \u4ee3\u66ff\u5b57\u7b26\u4e32\u5207\u7247\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if foo.startswith(&#039;bar&#039;):<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if foo[:3] == &#039;bar&#039;:<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"115_%E6%96%87%E4%BB%B6%E5%92%8Csockets\"><\/span>1.15 \u6587\u4ef6\u548csockets<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>1.15.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5728\u6587\u4ef6\u548csockets\u7ed3\u675f\u65f6\uff0c\u663e\u5f0f\u7684\u5173\u95ed\u5b83\u3002<\/p>\n<p>\u9664\u6587\u4ef6\u5916\uff0c sockets\u6216\u5176\u4ed6\u7c7b\u4f3c\u6587\u4ef6\u7684\u5bf9\u8c61\u5728\u6ca1\u6709\u5fc5\u8981\u7684\u60c5\u51b5\u4e0b\u6253\u5f00\uff0c\u4f1a\u6709\u8bb8\u591a\u526f\u4f5c\u7528\uff0c\u4f8b\u5982\uff1a<\/p>\n<ol>\n<li>\u5b83\u4eec\u53ef\u80fd\u4f1a\u6d88\u8017\u6709\u9650\u7684\u7cfb\u7edf\u8d44\u6e90\uff0c\u5982\u6587\u4ef6\u63cf\u8ff0\u7b26\u3002 \u5982\u679c\u8fd9\u4e9b\u8d44\u6e90\u5728\u4f7f\u7528\u540e\u6ca1\u6709\u53ca\u65f6\u5f52\u8fd8\u7cfb\u7edf\uff0c\u90a3\u4e48\u7528\u4e8e\u5904\u7406\u8fd9\u4e9b\u5bf9\u8c61\u7684\u4ee3\u7801\u4f1a\u5c06\u8d44\u6e90\u6d88\u8017\u6b86\u5c3d\u3002<\/li>\n<li>\u6301\u6709\u6587\u4ef6\u5c06\u4f1a\u963b\u6b62\u5bf9\u4e8e\u6587\u4ef6\u7684\u5176\u4ed6\u8bf8\u5982\u79fb\u52a8\u3001\u5220\u9664\u4e4b\u7c7b\u7684\u64cd\u4f5c\u3002<\/li>\n<li>\u4ec5\u4ec5\u662f\u4ece\u903b\u8f91\u4e0a\u5173\u95ed\u6587\u4ef6\u548csockets\uff0c\u90a3\u4e48\u5b83\u4eec\u4ecd\u7136\u53ef\u80fd\u4f1a\u88ab\u5176\u5171\u4eab\u7684\u7a0b\u5e8f\u5728\u65e0\u610f\u4e2d\u8fdb\u884c\u8bfb\u6216\u8005\u5199\u64cd\u4f5c\u3002\u53ea\u6709\u5f53\u5b83\u4eec\u771f\u6b63\u88ab\u5173\u95ed\u540e\uff0c\u5bf9\u4e8e\u5b83\u4eec\u5c1d\u8bd5\u8fdb\u884c\u8bfb\u6216\u8005\u5199\u64cd\u4f5c\u5c06\u4f1a\u629b\u51fa\u5f02\u5e38, \u5e76\u4f7f\u5f97\u95ee\u9898\u5feb\u901f\u663e\u73b0\u51fa\u6765\u3002<\/li>\n<\/ol>\n<p>\u800c\u4e14\uff0c\u5e7b\u60f3\u5f53\u6587\u4ef6\u5bf9\u8c61\u6790\u6784\u65f6\uff0c\u6587\u4ef6\u548csockets\u4f1a\u81ea\u52a8\u5173\u95ed\uff0c\u8bd5\u56fe\u5c06\u6587\u4ef6\u5bf9\u8c61\u7684\u751f\u547d\u5468\u671f\u548c\u6587\u4ef6\u7684\u72b6\u6001\u7ed1\u5b9a\u5728\u4e00\u8d77\u7684\u60f3\u6cd5, \u90fd\u662f\u4e0d\u73b0\u5b9e\u7684\u3002\u56e0\u4e3a\u6709\u5982\u4e0b\u539f\u56e0\uff1a<\/p>\n<ol>\n<li>\u6ca1\u6709\u4efb\u4f55\u65b9\u6cd5\u53ef\u4ee5\u786e\u4fdd\u8fd0\u884c\u73af\u5883\u4f1a\u771f\u6b63\u7684\u6267\u884c\u6587\u4ef6\u7684\u6790\u6784. \u4e0d\u540c\u7684Python\u5b9e\u73b0\u91c7\u7528\u4e0d\u540c\u7684\u5185\u5b58\u7ba1\u7406\u6280\u672f, \u6bd4\u5982\u5ef6\u65f6\u5783\u573e\u5904\u7406\u673a\u5236. \u5ef6\u65f6\u5783\u573e\u5904\u7406\u673a\u5236\u53ef\u80fd\u4f1a\u5bfc\u81f4\u5bf9\u8c61\u751f\u547d\u5468\u671f\u88ab\u4efb\u610f\u65e0\u9650\u5236\u7684\u5ef6\u957f\u3002<\/li>\n<li>\u5bf9\u4e8e\u6587\u4ef6\u610f\u5916\u7684\u5f15\u7528,\u4f1a\u5bfc\u81f4\u5bf9\u4e8e\u6587\u4ef6\u7684\u6301\u6709\u65f6\u95f4\u8d85\u51fa\u9884\u671f(\u6bd4\u5982\u5bf9\u4e8e\u5f02\u5e38\u7684\u8ddf\u8e2a, \u5305\u542b\u6709\u5168\u5c40\u53d8\u91cf\u7b49)\u3002<\/li>\n<\/ol>\n<p>1.15.2 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u63a8\u8350\u4f7f\u7528 <code>with<\/code> \u8bed\u53e5\u7ba1\u7406\u6587\u4ef6\u3002<\/p>\n<pre><code class=\"language-python\">with open(&quot;hello.txt&quot;) as hello_file:\n    for line in hello_file:\n        print(line)<\/code><\/pre>\n<p>\u5bf9\u4e8e\u4e0d\u652f\u6301\u4f7f\u7528<code>with<\/code>\u8bed\u53e5\u7684\u7c7b\u4f3c\u6587\u4ef6\u7684\u5bf9\u8c61,\u4f7f\u7528<code>contextlib.closing()<\/code>\uff1a<\/p>\n<pre><code class=\"language-python\">import contextlib\n\nwith contextlib.closing(urllib.urlopen(&quot;http:\/\/www.python.org\/&quot;)) as front_page:\n    for line in front_page:\n        print(line)<\/code><\/pre>\n<p>Legacy AppEngine \u4e2dPython 2.5\u7684\u4ee3\u7801\u5982\u4f7f\u7528<code>with<\/code>\u8bed\u53e5, \u9700\u8981\u6dfb\u52a0 <code>from __future__ import with_statement<\/code>.<\/p>\n<h5><span class=\"ez-toc-section\" id=\"116_%E8%AE%BF%E9%97%AE%E6%8E%A7%E5%88%B6\"><\/span>1.16 \u8bbf\u95ee\u63a7\u5236<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<blockquote>\n<p>\u5728Python\u4e2d\uff0c\u5bf9\u4e8e\u7410\u788e\u53c8\u4e0d\u592a\u91cd\u8981\u7684\u8bbf\u95ee\u51fd\u6570, \u5e94\u8be5\u76f4\u63a5\u4f7f\u7528\u516c\u6709\u53d8\u91cf\u6765\u53d6\u4ee3\u5b83\u4eec\uff0c\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u989d\u5916\u7684\u51fd\u6570\u8c03\u7528\u5f00\u9500\u3002<br \/>\n\u5f53\u6dfb\u52a0\u66f4\u591a\u529f\u80fd\u65f6\uff0c\u4e5f\u53ef\u4ee5\u7528\u5c5e\u6027(property)\u6765\u4fdd\u6301\u8bed\u6cd5\u7684\u4e00\u81f4\u6027\u3002<\/p>\n<\/blockquote>\n<p>1.16.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5982\u679c\u8bbf\u95ee\u5c5e\u6027\u540e\u9700\u8981\u590d\u6742\u7684\u903b\u8f91\u5904\u7406\uff0c\u6216\u8005\u53d8\u91cf\u7684\u8bbf\u95ee\u5f00\u9500\u5f88\u663e\u8457\uff0c \u90a3\u4e48\u5e94\u8be5\u4f7f\u7528\u50cf <code>get_foo()<\/code> \u548c <code>set_foo()<\/code> \u8fd9\u6837\u7684\u51fd\u6570\u8c03\u7528\u3002<br \/>\n\u5982\u679c\u4e4b\u524d\u7684\u4ee3\u7801\u884c\u4e3a\u5df2\u7ecf\u901a\u8fc7\u5c5e\u6027(property)\u8bbf\u95ee\uff0c\u90a3\u4e48\u5c31\u4e0d\u8981\u5c06\u65b0\u7684\u8bbf\u95ee\u51fd\u6570\u4e0e\u5c5e\u6027\u7ed1\u5b9a\u3002 \u5426\u5219\uff0c\u4efb\u4f55\u8bd5\u56fe\u901a\u8fc7\u8001\u65b9\u6cd5\u8bbf\u95ee\u53d8\u91cf\u7684\u4ee3\u7801\u5c31\u6ca1\u6cd5\u8fd0\u884c\uff0c\u4f7f\u7528\u8005\u4e5f\u5c31\u4f1a\u610f\u8bc6\u5230\u590d\u6742\u6027\u53d1\u751f\u4e86\u53d8\u5316\u3002 \uff08\u5982\u679c\u53ef\u4ee5\u91cd\u6784\u8fd9\u4e2a\u4ee3\u7801\u662f\u6700\u597d\u7684\u4e86\uff09<\/p>\n<h5><span class=\"ez-toc-section\" id=\"117_Main\"><\/span>1.17 Main<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<blockquote>\n<p>\u5373\u4f7f\u662f\u4e00\u4e2a\u6253\u7b97\u88ab\u7528\u4f5c\u811a\u672c\u7684\u6587\u4ef6, \u4e5f\u5e94\u8be5\u662f\u53ef\u5bfc\u5165\u7684\u3002<br \/>\n\u5e76\u4e14\u7b80\u5355\u7684\u5bfc\u5165\u4e0d\u5e94\u8be5\u5bfc\u81f4\u8fd9\u4e2a\u811a\u672c\u7684\u4e3b\u529f\u80fd(main functionality)\u88ab\u6267\u884c\uff0c\u8fd9\u662f\u4e00\u79cd\u526f\u4f5c\u7528\u3002<br \/>\n\u4e3b\u529f\u80fd\u5e94\u8be5\u653e\u5728\u4e00\u4e2amain()\u51fd\u6570\u4e2d\u3002<\/p>\n<\/blockquote>\n<p>1.17.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6240\u6709\u7684\u6587\u4ef6\u90fd\u5e94\u8be5\u53ef\u4ee5\u88ab\u5bfc\u5165\u3002 \u5bf9\u4e0d\u9700\u8981\u4f5c\u4e3a\u7a0b\u5e8f\u5165\u53e3\u5730\u65b9\u6dfb\u52a0 <code>if __name__ == &#039;__main__&#039; <\/code>\u3002<\/p>\n<p>\u5728Python\u4e2d\uff0cpydoc\u4ee5\u53ca\u5355\u5143\u6d4b\u8bd5\u8981\u6c42\u6a21\u5757\u5fc5\u987b\u662f\u53ef\u5bfc\u5165\u7684\u3002 \u4f60\u7684\u4ee3\u7801\u5e94\u8be5\u5728\u6267\u884c\u4e3b\u7a0b\u5e8f\u524d\u603b\u662f\u68c0\u67e5 <code>if __name__ == &#039;__main__&#039; <\/code>\uff0c \u8fd9\u6837\u5f53\u6a21\u5757\u88ab\u5bfc\u5165\u65f6\u4e3b\u7a0b\u5e8f\u5c31\u4e0d\u4f1a\u88ab\u6267\u884c\u3002<br \/>\n\u6240\u6709\u7684\u9876\u7ea7\u4ee3\u7801\u5728\u6a21\u5757\u5bfc\u5165\u65f6\u90fd\u4f1a\u88ab\u6267\u884c\u3002 \u8981\u5c0f\u5fc3\u4e0d\u8981\u53bb\u8c03\u7528\u51fd\u6570\uff0c\u521b\u5efa\u5bf9\u8c61\uff0c\u6216\u8005\u6267\u884c\u90a3\u4e9b\u4e0d\u5e94\u8be5\u5728\u4f7f\u7528pydoc\u65f6\u6267\u884c\u7684\u64cd\u4f5c\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def main():\n      ...\n\nif __name__ == &#039;__main__&#039;:\n    main()<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"118_%E5%91%BD%E5%90%8D\"><\/span>1.18 \u547d\u540d<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<blockquote>\n<p>module_name, package_name, ClassName, method_name, ExceptionName, function_name, GLOBAL_VAR_NAME, instance_var_name, function_parameter_name, local_var_name.<\/p>\n<\/blockquote>\n<p>\u5e94\u8be5\u907f\u514d\u7684\u540d\u79f0\uff1a<\/p>\n<ol>\n<li>\u5355\u5b57\u7b26\u540d\u79f0\uff0c\u9664\u4e86\u8ba1\u6570\u5668\u548c\u8fed\u4ee3\u5668\u3002<\/li>\n<li>\u5305\/\u6a21\u5757\u540d\u4e2d\u7684\u8fde\u5b57\u7b26(-)\u3002<\/li>\n<li>\u53cc\u4e0b\u5212\u7ebf\u5f00\u5934\u5e76\u7ed3\u5c3e\u7684\u540d\u79f0(Python\u4fdd\u7559\uff0c\u4f8b\u5982<strong>init<\/strong>)\u3002<\/li>\n<\/ol>\n<p>1.18.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u547d\u540d\u7ea6\u5b9a\u89c4\u5219\u5982\u4e0b\uff1a pylint:<code>invalid-name<\/code>.<\/p>\n<ol>\n<li>\u6240\u8c13<code>\u5185\u90e8(Internal)<\/code>\u8868\u793a\u4ec5\u6a21\u5757\u5185\u53ef\u7528, \u6216\u8005, \u5728\u7c7b\u5185\u662f\u4fdd\u62a4\u6216\u79c1\u6709\u7684\u3002<\/li>\n<li>\u7528\u5355\u4e0b\u5212\u7ebf<code>(_)<\/code>\u5f00\u5934\u8868\u793a\u6a21\u5757\u53d8\u91cf\u6216\u51fd\u6570\u662fprotected\u7684(\u4f7f\u7528from module import *\u65f6\u4e0d\u4f1a\u5305\u542b)\u3002<\/li>\n<li>\u7528\u53cc\u4e0b\u5212\u7ebf<code>(__)<\/code>\u5f00\u5934\u7684\u5b9e\u4f8b\u53d8\u91cf\u6216\u65b9\u6cd5\u8868\u793a\u7c7b\u5185\u79c1\u6709\u3002<\/li>\n<li>\u5c06\u76f8\u5173\u7684\u7c7b\u548c\u9876\u7ea7\u51fd\u6570\u653e\u5728\u540c\u4e00\u4e2a\u6a21\u5757\u91cc\u3002\u4e0d\u50cfJava\uff0c\u6ca1\u5fc5\u8981\u9650\u5236\u4e00\u4e2a\u7c7b\u4e00\u4e2a\u6a21\u5757\u3002<\/li>\n<li>\u5bf9\u7c7b\u540d\u4f7f\u7528\u5927\u5199\u5b57\u6bcd\u5f00\u5934\u7684\u5355\u8bcd(\u5982CapWords, \u5373Pascal\u98ce\u683c)\uff0c\u4f46\u662f\u6a21\u5757\u540d\u5e94\u8be5\u7528\u5c0f\u5199\u52a0\u4e0b\u5212\u7ebf\u7684\u65b9\u5f0f(\u5982lower_with_under.py)\u3002\u5c3d\u7ba1\u5df2\u7ecf\u6709\u5f88\u591a\u73b0\u5b58\u7684\u6a21\u5757\u4f7f\u7528\u7c7b\u4f3c\u4e8eCapWords.py\u8fd9\u6837\u7684\u547d\u540d\uff0c\u4f46\u73b0\u5728\u5df2\u7ecf\u4e0d\u9f13\u52b1\u8fd9\u6837\u505a, \u56e0\u4e3a\u5982\u679c\u6a21\u5757\u540d\u78b0\u5de7\u548c\u7c7b\u540d\u4e00\u81f4\uff0c\u8fd9\u4f1a\u8ba9\u4eba\u56f0\u6270\u3002<\/li>\n<\/ol>\n<p>Python\u4e4b\u7236Guido\u63a8\u8350\u7684\u89c4\u8303\uff1a<\/p>\n<table>\n<thead>\n<tr>\n<th>Type<\/th>\n<th>Public<\/th>\n<th>Internal<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Modules<\/td>\n<td>lower_with_under<\/td>\n<td>_lower_with_under<\/td>\n<\/tr>\n<tr>\n<td>Packages<\/td>\n<td>lower_with_under<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td>Classes<\/td>\n<td>CapWords<\/td>\n<td>_CapWords<\/td>\n<\/tr>\n<tr>\n<td>Exceptions<\/td>\n<td>CapWords<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td>Functions<\/td>\n<td>lower_with_under()<\/td>\n<td>_lower_with_under()<\/td>\n<\/tr>\n<tr>\n<td>Global\/Class Constants<\/td>\n<td>CAPS_WITH_UNDER<\/td>\n<td>_CAPS_WITH_UNDER<\/td>\n<\/tr>\n<tr>\n<td>Global\/Class Variables<\/td>\n<td>lower_with_under<\/td>\n<td>_lower_with_under<\/td>\n<\/tr>\n<tr>\n<td>Instance Variables<\/td>\n<td>lower_with_under<\/td>\n<td>_lower_with_under (protected) or __lower_with_under (private)<\/td>\n<\/tr>\n<tr>\n<td>Method Names<\/td>\n<td>lower_with_under()<\/td>\n<td>_lower_with<em>under() (protected) or \\<\/em>_lower_with_under() (private)<\/td>\n<\/tr>\n<tr>\n<td>Function\/Method Parameters<\/td>\n<td>lower_with_under<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td>Local Variables<\/td>\n<td>lower_with_under<\/td>\n<td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4><span class=\"ez-toc-section\" id=\"%E4%BA%8C%E3%80%81%E7%BC%96%E7%A0%81%E8%A7%84%E8%8C%83\"><\/span>\u4e8c\u3001\u7f16\u7801\u89c4\u8303<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<h5><span class=\"ez-toc-section\" id=\"21_%E4%B8%89%E7%9B%AE%E8%BF%90%E7%AE%97%E7%AC%A6\"><\/span>2.1 \u4e09\u76ee\u8fd0\u7b97\u7b26<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.1.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u4e09\u76ee\u64cd\u4f5c\u7b26\u5224\u65ad\uff0cpython \u4e0d\u652f\u6301\u4e09\u76ee\u8fd0\u7b97\u7b26\uff0c\u4f46\u53ef\u4f7f\u7528\u5982\u4e0b\u65b9\u5f0f\uff0c\u7981\u6b62\u4f7f\u7528\u590d\u6742\u96be\u61c2\u7684\u903b\u8f91\u5224\u65ad\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x = a if a &gt;= b else b<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">x = a &gt;= b and a or b<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"22_None_%E6%9D%A1%E4%BB%B6%E7%9A%84%E5%88%A4%E6%96%AD\"><\/span>2.2 None \u6761\u4ef6\u7684\u5224\u65ad<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.2.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u4e3a\u63d0\u5347\u53ef\u8bfb\u6027\uff0c\u5728\u5224\u65ad\u6761\u4ef6\u4e2d\u5e94\u4f7f\u7528 <code>is not<\/code>\uff0c\u800c\u4e0d\u4f7f\u7528 <code>not ... is<\/code>\u3002 pycodestyle:<code>E714 test for object identity should be &#039;is not&#039;<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if foo is not None:<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if not foo is None:<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"23_lambda%E5%8C%BF%E5%90%8D%E5%87%BD%E6%95%B0\"><\/span>2.3 lambda\u533f\u540d\u51fd\u6570<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.3.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u4f7f\u7528 def \u5b9a\u4e49\u7b80\u77ed\u51fd\u6570\u800c\u4e0d\u662f\u4f7f\u7528 lambda\u3002 pycodestyle:<code>E731 do not assign a lambda expression, use a def<\/code>.<\/p>\n<p>\u4f7f\u7528def\u7684\u65b9\u5f0f\u6709\u52a9\u4e8e\u5728trackbacks\u4e2d\u6253\u5370\u6709\u6548\u7684\u7c7b\u578b\u4fe1\u606f\uff0c\u660e\u786e\u4f7f\u7528<code>f<\/code>\u51fd\u6570\u800c\u4e0d\u662f\u4e00\u4e2alambda\u7684\u8c03\u7528\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def f(x):\n    return 2 * x<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">f = lambda x: 2 * x<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"24_%E5%BC%82%E5%B8%B8\"><\/span>2.4 \u5f02\u5e38<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.4.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5f02\u5e38\u7c7b\u7ee7\u627f\u81ea <code>Exception<\/code>\uff0c\u800c\u4e0d\u662f <code>BaseException<\/code>\u3002<\/p>\n<p>2.4.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u4f7f\u7528\u65b0\u7248\u672c\u629b\u51fa\u5f02\u5e38\u7684\u65b9\u5f0f\uff0c\u7981\u6b62\u4f7f\u7528\u5e9f\u5f03\u7684\u65b9\u5f0f\u3002 pycodestyle:<code>W602 deprecated form of raising exception<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">raise ValueError(&#039;message&#039;)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">raise ValueError, &#039;message&#039;<\/code><\/pre>\n<p>2.4.3 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6355\u83b7\u5f02\u5e38\u65f6\uff0c\u9700\u8981\u6307\u660e\u5177\u4f53\u5f02\u5e38\uff0c\u800c\u4e0d\u662f\u6355\u83b7\u6240\u6709\u5f02\u5e38\u3002 \u9664\u975e\u5df2\u7ecf\u5728\u5f53\u524d\u7ebf\u7a0b\u7684\u6700\u5916\u5c42\uff08\u8bb0\u5f97\u8fd8\u662f\u8981\u6253\u5370\u4e00\u6761traceback\uff09\u3002 pylint:<code>broad-except<\/code>, <code>bare-except<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    import platform_specific_module\nexcept ImportError:\n    platform_specific_module = None\n\ntry:\n    do_something()\nexcept Exception as ex:  # pylint: disable=broad-except\n    log.exception(ex)  # \u5e94\u5c06\u9519\u8bef\u5806\u6808\u6253\u5370\u5230\u65e5\u5fd7\u6587\u4ef6\u4e2d\uff0c\u4ee5\u4f9b\u540e\u7eed\u6392\u67e5\u3002\n    handle_exception_or_not()  # \u9664\u6253\u5370\u65e5\u5fd7\u5916\uff0c\u8fd8\u53ef\u4ee5\u8fdb\u4e00\u6b65\u5904\u7406\u5982\u6e05\u7406\u8d44\u6e90\u7b49\uff0c\u53ef\u9009\u3002<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    import platform_specific_module\nexcept Exception:  # broad-except\n    platform_specific_module = None\n\ntry:\n    do_something()\nexcept Exception:  # \u6846\u67b6\u7b49\u672a\u660e\u786e\u5f02\u5e38\u573a\u666f\uff0c\u5efa\u8bae\u589e\u52a0 traceback \u6253\u5370\n    pass<\/code><\/pre>\n<p>2.4.4 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5efa\u8bae\u5728\u4ee3\u7801\u4e2d\u7528\u5f02\u5e38\u66ff\u4ee3\u51fd\u6570\u7684\u9519\u8bef\u8fd4\u56de\u7801\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def write_data():\n    if check_file_exist():\n        do_something()\n    else:\n        raise FileNotExist()<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def write_data():\n    if check_file_exist():\n        do_something()\n        return 0\n    else:\n        return FILE_NOT_EXIST<\/code><\/pre>\n<p>2.4.5 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5728 <code>except<\/code> \u5b50\u53e5\u4e2d\u91cd\u65b0\u629b\u51fa\u539f\u6709\u5f02\u5e38\u65f6\uff0c\u4e0d\u80fd\u7528 <code>raise ex<\/code>\uff0c\u800c\u662f\u7528 <code>raise<\/code>\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    raise MyException()\nexcept MyException as ex:\n    try_handle_exception()\n    raise  # \u53ef\u4ee5\u4fdd\u7559\u539f\u59cb\u7684 traceback\n\ntry:\n    raise MyException()\nexcept MyException as ex:\n    log.exception(ex)\n    raise AnotherException(str(ex))  # \u5141\u8bb8\u7684\uff0c\u5efa\u8bae\u4fdd\u7559\u597d\u4e4b\u524d\u7684\u5f02\u5e38\u6808\u4fe1\u606f\uff0c\u7528\u4e8e\u5b9a\u4f4d\u95ee\u9898<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    raise MyException()\nexcept MyException as ex:\n    try_handle_exception()\n    raise ex  # \u5f02\u5e38\u6808\u4fe1\u606f\u4ece\u8fd9\u91cc\u5f00\u59cb\uff0c\u539f\u59cb\u7684raise\u5f02\u5e38\u6808\u4fe1\u606f\u6d88\u606f<\/code><\/pre>\n<p>2.4.6 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u6240\u6709 <code>try<\/code>\/<code>except<\/code> \u5b50\u53e5\u7684\u4ee3\u7801\u8981\u5c3d\u53ef\u7684\u5c11\uff0c\u4ee5\u514d\u5c4f\u853d\u5176\u4ed6\u7684\u9519\u8bef\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    value = collection[key]\nexcept KeyError:\n    return key_not_found(key)\nelse:\n    return handle_value(value)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">try:\n    # \u8303\u56f4\u592a\u5e7f\n    return handle_value(collection[key])\nexcept KeyError:\n    # \u4f1a\u6355\u6349\u5230 handle_value() \u4e2d\u7684 KeyError\n    return key_not_found(key)<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"25_%E6%9D%A1%E4%BB%B6%E8%A1%A8%E8%BE%BE%E5%BC%8F\"><\/span>2.5 \u6761\u4ef6\u8868\u8fbe\u5f0f<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.5.1 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u51fd\u6570\u6216\u8005\u65b9\u6cd5\u5728\u6ca1\u6709\u8fd4\u56de\u65f6\u8981\u660e\u786e\u8fd4\u56de<code>None<\/code>\u3002 pylint:<code>inconsistent-return-statements<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def foo(x):\n    if x &gt;= 0:\n        return math.sqrt(x)\n    else:\n        return None\n\ndef bar(x):\n    if x &lt; 0:\n        return None\n    return math.sqrt(x)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def foo(x):\n    if x &gt;= 0:\n        return math.sqrt(x)\n\ndef bar(x):\n    if x &lt; 0:\n        return\n    return math.sqrt(x)<\/code><\/pre>\n<p>2.5.2 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5bf9\u4e8e\u672a\u77e5\u7684\u6761\u4ef6\u5206\u652f\u6216\u8005\u4e0d\u5e94\u8be5\u8fdb\u5165\u7684\u5206\u652f\uff0c\u5efa\u8bae\u629b\u51fa\u5f02\u5e38\uff0c\u800c\u4e0d\u662f\u8fd4\u56de\u4e00\u4e2a\u503c\uff08\u6bd4\u5982\u8bf4<code>None<\/code> \u6216<code>False<\/code>\uff09\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def f(x):\n    if x in (&#039;SUCCESS&#039;,):\n        return True\n    else:\n        raise MyException()  # \u5982\u679c\u4e00\u5b9a\u4e0d\u4f1a\u8d70\u5230\u7684\u6761\u4ef6\uff0c\u53ef\u4ee5\u589e\u52a0\u5f02\u5e38\uff0c\u9632\u6b62\u5c06\u6765\u672a\u77e5\u7684\u8bed\u53e5\u6267\u884c\u3002<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def f(x):\n    if x in (&#039;SUCCESS&#039;,):\n        return True\n    return None<\/code><\/pre>\n<p>2.5.3 <span style=\"color:blue\"><strong>\u3010\u53ef\u9009\u3011<\/strong><\/span> <code>if<\/code> \u4e0e <code>else<\/code> \u5c3d\u91cf\u4e00\u8d77\u51fa\u73b0\uff0c\u800c\u4e0d\u662f\u5168\u90e8\u90fd\u662f<code>if<\/code>\u5b50\u53e5\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if condition:\n    do_something()\nelse:\n    # \u589e\u52a0\u8bf4\u660e\u6ce8\u91ca\n    pass\n\nif condition:\n    do_something()\n# \u8fd9\u91cc\u589e\u52a0\u6ce8\u91ca\u8bf4\u660e\u4e3a\u4ec0\u4e48\u4e0d\u7528\u5199else\u5b50\u53e5\n# else:\n#     pass<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if condition:\n    do_something()\nif another_condition:  # \u4e0d\u80fd\u786e\u5b9a\u662f\u5426\u7b14\u8bef\u4e3a elif \uff0c\u8fd8\u662f\u5f00\u542f\u5168\u65b0\u4e00\u4e2aif\u6761\u4ef6\n    do_another_something()\nelse:\n    do_else_something()<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"26_TrueFalse_%E5%B8%83%E5%B0%94%E8%BF%90%E7%AE%97\"><\/span>2.6 True\/False \u5e03\u5c14\u8fd0\u7b97<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.6.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u4e0d\u8981\u7528 <code>==<\/code> \u4e0e <code>True<\/code>\u3001 <code>False<\/code> \u8fdb\u884c\u5e03\u5c14\u8fd0\u7b97\u3002 pylint:<code>singleton-comparison<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if greeting:\n   pass<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if greeting == True:\n   pass\n\nif greeting is True:  # Worse\n   pass<\/code><\/pre>\n<p>2.6.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u5bf9\u5e8f\u5217\uff08\u5b57\u7b26\u4e32\u3001\u5217\u8868 \u3001\u5143\u7ec4\uff09\uff0c\u7a7a\u5e8f\u5217\u4e3a false \u7684\u60c5\u51b5\u3002 pylint:<code>len-as-condition<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if not seq:\n   pass\n\nif seq:\n   pass<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">if len(seq):\n   pass\n\nif not len(seq):\n   pass<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"27_%E5%88%97%E8%A1%A8%E6%8E%A8%E5%AF%BC%E5%BC%8F\"><\/span>2.7 \u5217\u8868\u63a8\u5bfc\u5f0f<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.7.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7981\u6b62\u8d85\u8fc71\u4e2afor\u8bed\u53e5\u6216\u8fc7\u6ee4\u5668\u8868\u8fbe\u5f0f\uff0c\u5426\u5219\u4f7f\u7528\u4f20\u7edf<code>for<\/code>\u5faa\u73af\u8bed\u53e5\u66ff\u4ee3\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">number_list = [1, 2, 3, 10, 20, 55]\nodd = [i for i in number_list if i % 2 == 1]\n\nresult = []\nfor x in range(10):\n    for y in range(5):\n        if x * y &gt; 10:\n            result.append((x, y))<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">result = [(x, y) for x in range(10) for y in range(5) if x * y &gt; 10]  # for \u8bed\u53e5<\/code><\/pre>\n<p>2.7.2 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u5217\u8868\u63a8\u5bfc\u5f0f\u9002\u7528\u4e8e\u7b80\u5355\u573a\u666f\u3002 \u5982\u679c\u8bed\u53e5\u8fc7\u957f\uff0c\u6bcf\u4e2a\u90e8\u5206\u5e94\u8be5\u5355\u72ec\u7f6e\u4e8e\u4e00\u884c\uff1a \u6620\u5c04\u8868\u8fbe\u5f0f\uff0c for\u8bed\u53e5\uff0c \u8fc7\u6ee4\u5668\u8868\u8fbe\u5f0f\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">fizzbuzz = []\nfor n in range(100):\n    if n % 3 == 0 and n % 5 == 0:\n        fizzbuzz.append(f&#039;fizzbuzz {n}&#039;)\n    elif n % 3 == 0:\n        fizzbuzz.append(f&#039;fizz {n}&#039;)\n    elif n % 5 == 0:\n        fizzbuzz.append(f&#039;buzz {n}&#039;)\n    else:\n        fizzbuzz.append(n)\n\nfor n in range(1, 11):\n    print(n)<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\"># \u6761\u4ef6\u8fc7\u4e8e\u590d\u6742\uff0c\u5e94\u8be5\u91c7\u7528for\u8bed\u53e5\u5c55\u5f00\nfizzbuzz = [\n    f&#039;fizzbuzz {n}&#039; if n % 3 == 0 and n % 5 == 0\n    else f&#039;fizz {n}&#039; if n % 3 == 0\n    else f&#039;buzz {n}&#039; if n % 5 == 0\n    else n\n    for n in range(100)\n]\n\n[print(n) for n in range(1, 11)]  # \u65e0\u8fd4\u56de\u503c<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"28_%E5%87%BD%E6%95%B0\"><\/span>2.8 \u51fd\u6570<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.8.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u6a21\u5757\u5185\u90e8\u7981\u6b62\u5b9a\u4e49\u91cd\u590d\u51fd\u6570\u58f0\u660e\u3002 pylint:<code>function-redefined<\/code>.<\/p>\n<p>\u7981\u6b62\u91cd\u590d\u7684\u51fd\u6570\u5b9a\u4e49\u3002<\/p>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def get_x(x):\n    return x\n\ndef get_x(x):  # \u6a21\u5757\u5185\u91cd\u590d\u5b9a\u4e49\n    return x<\/code><\/pre>\n<p>2.8.2 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u51fd\u6570\u53c2\u6570\u4e2d\uff0c\u4e0d\u5141\u8bb8\u51fa\u73b0\u53ef\u53d8\u7c7b\u578b\u53d8\u91cf\u4f5c\u4e3a\u9ed8\u8ba4\u503c\u3002 pylint:<code>dangerous-default-value<\/code>.<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def f(x=0, y=None, z=None):\n    if y is None:\n        y = []\n    if z is None:\n        z = {}<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def f(x=0, y=[], z={}):\n    pass\n\ndef f(a, b=time.time()):\n    pass<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"29_%E5%8F%98%E9%87%8F\"><\/span>2.9 \u53d8\u91cf<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>2.9.1 <span style=\"color:red\"><strong>\u3010\u5fc5\u987b\u3011<\/strong><\/span> \u7981\u6b62\u5b9a\u4e49\u4e86\u53d8\u91cf\u5374\u4e0d\u4f7f\u7528\u5b83\u3002 pylint:<code>unused-variable<\/code>.<\/p>\n<p>\u5728\u4ee3\u7801\u91cc\u5230\u5904\u5b9a\u4e49\u53d8\u91cf\u5374\u6ca1\u6709\u4f7f\u7528\u5b83\uff0c\u4e0d\u5b8c\u6574\u7684\u4ee3\u7801\u7ed3\u6784\u770b\u8d77\u6765\u50cf\u662f\u4e2a\u4ee3\u7801\u9519\u8bef\u3002 \u5373\u4f7f\u6ca1\u6709\u4f7f\u7528\uff0c\u4f46\u662f\u5b9a\u4e49\u53d8\u91cf\u4ecd\u7136\u9700\u8981\u6d88\u8017\u8d44\u6e90\uff0c\u5e76\u4e14\u5bf9\u9605\u8bfb\u4ee3\u7801\u7684\u4eba\u4e5f\u4f1a\u9020\u6210\u56f0\u60d1\uff0c\u4e0d\u77e5\u9053\u8fd9\u4e9b\u53d8\u91cf\u662f\u8981\u505a\u4ec0\u4e48\u7684\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">def get_x_plus_y(x, y):\n    return x + y<\/code><\/pre>\n<p><span class=\"bad_example_span\" style=\"color:#dc143c\"><strong><em>\u9519\u8bef\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">some_unused_var = 42\n\n# \u5b9a\u4e49\u4e86\u53d8\u91cf\u4e0d\u610f\u5473\u7740\u5c31\u662f\u4f7f\u7528\u4e86\ny = 10\ny = 5\n\n# \u5bf9\u81ea\u8eab\u7684\u64cd\u4f5c\u5e76\u4e0d\u610f\u5473\u7740\u4f7f\u7528\u4e86\nz = 0\nz = z + 1\n\n# \u672a\u4f7f\u7528\u7684\u51fd\u6570\u53c2\u6570\ndef get_x(x, y):\n    return x<\/code><\/pre>\n<p>2.9.2 <span style=\"color:orange\"><strong>\u3010\u63a8\u8350\u3011<\/strong><\/span> \u4f7f\u7528\u53cc\u4e0b\u5212\u7ebf <code>__<\/code> \u6765\u4ee3\u8868\u4e0d\u9700\u8981\u7684\u53d8\u91cf\uff0c\u5355\u4e0b\u5212\u7ebf <code>_<\/code> \u5bb9\u6613\u4e0e <code>gettext()<\/code> \u51fd\u6570\u7684\u522b\u540d\u51b2\u7a81\u3002<\/p>\n<p><span class=\"good_example_span\" style=\"color:#228b22\"><strong><em>\u6b63\u786e\u793a\u8303<\/em><\/strong><\/span><\/p>\n<pre><code class=\"language-python\">path = &#039;\/tmp\/python\/foobar.txt&#039;\ndir_name, __ = os.path.split(path)<\/code><\/pre>\n<h4><span class=\"ez-toc-section\" id=\"%E5%B7%A5%E5%85%B7%E4%B8%8E%E9%85%8D%E7%BD%AE\"><\/span>\u5de5\u5177\u4e0e\u914d\u7f6e<span class=\"ez-toc-section-end\"><\/span><\/h4>\n<h5><span class=\"ez-toc-section\" id=\"flake8\"><\/span>flake8<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p><a href=\"https:\/\/flake8.pycqa.org\/\"><code>flake8<\/code><\/a> \u662f\u4e00\u4e2a\u7ed3\u5408\u4e86 pycodestyle\uff0cpyflakes\uff0cmccabe \u68c0\u67e5 Python \u4ee3\u7801\u89c4\u8303\u7684\u5de5\u5177\u3002<\/p>\n<p>\u4f7f\u7528\u65b9\u6cd5\uff1a<\/p>\n<pre><code class=\"language-bash\">flake8 {source_file_or_directory}<\/code><\/pre>\n<p>\u5728\u9879\u76ee\u4e2d\u521b\u5efa <code>setup.cfg<\/code> \u6216\u8005 <code>tox.ini<\/code> \u6216\u8005 <code>.flake8<\/code> \u6587\u4ef6\uff0c\u6dfb\u52a0 <code>[flake8]<\/code> \u90e8\u5206\u3002<\/p>\n<p>\u63a8\u8350\u7684\u914d\u7f6e\u6587\u4ef6\u5982\u4e0b\uff1a<\/p>\n<pre><code class=\"language-ini\">[flake8]\nignore =\n    ;W503 line break before binary operator\n    W503,\n    ;E203 whitespace before &#039;:&#039;\n    E203,\n\n; exclude file\nexclude =\n    .tox,\n    .git,\n    __pycache__,\n    build,\n    dist,\n    *.pyc,\n    *.egg-info,\n    .cache,\n    .eggs\n\nmax-line-length = 120<\/code><\/pre>\n<p>\u5982\u679c\u9700\u8981\u5c4f\u853d\u544a\u8b66\u53ef\u4ee5\u589e\u52a0\u884c\u5185\u6ce8\u91ca <code># noqa<\/code>\uff0c\u4f8b\u5982\uff1a<\/p>\n<pre><code class=\"language-python\">example = lambda: &#039;example&#039;  # noqa: E731<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"pylint\"><\/span>pylint<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p><a href=\"https:\/\/www.pylint.org\/\"><code>pylint<\/code><\/a> \u662f\u4e00\u4e2a\u80fd\u591f\u68c0\u67e5\u7f16\u7801\u8d28\u91cf\u3001\u7f16\u7801\u89c4\u8303\u7684\u5de5\u5177\u3002<\/p>\n<p>\u914d\u7f6e\u9879\u8f83\u591a\uff0c\u5355\u72ec\u4e00\u4e2a\u914d\u7f6e\u6587\u4ef6\u914d\u7f6e\uff0c\u8be6\u60c5\u53ef\u67e5\u9605\uff1a<a href=\"https:\/\/git.code.oa.com\/standards\/python\/blob\/master\/.pylintrc\">.pylintrc<\/a><\/p>\n<p>\u4f7f\u7528\u65b9\u6cd5\uff1a<\/p>\n<pre><code class=\"language-bash\">pylint {source_file_or_directory}<\/code><\/pre>\n<p>\u5982\u679c\u9047\u5230\u4e00\u4e9b\u5b9e\u9645\u60c5\u51b5\u4e0e\u4ee3\u7801\u51b2\u7a81\u7684\uff0c\u53ef\u4ee5\u5728\u884c\u5185\u7981\u7528\u76f8\u5173\u68c0\u67e5\uff0c\u4f8b\u5982 \uff1a<\/p>\n<pre><code class=\"language-python\">try:\n    do_something()\nexcept Exception as ex:  # pylint: disable=broad-except\n    pass<\/code><\/pre>\n<p>\u5982\u679c\u9700\u8981\u5bf9\u591a\u884c\u7684\u8fdb\u884c\u7981\u7528\u89c4\u5219\uff0c\u53ef\u4ee5\u914d\u5957\u4f7f\u7528 <code># pylint: disable=\u5177\u4f53\u9519\u8bef\u7801<\/code>\/<code># pylint: enable=\u5177\u4f53\u9519\u8bef\u7801<\/code>\u3002<\/p>\n<pre><code class=\"language-python\"># pylint: disable=invalid-name\n\u8fd9\u91cc\u7684\u4ee3\u7801\u5757\u4f1a\u88ab\u5ffd\u7565\u76f8\u5173\u7684\u544a\u8b66\napp = Flask(__name__)\n# pylint: enable=invalid-name<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"black\"><\/span>black<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p><a href=\"https:\/\/github.com\/psf\/black\"><code>black<\/code><\/a> \u662f\u4e00\u4e2a\u5b98\u65b9\u7684 Python \u4ee3\u7801\u683c\u5f0f\u5316\u5de5\u5177\u3002<\/p>\n<p>\u4f7f\u7528\u65b9\u6cd5\uff1a<\/p>\n<pre><code class=\"language-bash\">black {source_file_or_directory}<\/code><\/pre>\n<p>\u5982\u679c\u4e0d\u60f3\u683c\u5f0f\u5316\u90e8\u5206\u4ee3\u7801\uff0c\u53ef\u4ee5\u914d\u5957\u4f7f\u7528 <code># fmt: off<\/code>\/<code># fmt: on<\/code> \u4e34\u65f6\u5173\u95ed\u683c\u5f0f\u5316\u3002<\/p>\n<pre><code class=\"language-python\"># fmt: off\n\u5728\u8fd9\u7684\u4ee3\u7801\u4e0d\u4f1a\u88ab\u683c\u5f0f\u5316\n# fmt: on<\/code><\/pre>\n<h5><span class=\"ez-toc-section\" id=\"EditorConfig\"><\/span>EditorConfig<span class=\"ez-toc-section-end\"><\/span><\/h5>\n<p>EditorConfig \u53ef\u4ee5\u5e2e\u52a9\u5f00\u53d1\u540c\u4e00\u9879\u76ee\u4e0b\u7684\u8de8\u591a IDE \u7684\u5f00\u53d1\u4eba\u5458\u4fdd\u6301\u4e00\u81f4\u7f16\u7801\u98ce\u683c\u3002<\/p>\n<p>\u5728\u9879\u76ee\u7684\u6839\u76ee\u5f55\u4e0b\u653e\u7f6e<br \/>\n<a href=\"https:\/\/git.code.oa.com\/standards\/python\/blob\/master\/.editorconfig\"><code>.editorconfig<\/code><\/a><br \/>\n\u6587\u4ef6\uff0c\u53ef\u4ee5\u8ba9\u7f16\u8f91\u5668\u89c4\u8303\u6587\u4ef6\u5bf9\u683c\u5f0f\u3002\u53c2\u8003\u914d\u7f6e\u5982\u4e0b\uff1a<\/p>\n<pre><code class=\"language-ini\"># https:\/\/editorconfig.org\n\nroot = true\n\n[*]\nindent_style = space\nindent_size = 4\ntrim_trailing_whitespace = true\ninsert_final_newline = true\ncharset = utf-8\nend_of_line = lf\n\n[*.py]\nmax_line_length = 120\n\n[*.bat]\nindent_style = tab\nend_of_line = crlf\n\n[LICENSE]\ninsert_final_newline = false\n\n[Makefile]\nindent_style = tab<\/code><\/pre>\n<p>\u652f\u6301\u5e38\u89c1\u7684 IDE \uff0c\u914d\u7f6e\u8bf4\u660e\u53ca IDE \u7684\u652f\u6301\u60c5\u51b5\u53ef\u53c2\u8003\u5b98\u7f51 <a href=\"https:\/\/editorconfig.org\/\">editorconfig.org<\/a>\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u524d\u8a00 \u5728\u4e0a\u4e00\u7ae0\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":28270,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"aside","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"default","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[28],"tags":[70,68,72],"class_list":["post-26289","post","type-post","status-publish","format-aside","has-post-thumbnail","hentry","category-blog","tag-agent","tag-68","tag-72","post_format-post-format-aside"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784 - \u4e00\u8d77AI\u6280\u672f<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/17aitech.com\/?p=26289\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289\"},\"author\":{\"name\":\"Dongming\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/#\\\/schema\\\/person\\\/3d23bb6f7f115fcefc9ae7803a691739\"},\"headline\":\"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784\",\"datePublished\":\"2024-09-18T08:41:03+00:00\",\"dateModified\":\"2024-10-08T07:05:43+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289\"},\"wordCount\":343,\"commentCount\":0,\"image\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/2024\\\/09\\\/\u5c01\u9762.jpeg\",\"keywords\":[\"Agent\",\"\u5927\u6a21\u578b\",\"\u9879\u76ee\u5b9e\u6218\"],\"articleSection\":[\"\u535a\u5ba2\u6587\u7ae0\"],\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/17aitech.com\\\/?p=26289#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289\",\"url\":\"https:\\\/\\\/17aitech.com\\\/?p=26289\",\"name\":\"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784 - \u4e00\u8d77AI\u6280\u672f\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/2024\\\/09\\\/\u5c01\u9762.jpeg\",\"datePublished\":\"2024-09-18T08:41:03+00:00\",\"dateModified\":\"2024-10-08T07:05:43+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/#\\\/schema\\\/person\\\/3d23bb6f7f115fcefc9ae7803a691739\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/17aitech.com\\\/?p=26289\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#primaryimage\",\"url\":\"https:\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/2024\\\/09\\\/\u5c01\u9762.jpeg\",\"contentUrl\":\"https:\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/2024\\\/09\\\/\u5c01\u9762.jpeg\",\"width\":660,\"height\":281},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/?p=26289#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\\\/\\\/17aitech.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/#website\",\"url\":\"https:\\\/\\\/17aitech.com\\\/\",\"name\":\"\u4e00\u8d77AI\u6280\u672f\",\"description\":\"\u8ba9AI\u77e5\u8bc6\u89e6\u624b\u53ef\u53ca\",\"alternateName\":\"\u4e00\u8d77AI\u6280\u672f\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/17aitech.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/17aitech.com\\\/#\\\/schema\\\/person\\\/3d23bb6f7f115fcefc9ae7803a691739\",\"name\":\"Dongming\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/member\\\/avatars\\\/238a0b923820dcc5.1732798681.jpg\",\"url\":\"\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/member\\\/avatars\\\/238a0b923820dcc5.1732798681.jpg\",\"contentUrl\":\"\\\/\\\/17aitech.com\\\/wp-content\\\/uploads\\\/member\\\/avatars\\\/238a0b923820dcc5.1732798681.jpg\",\"caption\":\"Dongming\"},\"description\":\"\u89c1\u5929\u5730\uff0c\u89c1\u4f17\u751f\uff0c\u89c1\u81ea\u5df1\u3002\",\"sameAs\":[\"http:\\\/\\\/17aitech.com\"],\"url\":\"https:\\\/\\\/17aitech.com\\\/?page_id=33738&user=1\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784 - \u4e00\u8d77AI\u6280\u672f","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/17aitech.com\/?p=26289","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/17aitech.com\/?p=26289#article","isPartOf":{"@id":"https:\/\/17aitech.com\/?p=26289"},"author":{"name":"Dongming","@id":"https:\/\/17aitech.com\/#\/schema\/person\/3d23bb6f7f115fcefc9ae7803a691739"},"headline":"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784","datePublished":"2024-09-18T08:41:03+00:00","dateModified":"2024-10-08T07:05:43+00:00","mainEntityOfPage":{"@id":"https:\/\/17aitech.com\/?p=26289"},"wordCount":343,"commentCount":0,"image":{"@id":"https:\/\/17aitech.com\/?p=26289#primaryimage"},"thumbnailUrl":"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u5c01\u9762.jpeg","keywords":["Agent","\u5927\u6a21\u578b","\u9879\u76ee\u5b9e\u6218"],"articleSection":["\u535a\u5ba2\u6587\u7ae0"],"inLanguage":"zh-Hans","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/17aitech.com\/?p=26289#respond"]}]},{"@type":"WebPage","@id":"https:\/\/17aitech.com\/?p=26289","url":"https:\/\/17aitech.com\/?p=26289","name":"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784 - \u4e00\u8d77AI\u6280\u672f","isPartOf":{"@id":"https:\/\/17aitech.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/17aitech.com\/?p=26289#primaryimage"},"image":{"@id":"https:\/\/17aitech.com\/?p=26289#primaryimage"},"thumbnailUrl":"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u5c01\u9762.jpeg","datePublished":"2024-09-18T08:41:03+00:00","dateModified":"2024-10-08T07:05:43+00:00","author":{"@id":"https:\/\/17aitech.com\/#\/schema\/person\/3d23bb6f7f115fcefc9ae7803a691739"},"breadcrumb":{"@id":"https:\/\/17aitech.com\/?p=26289#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/17aitech.com\/?p=26289"]}]},{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/17aitech.com\/?p=26289#primaryimage","url":"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u5c01\u9762.jpeg","contentUrl":"https:\/\/17aitech.com\/wp-content\/uploads\/2024\/09\/\u5c01\u9762.jpeg","width":660,"height":281},{"@type":"BreadcrumbList","@id":"https:\/\/17aitech.com\/?p=26289#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/17aitech.com\/"},{"@type":"ListItem","position":2,"name":"\u3010\u9879\u76ee\u5b9e\u6218\u3011\u57fa\u4e8eAgent\u7684\u91d1\u878d\u95ee\u7b54\u7cfb\u7edf\uff1a\u4ee3\u7801\u91cd\u6784"}]},{"@type":"WebSite","@id":"https:\/\/17aitech.com\/#website","url":"https:\/\/17aitech.com\/","name":"\u4e00\u8d77AI\u6280\u672f","description":"\u8ba9AI\u77e5\u8bc6\u89e6\u624b\u53ef\u53ca","alternateName":"\u4e00\u8d77AI\u6280\u672f","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/17aitech.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/17aitech.com\/#\/schema\/person\/3d23bb6f7f115fcefc9ae7803a691739","name":"Dongming","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"\/\/17aitech.com\/wp-content\/uploads\/member\/avatars\/238a0b923820dcc5.1732798681.jpg","url":"\/\/17aitech.com\/wp-content\/uploads\/member\/avatars\/238a0b923820dcc5.1732798681.jpg","contentUrl":"\/\/17aitech.com\/wp-content\/uploads\/member\/avatars\/238a0b923820dcc5.1732798681.jpg","caption":"Dongming"},"description":"\u89c1\u5929\u5730\uff0c\u89c1\u4f17\u751f\uff0c\u89c1\u81ea\u5df1\u3002","sameAs":["http:\/\/17aitech.com"],"url":"https:\/\/17aitech.com\/?page_id=33738&user=1"}]}},"_links":{"self":[{"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/posts\/26289","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/17aitech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=26289"}],"version-history":[{"count":6,"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/posts\/26289\/revisions"}],"predecessor-version":[{"id":33209,"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/posts\/26289\/revisions\/33209"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/17aitech.com\/index.php?rest_route=\/wp\/v2\/media\/28270"}],"wp:attachment":[{"href":"https:\/\/17aitech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=26289"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/17aitech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=26289"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/17aitech.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=26289"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}