\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357<\/title>\n<style>\n :root {\n --bg: #f8f9fb;\n --surface: #ffffff;\n --ink: #1a1a2e;\n --muted: #5a6578;\n --rule: #e2e5ea;\n --accent: #2563eb;\n --accent2: #059669;\n --code-bg: #1e293b;\n --code-text: #e2e8f0;\n --warn-bg: #fffbeb;\n --warn-border: #f59e0b;\n --err-bg: #fef2f2;\n --err-border: #ef4444;\n --ok-bg: #ecfdf5;\n --ok-border: #10b981;\n --info-bg: #eff6ff;\n --info-border: #3b82f6;\n --tip-bg: #f5f3ff;\n --tip-border: #8b5cf6;\n }\n * { margin: 0; padding: 0; box-sizing: border-box; }\n body {\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;\n background: var(--bg);\n color: var(--ink);\n line-height: 1.75;\n font-size: 15px;\n }\n .container { max-width: 900px; margin: 0 auto; padding: 2rem 1.25rem 3rem; }\n\n \/* Header *\/\n .page-header { margin-bottom: 2.5rem; text-align: center; }\n .page-header h1 { font-size: 1.8rem; font-weight: 800; letter-spacing: -0.02em; margin-bottom: 0.5rem; }\n .page-header p { color: var(--muted); font-size: 1rem; max-width: 600px; margin: 0 auto; }\n .badge { display: inline-block; background: var(--accent); color: white; padding: 0.25rem 0.75rem; border-radius: 999px; font-size: 0.75rem; font-weight: 600; margin-bottom: 0.8rem; text-transform: uppercase; letter-spacing: 0.05em; }\n\n \/* Cards *\/\n .card { background: var(--surface); border: 1px solid var(--rule); border-radius: 12px; padding: 1.75rem 2rem; margin-bottom: 1.5rem; }\n .card h2 { font-size: 1.25rem; font-weight: 700; margin-bottom: 1rem; padding-bottom: 0.5rem; border-bottom: 2px solid var(--accent); display: inline-block; }\n .card h3 { font-size: 1.05rem; font-weight: 600; margin: 1.5rem 0 0.5rem; color: var(--accent); }\n .card h3:first-child { margin-top: 0; }\n .card p, .card li { color: var(--muted); margin-bottom: 0.6rem; }\n .card ul, .card ol { padding-left: 1.5rem; margin-bottom: 0.75rem; }\n li { margin-bottom: 0.4rem; }\n\n \/* Step list with big numbers *\/\n .steps { counter-reset: step; list-style: none; padding-left: 0; }\n .steps li { counter-increment: step; position: relative; padding: 0.8rem 0 0.8rem 3rem; border-bottom: 1px solid var(--rule); margin-bottom: 0; }\n .steps li:last-child { border-bottom: none; }\n .steps li::before {\n content: counter(step);\n position: absolute; left: 0; top: 0.8rem;\n width: 2.1rem; height: 2.1rem; border-radius: 50%;\n background: var(--accent); color: #fff;\n font-size: 0.85rem; font-weight: 700;\n display: flex; align-items: center; justify-content: center;\n }\n\n \/* Command banner *\/\n .cmd-banner { display: flex; align-items: center; gap: 0.75rem; background: var(--code-bg); color: var(--code-text); padding: 0.85rem 1.25rem; border-radius: 8px; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.88rem; margin-bottom: 1rem; overflow-x: auto; }\n .cmd-banner .prompt { color: #6ee7b7; user-select: none; }\n .cmd-banner .cmd-text { white-space: nowrap; }\n\n \/* Code blocks *\/\n pre { background: var(--code-bg); color: var(--code-text); padding: 1.1rem 1.25rem; border-radius: 8px; overflow-x: auto; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.85rem; line-height: 1.6; margin: 0.75rem 0; }\n code { background: var(--bg); color: var(--accent); padding: 0.15rem 0.4rem; border-radius: 4px; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.87em; }\n pre code { background: transparent; color: inherit; padding: 0; }\n .code-comment { color: #94a3b8; }\n .code-keyword { color: #f472b6; }\n .code-string { color: #a5f3fc; }\n\n \/* Callouts *\/\n .callout { padding: 1rem 1.25rem; border-radius: 8px; margin: 1rem 0; border-left: 4px solid; }\n .callout.warn { background: var(--warn-bg); border-color: var(--warn-border); }\n .callout.err { background: var(--err-bg); border-color: var(--err-border); }\n .callout.ok { background: var(--ok-bg); border-color: var(--ok-border); }\n .callout.info { background: var(--info-bg); border-color: var(--info-border); }\n .callout.tip { background: var(--tip-bg); border-color: var(--tip-border); }\n .callout strong { display: block; margin-bottom: 0.3rem; color: var(--ink); }\n\n \/* Table *\/\n .table-wrap { overflow-x: auto; margin: 1rem 0; }\n table { width: 100%; border-collapse: collapse; font-size: 0.9rem; min-width: 500px; }\n th, td { padding: 0.65rem 0.9rem; text-align: left; border-bottom: 1px solid var(--rule); }\n th { background: var(--bg); font-weight: 600; color: var(--ink); white-space: nowrap; }\n tr:hover td { background: var(--bg); }\n\n \/* Two-column compare *\/\n .compare-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin: 1rem 0; }\n .compare-box { border: 1px solid var(--rule); border-radius: 8px; padding: 1.1rem; background: var(--surface); }\n .compare-box .box-title { font-weight: 700; font-size: 0.88rem; margin-bottom: 0.5rem; }\n\n \/* Tags *\/\n .tag { display: inline-block; padding: 0.18rem 0.55rem; border-radius: 4px; font-size: 0.78rem; font-weight: 600; margin-right: 0.3rem; }\n .tag-req { background: var(--accent); color: #fff; }\n .tag-opt { background: var(--accent2); color: #fff; }\n\n \/* Summary box *\/\n .summary-box { background: var(--surface); border: 2px solid var(--accent); border-radius: 12px; padding: 1.5rem 1.75rem; margin-top: 1.5rem; }\n .summary-box h2 { border-bottom-color: var(--accent2); margin-top: 0; }\n .summary-row { display: flex; gap: 1.5rem; margin: 0.75rem 0; align-items: flex-start; }\n .summary-row .s-label { flex-shrink: 0; font-weight: 700; font-size: 0.9rem; color: var(--accent); min-width: 120px; }\n .summary-row .s-desc { color: var(--muted); font-size: 0.92rem; }\n\n \/* Footer *\/\n footer { text-align: center; color: var(--muted); font-size: 0.8rem; margin-top: 2rem; padding-top: 1rem; border-top: 1px solid var(--rule); }\n\n \/* Responsive *\/\n @media (max-width: 640px) {\n .compare-grid { grid-template-columns: 1fr; }\n .summary-row { flex-direction: column; gap: 0.4rem; }\n .page-header h1 { font-size: 1.5rem; }\n .card { padding: 1.25rem 1.5rem; }\n }\n<\/style>\n<\/head>\n<body>\n<div class=\"container\">\n\n <div class=\"page-header\">\n <span class=\"badge\">GitHub \u5165\u95e8\u6559\u7a0b<\/span>\n <h1>\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357<\/h1>\n <p>\u8986\u76d6\u4ece\u6ce8\u518c GitHub \u8d26\u53f7\u3001\u514b\u9686\u9879\u76ee\u3001\u5b89\u88c5\u4f9d\u8d56\u5230\u8fd0\u884c\u9879\u76ee\u7684\u5b8c\u6574\u6d41\u7a0b\uff0c\u65e0\u9700\u4efb\u4f55\u524d\u7f6e\u7ecf\u9a8c<\/p>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e00\uff1a\u51c6\u5907\u5de5\u4f5c<\/h2>\n\n <h3>1.1 \u6ce8\u518c GitHub \u8d26\u53f7<\/h3>\n <p>\u5982\u679c\u5c1a\u672a\u62e5\u6709 GitHub \u8d26\u53f7\uff0c\u9700\u8981\u5148\u5728\u5b98\u7f51\u6ce8\u518c\uff1a<\/p>\n <ol>\n <li>\u8bbf\u95ee <a href=\"https:\/\/github.com\" target=\"_blank\">github.com<\/a><\/li>\n <li>\u70b9\u51fb\u53f3\u4e0a\u89d2 <strong>Sign up<\/strong>\uff0c\u6309\u63d0\u793a\u586b\u5199\u90ae\u7bb1\u3001\u5bc6\u7801\u3001\u7528\u6237\u540d<\/li>\n <li>\u5b8c\u6210\u90ae\u7bb1\u9a8c\u8bc1<\/li>\n <\/ol>\n <div class=\"callout tip\">\n <strong>\u63d0\u793a<\/strong>\n GitHub \u5728\u56fd\u5185\u8bbf\u95ee\u53ef\u80fd\u4e0d\u7a33\u5b9a\uff0c\u5982\u9047\u52a0\u8f7d\u7f13\u6162\u6216\u6253\u4e0d\u5f00\uff0c\u53ef\u5c1d\u8bd5\u4f7f\u7528\u7f51\u7edc\u52a0\u901f\u5de5\u5177\u6216\u955c\u50cf\u7ad9\u70b9\u3002\n <\/div>\n\n <h3>1.2 \u5b89\u88c5 Git<\/h3>\n <p>Git \u662f\u4e0b\u8f7d\u548c\u7ba1\u7406\u4ee3\u7801\u7248\u672c\u7684\u6838\u5fc3\u5de5\u5177\uff0c\u9700\u8981\u5728\u672c\u5730\u5148\u5b89\u88c5\u3002<\/p>\n\n <p><strong>Windows \u7528\u6237\uff1a<\/strong><\/p>\n <ol>\n <li>\u8bbf\u95ee <a href=\"https:\/\/git-scm.com\/downloads\" target=\"_blank\">git-scm.com\/downloads<\/a><\/li>\n <li>\u4e0b\u8f7d Windows \u7248\u672c\u5b89\u88c5\u5305\uff0c\u53cc\u51fb\u8fd0\u884c<\/li>\n <li>\u5b89\u88c5\u8fc7\u7a0b\u4e2d\u4fdd\u6301\u9ed8\u8ba4\u9009\u9879\u5373\u53ef\uff0c\u4e00\u8def\u70b9\u51fb <strong>Next<\/strong> \u5230\u5b8c\u6210<\/li>\n <li>\u5b89\u88c5\u5b8c\u6210\u540e\uff0c\u9a8c\u8bc1\u662f\u5426\u6210\u529f\uff1a<\/li>\n <\/ol>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git –version<\/span>\n <\/div>\n <p>\u82e5\u770b\u5230\u7c7b\u4f3c <code>git version 2.43.0<\/code> \u7684\u8f93\u51fa\uff0c\u8bf4\u660e\u5b89\u88c5\u6210\u529f\u3002<\/p>\n\n <p><strong>macOS \u7528\u6237\uff1a<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git –version<\/span>\n <\/div>\n <p>\u82e5\u7cfb\u7edf\u63d0\u793a\u672a\u5b89\u88c5\uff0c\u6309\u63d0\u793a\u81ea\u52a8\u5b89\u88c5\u6216\u5148\u5b89\u88c5 <a href=\"https:\/\/brew.sh\/\" target=\"_blank\">Homebrew<\/a> \u540e\u6267\u884c\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">brew install git<\/span>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e8c\uff1a\u5728 GitHub \u4e0a\u627e\u5230\u76ee\u6807\u9879\u76ee<\/h2>\n\n <h3>2.1 \u641c\u7d22\u9879\u76ee<\/h3>\n <p>GitHub \u63d0\u4f9b\u591a\u79cd\u65b9\u5f0f\u67e5\u627e\u9879\u76ee\uff1a<\/p>\n <ul>\n <li><strong>\u641c\u7d22\u680f<\/strong>\uff1a\u76f4\u63a5\u5728 GitHub \u9996\u9875\u9876\u90e8\u8f93\u5165\u5173\u952e\u8bcd\uff08\u5982 <code>python geological modeling<\/code>\uff09<\/li>\n <li><strong>\u4ed6\u4eba\u63a8\u8350<\/strong>\uff1a\u4ece\u535a\u5ba2\u3001\u6559\u7a0b\u3001\u8bba\u6587\u4e2d\u83b7\u53d6\u9879\u76ee\u94fe\u63a5<\/li>\n <li><strong>Awesome \u5217\u8868<\/strong>\uff1a\u641c\u7d22 <code>awesome-xxx<\/code> \u5173\u952e\u8bcd\uff08\u5982 <code>awesome-python<\/code>\uff09\u83b7\u53d6\u7cbe\u9009\u9879\u76ee\u5408\u96c6<\/li>\n <\/ul>\n\n <h3>2.2 \u8bc6\u522b\u9879\u76ee\u8d28\u91cf<\/h3>\n <p>\u6253\u5f00\u9879\u76ee\u4e3b\u9875\u540e\uff0c\u5173\u6ce8\u4ee5\u4e0b\u51e0\u4e2a\u6307\u6807\u5224\u65ad\u9879\u76ee\u662f\u5426\u53ef\u9760\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u6307\u6807<\/th><th>\u542b\u4e49<\/th><th>\u5efa\u8bae<\/th><\/tr>\n <tr><td>Stars<\/td><td>\u70b9\u8d5e\u6570\uff0c\u4ee3\u8868\u9879\u76ee\u53d7\u6b22\u8fce\u7a0b\u5ea6<\/td><td>100+ \u901a\u5e38\u8bf4\u660e\u9879\u76ee\u6709\u4e00\u5b9a\u8d28\u91cf<\/td><\/tr>\n <tr><td>Last Updated<\/td><td>\u6700\u540e\u66f4\u65b0\u65f6\u95f4<\/td><td>\u8fd1\u671f\u6709\u66f4\u65b0\u8bf4\u660e\u9879\u76ee\u4ecd\u5728\u7ef4\u62a4<\/td><\/tr>\n <tr><td>README<\/td><td>\u9879\u76ee\u8bf4\u660e\u6587\u6863<\/td><td>\u6587\u6863\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u5bb9\u6613\u4e0a\u624b<\/td><\/tr>\n <tr><td>Issues<\/td><td>\u95ee\u9898\u53cd\u9988\u533a<\/td><td>\u5927\u91cf\u672a\u5173\u95ed\u7684\u4e25\u91cd\u95ee\u9898\u9700\u8c28\u614e<\/td><\/tr>\n <tr><td>License<\/td><td>\u5f00\u6e90\u8bb8\u53ef\u8bc1<\/td><td>MIT \/ Apache 2.0 \/ GPL \u7b49\u5141\u8bb8\u4f7f\u7528<\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>2.3 \u83b7\u53d6\u4ed3\u5e93\u5730\u5740<\/h3>\n <p>\u8fdb\u5165\u9879\u76ee\u4e3b\u9875\u540e\uff0c\u70b9\u51fb\u7eff\u8272\u7684 <strong>Code<\/strong> \u6309\u94ae\uff0c\u4f1a\u5f39\u51fa\u4e0b\u8f7d\u5730\u5740\u9009\u9879\u3002\u901a\u5e38\u6709\u4e24\u79cd\u65b9\u5f0f\uff1a<\/p>\n <div class=\"compare-grid\">\n <div class=\"compare-box\">\n <div class=\"box-title\">HTTPS \u5730\u5740\uff08\u63a8\u8350\u65b0\u624b\uff09<\/div>\n <pre><code>https:\/\/github.com\/\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/code><\/pre>\n <p style=\"font-size:0.85rem; color:var(--muted); margin-top:0.5rem;\">\u65e0\u9700\u914d\u7f6e SSH \u5bc6\u94a5\uff0c\u6bcf\u6b21\u4e0b\u8f7d\u65f6\u8f93\u5165\u7528\u6237\u540d\u548c\u5bc6\u7801\u5373\u53ef\u3002\u8fd1\u5e74\u6765 GitHub \u5df2\u6539\u7528 Personal Access Token \u4ee3\u66ff\u5bc6\u7801\u3002<\/p>\n <\/div>\n <div class=\"compare-box\">\n <div class=\"box-title\">SSH \u5730\u5740\uff08\u63a8\u8350\u957f\u671f\u5f00\u53d1\u8005\uff09<\/div>\n <pre><code>git@github.com:\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/code><\/pre>\n <p style=\"font-size:0.85rem; color:var(--muted); margin-top:0.5rem;\">\u9700\u5148\u5728\u672c\u5730\u914d\u7f6e SSH \u5bc6\u94a5\uff0c\u914d\u7f6e\u5b8c\u6210\u540e\u65e0\u9700\u91cd\u590d\u8f93\u5165\u5bc6\u7801\uff0c\u66f4\u65b9\u4fbf\u3002<\/p>\n <\/div>\n <\/div>\n\n <div class=\"callout info\">\n <strong>HTTPS \u65b9\u5f0f\u83b7\u53d6 Token \u7684\u6b65\u9aa4<\/strong>\n <ol style=\"margin-top:0.5rem;\">\n <li>GitHub \u5934\u50cf \u2192 Settings \u2192 Developer settings \u2192 Personal access tokens \u2192 Tokens (classic)<\/li>\n <li>\u70b9\u51fb Generate new token\uff0c\u52fe\u9009 <code>repo<\/code> \u6743\u9650<\/li>\n <li>\u751f\u6210\u540e\u590d\u5236\u4ee4\u724c\uff0c\u5728\u547d\u4ee4\u884c\u63d0\u793a\u8f93\u5165\u5bc6\u7801\u65f6\u7c98\u8d34\u8be5\u4ee4\u724c\u5373\u53ef<\/li>\n <\/ol>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e09\uff1a\u5c06\u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730<\/h2>\n\n <h3>3.1 \u6253\u5f00\u7ec8\u7aef\uff08\u547d\u4ee4\u884c\uff09<\/h3>\n <ul>\n <li><strong>Windows<\/strong>\uff1a\u6309 <code>Win + R<\/code> \u8f93\u5165 <code>cmd<\/code> \u6216 <code>powershell<\/code> \u56de\u8f66\uff1b\u6216\u53f3\u952e\u5f00\u59cb\u83dc\u5355\u9009\u62e9 “Windows Terminal”<\/li>\n <li><strong>macOS<\/strong>\uff1a\u6309 <code>Cmd + \u7a7a\u683c<\/code> \u641c\u7d22 “Terminal”<\/li>\n <\/ul>\n\n <h3>3.2 \u9009\u62e9\u5b58\u653e\u76ee\u5f55<\/h3>\n <p>\u5efa\u8bae\u5c06\u9879\u76ee\u5b58\u653e\u5728\u4e13\u95e8\u7684\u5de5\u4f5c\u76ee\u5f55\u4e2d\uff0c\u4f8b\u5982\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">cd D:\\Projects<\/span>\n <\/div>\n <p>\uff08Windows \u4f7f\u7528\u53cd\u659c\u6760 <code>\\<\/code> \u6216\u6b63\u659c\u6760 <code>\/<\/code> \u5747\u53ef\uff09<\/p>\n\n <h3>3.3 \u6267\u884c\u514b\u9686\u547d\u4ee4<\/h3>\n <p>\u590d\u5236 GitHub \u4e0a\u7684 HTTPS \u5730\u5740\uff0c\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git clone https:\/\/github.com\/\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/span>\n <\/div>\n <p>\u82e5\u4f7f\u7528 SSH \u5730\u5740\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git clone git@github.com:\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/span>\n <\/div>\n\n <p>\u6210\u529f\u540e\u4f1a\u770b\u5230\u7c7b\u4f3c\u8f93\u51fa\uff1a<\/p>\n <pre><code>Cloning into '\u9879\u76ee\u540d'...\nremote: Enumerating objects: 1234, done.\nremote: Total 1234 (delta 0), reused 0 (delta 0), pack-reused 1234\nReceiving objects: 100% (1234\/1234), 5.67 MiB | 2.10 MiB\/s, done.\nResolving deltas: 100% (567\/567), done.<\/code><\/pre>\n\n <h3>3.4 \u8fdb\u5165\u9879\u76ee\u76ee\u5f55<\/h3>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">cd \u9879\u76ee\u540d<\/span>\n <\/div>\n\n <div class=\"callout ok\">\n <strong>\u5b8c\u6210\u9a8c\u8bc1<\/strong>\n \u6267\u884c <code>ls<\/code>\uff08macOS\/Linux\uff09\u6216 <code>dir<\/code>\uff08Windows\uff09\u67e5\u770b\u76ee\u5f55\u5185\u5bb9\uff0c\u82e5\u80fd\u770b\u5230\u9879\u76ee\u6587\u4ef6\uff08\u5982 README.md\u3001src \u6587\u4ef6\u5939\u7b49\uff09\uff0c\u8bf4\u660e\u4e0b\u8f7d\u6210\u529f\u3002\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u56db\uff1a\u5b89\u88c5\u9879\u76ee\u4f9d\u8d56<\/h2>\n\n <h3>4.1 \u68c0\u67e5 Python \u73af\u5883<\/h3>\n <p>\u5927\u591a\u6570\u9879\u76ee\u9700\u8981 Python \u73af\u5883\u8fd0\u884c\u3002\u5148\u786e\u8ba4\u662f\u5426\u5df2\u5b89\u88c5 Python\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">python –version<\/span>\n <\/div>\n <p>\u82e5\u663e\u793a\u7248\u672c\u53f7\uff08\u5982 <code>Python 3.11.4<\/code>\uff09\uff0c\u8bf4\u660e\u5df2\u5b89\u88c5\u3002\u82e5\u672a\u5b89\u88c5\uff0c\u8bbf\u95ee <a href=\"https:\/\/www.python.org\/downloads\/\" target=\"_blank\">python.org<\/a> \u4e0b\u8f7d\u5b89\u88c5\u3002<\/p>\n\n <h3>4.2 \u521b\u5efa\u865a\u62df\u73af\u5883\uff08\u5f3a\u70c8\u63a8\u8350\uff09<\/h3>\n <p>\u865a\u62df\u73af\u5883\u53ef\u9694\u79bb\u4e0d\u540c\u9879\u76ee\u7684\u4f9d\u8d56\uff0c\u907f\u514d\u7248\u672c\u51b2\u7a81\u3002\u5728\u9879\u76ee\u76ee\u5f55\u5185\u6267\u884c\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">python -m venv venv<\/span>\n <\/div>\n <p>\u521b\u5efa\u5b8c\u6210\u540e\uff0c\u6fc0\u6d3b\u865a\u62df\u73af\u5883\uff1a<\/p>\n\n <div class=\"compare-grid\">\n <div class=\"compare-box\">\n <div class=\"box-title\">Windows<\/div>\n <div class=\"cmd-banner\" style=\"margin-bottom:0;\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">venv\\Scripts\\activate<\/span>\n <\/div>\n <\/div>\n <div class=\"compare-box\">\n <div class=\"box-title\">macOS \/ Linux<\/div>\n <div class=\"cmd-banner\" style=\"margin-bottom:0;\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">source venv\/bin\/activate<\/span>\n <\/div>\n <\/div>\n <\/div>\n\n <p>\u6fc0\u6d3b\u6210\u529f\u540e\uff0c\u547d\u4ee4\u884c\u63d0\u793a\u7b26\u524d\u4f1a\u51fa\u73b0 <code>(venv)<\/code> \u6807\u8bb0\uff1a<\/p>\n <pre><code>(venv) D:\\Projects\\\u9879\u76ee\u540d><\/code><\/pre>\n\n <h3>4.3 \u67e5\u770b\u9879\u76ee\u4f9d\u8d56\u6587\u4ef6<\/h3>\n <p>\u9879\u76ee\u901a\u5e38\u4f1a\u5728\u4ee5\u4e0b\u6587\u4ef6\u4e2d\u5217\u51fa\u4f9d\u8d56\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u6587\u4ef6<\/th><th>\u5b89\u88c5\u547d\u4ee4<\/th><th>\u8bf4\u660e<\/th><\/tr>\n <tr><td><code>requirements.txt<\/code><\/td><td><code>pip install -r requirements.txt<\/code><\/td><td>\u6700\u5e38\u89c1\u7684\u4f9d\u8d56\u6e05\u5355<\/td><\/tr>\n <tr><td><code>pyproject.toml<\/code><\/td><td><code>pip install -e .<\/code><\/td><td>\u73b0\u4ee3 Python \u9879\u76ee\u6807\u51c6<\/td><\/tr>\n <tr><td><code>setup.py<\/code><\/td><td><code>pip install -e .<\/code><\/td><td>\u4f20\u7edf\u5b89\u88c5\u65b9\u5f0f<\/td><\/tr>\n <tr><td><code>environment.yml<\/code><\/td><td><code>conda env create -f environment.yml<\/code><\/td><td>Conda \u73af\u5883\u9879\u76ee<\/td><\/tr>\n <\/table>\n <\/div>\n\n <p>\u67e5\u770b\u9879\u76ee\u76ee\u5f55\u4e2d\u6709\u54ea\u4e9b\u6587\u4ef6\uff0c\u4f18\u5148\u627e <code>requirements.txt<\/code> \u6216 <code>pyproject.toml<\/code>\u3002<\/p>\n\n <h3>4.4 \u5b89\u88c5\u4f9d\u8d56<\/h3>\n\n <p><strong>\u60c5\u51b5 A\uff1a\u53ea\u6709 requirements.txt<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip install -r requirements.txt<\/span>\n <\/div>\n\n <p><strong>\u60c5\u51b5 B\uff1a\u6709 pyproject.toml \u4e14\u9700\u8981\u672c\u5730\u5f00\u53d1<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip install -r requirements.txt -e .<\/span>\n <\/div>\n <div class=\"callout info\">\n <strong>\u8bf4\u660e<\/strong>\n <code>-r requirements.txt<\/code> \u5b89\u88c5\u7b2c\u4e09\u65b9\u5e93\uff1b<code>-e .<\/code> \u4ee5\u53ef\u7f16\u8f91\u6a21\u5f0f\u5b89\u88c5\u9879\u76ee\u672c\u8eab\uff0c\u4f7f\u5f97\u4fee\u6539\u4ee3\u7801\u540e\u65e0\u9700\u91cd\u65b0\u5b89\u88c5\u5373\u53ef\u751f\u6548\u3002\n <\/div>\n\n <p><strong>\u60c5\u51b5 C\uff1a\u4f7f\u7528 Conda \u73af\u5883<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">conda env create -f environment.yml<\/span>\n <\/div>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">conda activate \u73af\u5883\u540d<\/span>\n <\/div>\n\n <h3>4.5 \u9a8c\u8bc1\u4f9d\u8d56\u5b89\u88c5<\/h3>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip list<\/span>\n <\/div>\n <p>\u67e5\u770b\u5217\u8868\u4e2d\u662f\u5426\u5305\u542b\u4e86\u9879\u76ee\u6240\u9700\u7684\u4f9d\u8d56\u5305\uff08\u5982 numpy\u3001pandas\u3001requests \u7b49\uff09\u3002<\/p>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e94\uff1a\u8fd0\u884c\u9879\u76ee<\/h2>\n\n <h3>5.1 \u9605\u8bfb\u9879\u76ee README<\/h3>\n <p>\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u7684 <code>README.md<\/code> \u662f\u4f7f\u7528\u8bf4\u660e\u4e66\uff0c\u901a\u5e38\u5305\u542b\uff1a<\/p>\n <ul>\n <li>\u9879\u76ee\u529f\u80fd\u7b80\u4ecb<\/li>\n <li>\u5b89\u88c5\u6b65\u9aa4<\/li>\n <li>\u5feb\u901f\u5f00\u59cb\u793a\u4f8b\uff08Quick Start\uff09<\/li>\n <li>\u4f7f\u7528\u65b9\u6cd5\u548c\u53c2\u6570\u8bf4\u660e<\/li>\n <\/ul>\n <p>\u53ef\u901a\u8fc7\u547d\u4ee4\u884c\u67e5\u770b\uff0c\u6216\u5728 GitHub \u7f51\u9875\u4e0a\u76f4\u63a5\u9605\u8bfb\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">type README.md<\/span>\n <\/div>\n <p>\uff08macOS\/Linux \u4f7f\u7528 <code>cat README.md<\/code>\uff09<\/p>\n\n <h3>5.2 \u5bfb\u627e\u5165\u53e3\u6587\u4ef6<\/h3>\n <p>\u4e0d\u540c\u9879\u76ee\u6709\u4e0d\u540c\u7684\u8fd0\u884c\u65b9\u5f0f\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9879\u76ee\u7c7b\u578b<\/th><th>\u5178\u578b\u5165\u53e3<\/th><th>\u8fd0\u884c\u65b9\u5f0f<\/th><\/tr>\n <tr><td>Python \u811a\u672c<\/td><td><code>main.py<\/code> \/ <code>run.py<\/code><\/td><td><code>python main.py<\/code><\/td><\/tr>\n <tr><td>\u547d\u4ee4\u884c\u5de5\u5177<\/td><td><code>__main__.py<\/code><\/td><td><code>python -m \u5305\u540d<\/code><\/td><\/tr>\n <tr><td>Web \u5e94\u7528<\/td><td><code>app.py<\/code> \/ <code>manage.py<\/code><\/td><td><code>python app.py<\/code> \u6216 <code>flask run<\/code><\/td><\/tr>\n <tr><td>Jupyter Notebook<\/td><td><code>examples\/*.ipynb<\/code><\/td><td><code>jupyter notebook<\/code><\/td><\/tr>\n <tr><td>Node.js \u9879\u76ee<\/td><td><code>package.json<\/code><\/td><td><code>npm install && npm start<\/code><\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>5.3 \u8fd0\u884c\u793a\u4f8b<\/h3>\n <p>\u4ee5\u5178\u578b\u7684 Python \u9879\u76ee\u4e3a\u4f8b\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">python examples\/demo.py<\/span>\n <\/div>\n <p>\u82e5\u9879\u76ee\u63d0\u4f9b\u547d\u4ee4\u884c\u5de5\u5177\u5165\u53e3\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">python -m \u9879\u76ee\u540d –help<\/span>\n <\/div>\n\n <div class=\"callout ok\">\n <strong>\u8fd0\u884c\u6210\u529f\u6807\u5fd7<\/strong>\n \u82e5\u770b\u5230\u9884\u671f\u7684\u8f93\u51fa\u7ed3\u679c\uff08\u5982\u8ba1\u7b97\u7ed3\u679c\u3001\u56fe\u8868\u3001\u7f51\u9875\u670d\u52a1\u7b49\uff09\uff0c\u8bf4\u660e\u9879\u76ee\u5df2\u6b63\u5e38\u8fd0\u884c\u3002\u82e5\u9047\u5230\u9519\u8bef\uff0c\u67e5\u770b\u4e0b\u65b9\u7684\u5e38\u89c1\u95ee\u9898\u6392\u67e5\u3002\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u516d\uff1a\u5e38\u89c1\u95ee\u9898\u6392\u67e5<\/h2>\n\n <h3>6.1 \u514b\u9686\u5931\u8d25<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>Could not resolve host<\/code><\/td><td>\u7f51\u7edc\u95ee\u9898<\/td><td>\u68c0\u67e5\u7f51\u7edc\u8fde\u63a5\uff0c\u5c1d\u8bd5\u4f7f\u7528\u4ee3\u7406\u6216\u52a0\u901f\u5668<\/td><\/tr>\n <tr><td><code>Authentication failed<\/code><\/td><td>\u6743\u9650\u6216 Token \u9519\u8bef<\/td><td>\u786e\u8ba4 HTTPS \u5730\u5740\u6b63\u786e\uff0c\u6216\u91cd\u65b0\u751f\u6210 Personal Access Token<\/td><\/tr>\n <tr><td><code>Permission denied (publickey)<\/code><\/td><td>SSH \u5bc6\u94a5\u672a\u914d\u7f6e<\/td><td>\u5207\u6362\u5230 HTTPS \u5730\u5740\uff0c\u6216\u914d\u7f6e SSH \u5bc6\u94a5<\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>6.2 \u4f9d\u8d56\u5b89\u88c5\u5931\u8d25<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>No module named 'xxx'<\/code><\/td><td>\u4f9d\u8d56\u672a\u5b89\u88c5<\/td><td><code>pip install xxx<\/code><\/td><\/tr>\n <tr><td><code>Could not find a version<\/code><\/td><td>Python \u7248\u672c\u4e0d\u517c\u5bb9<\/td><td>\u68c0\u67e5 README \u8981\u6c42\u7684 Python \u7248\u672c\uff0c\u521b\u5efa\u5bf9\u5e94\u7248\u672c\u865a\u62df\u73af\u5883<\/td><\/tr>\n <tr><td><code>Failed building wheel<\/code><\/td><td>\u7f3a\u5c11\u7f16\u8bd1\u5de5\u5177<\/td><td>Windows \u5b89\u88c5 <a href=\"https:\/\/visualstudio.microsoft.com\/visual-cpp-build-tools\/\" target=\"_blank\">C++ Build Tools<\/a><\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>6.3 \u8fd0\u884c\u65f6\u62a5\u9519<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>ModuleNotFoundError<\/code><\/td><td>\u6a21\u5757\u672a\u5b89\u88c5\u6216\u8def\u5f84\u95ee\u9898<\/td><td>\u786e\u8ba4\u865a\u62df\u73af\u5883\u5df2\u6fc0\u6d3b\uff0c\u91cd\u65b0\u6267\u884c <code>pip install<\/code><\/td><\/tr>\n <tr><td><code>FileNotFoundError<\/code><\/td><td>\u7f3a\u5c11\u6570\u636e\u6587\u4ef6\u6216\u914d\u7f6e\u6587\u4ef6<\/td><td>\u68c0\u67e5 README \u4e2d\u662f\u5426\u9700\u8981\u4e0b\u8f7d\u989d\u5916\u6570\u636e\u6216\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf<\/td><\/tr>\n <tr><td><code>Port already in use<\/code><\/td><td>\u7aef\u53e3\u88ab\u5360\u7528<\/td><td>\u5173\u95ed\u5360\u7528\u7aef\u53e3\u7684\u7a0b\u5e8f\uff0c\u6216\u4fee\u6539\u9879\u76ee\u914d\u7f6e\u6587\u4ef6\u4e2d\u7684\u7aef\u53e3\u53f7<\/td><\/tr>\n <\/table>\n <\/div>\n\n <div class=\"callout tip\">\n <strong>\u4e07\u80fd\u6392\u67e5\u987a\u5e8f<\/strong>\n <ol style=\"margin-top:0.5rem;\">\n <li>\u786e\u8ba4\u865a\u62df\u73af\u5883\u5df2\u6fc0\u6d3b\uff08\u63d0\u793a\u7b26\u524d\u6709 <code>(venv)<\/code>\uff09<\/li>\n <li>\u786e\u8ba4\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u6267\u884c\u547d\u4ee4<\/li>\n <li>\u91cd\u65b0\u9605\u8bfb README \u4e2d\u7684\u5b89\u88c5\u548c\u8fd0\u884c\u8bf4\u660e<\/li>\n <li>\u67e5\u770b\u9879\u76ee\u7684 Issues \u9875\u9762\u662f\u5426\u6709\u4eba\u9047\u5230\u76f8\u540c\u95ee\u9898<\/li>\n <\/ol>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e03\uff1a\u8fdb\u9636\u4f7f\u7528\uff08\u53ef\u9009\uff09<\/h2>\n\n <h3>7.1 \u4fdd\u6301\u9879\u76ee\u66f4\u65b0<\/h3>\n <p>\u82e5\u9879\u76ee\u6709\u66f4\u65b0\uff0c\u53ef\u901a\u8fc7\u4ee5\u4e0b\u547d\u4ee4\u540c\u6b65\u6700\u65b0\u4ee3\u7801\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git pull origin main<\/span>\n <\/div>\n <p>\uff08\u82e5\u4e3b\u5206\u652f\u540d\u4e3a <code>master<\/code>\uff0c\u5219\u66ff\u6362\u4e3a <code>master<\/code>\uff09<\/p>\n\n <h3>7.2 \u5207\u6362\u9879\u76ee\u7248\u672c<\/h3>\n <p>\u67d0\u4e9b\u9879\u76ee\u9700\u8981\u7279\u5b9a\u7248\u672c\uff08\u5982\u8bba\u6587\u590d\u73b0\uff09\uff0c\u53ef\u67e5\u770b\u7248\u672c\u6807\u7b7e\u5e76\u5207\u6362\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git tag<\/span>\n <\/div>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git checkout v1.0.0<\/span>\n <\/div>\n\n <h3>7.3 \u9000\u51fa\u865a\u62df\u73af\u5883<\/h3>\n <p>\u4f7f\u7528\u5b8c\u6bd5\u540e\uff0c\u9000\u51fa\u865a\u62df\u73af\u5883\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">deactivate<\/span>\n <\/div>\n <\/div>\n\n \n <div class=\"summary-box\">\n <h2>\u5b8c\u6574\u6d41\u7a0b\u901f\u67e5<\/h2>\n <div class=\"summary-row\"><div class=\"s-label\">\u51c6\u5907<\/div><div class=\"s-desc\">\u6ce8\u518c GitHub \u8d26\u53f7 \u2192 \u5b89\u88c5 Git \u2192 \u5b89\u88c5 Python<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u67e5\u627e<\/div><div class=\"s-desc\">\u5728 GitHub \u641c\u7d22\u9879\u76ee \u2192 \u68c0\u67e5 Stars \u548c README \u8d28\u91cf \u2192 \u590d\u5236\u4ed3\u5e93\u5730\u5740<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u4e0b\u8f7d<\/div><div class=\"s-desc\">\u6253\u5f00\u7ec8\u7aef \u2192 \u9009\u62e9\u76ee\u5f55 \u2192 <code>git clone \u5730\u5740<\/code> \u2192 \u8fdb\u5165\u9879\u76ee\u76ee\u5f55<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u914d\u7f6e<\/div><div class=\"s-desc\">\u521b\u5efa\u865a\u62df\u73af\u5883 <code>python -m venv venv<\/code> \u2192 \u6fc0\u6d3b \u2192 \u5b89\u88c5\u4f9d\u8d56<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u8fd0\u884c<\/div><div class=\"s-desc\">\u9605\u8bfb README \u2192 \u627e\u5230\u5165\u53e3\u6587\u4ef6 \u2192 \u6267\u884c\u8fd0\u884c\u547d\u4ee4<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u7ef4\u62a4<\/div><div class=\"s-desc\"><code>git pull<\/code> \u66f4\u65b0\u4ee3\u7801 \u2192 \u9047\u5230\u95ee\u9898\u67e5\u770b Issues \u2192 \u5fc5\u8981\u65f6\u5207\u6362\u7248\u672c<\/div><\/div>\n <\/div>\n\n <footer>\n <p>\u57fa\u4e8e Git \u5b98\u65b9\u6587\u6863\u4e0e Python \u6253\u5305\u6307\u5357\u6574\u7406<\/p>\n <\/footer>\n\n<\/div>\n<\/body>\n<\/html>\n\n","protected":false},"excerpt":{"rendered":"<p>\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357 GitHub \u5165\u95e8\u6559\u7a0b \u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11,9],"tags":[],"class_list":["post-304","post","type-post","status-publish","format-standard","hentry","category-cad","category-ai"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=304"}],"version-history":[{"count":1,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304\/revisions"}],"predecessor-version":[{"id":305,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304\/revisions\/305"}],"wp:attachment":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=304"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=304"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=304"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{"id":304,"date":"2026-07-06T08:07:32","date_gmt":"2026-07-06T00:07:32","guid":{"rendered":"https:\/\/numsimlab.com\/?p=304"},"modified":"2026-07-06T08:07:32","modified_gmt":"2026-07-06T00:07:32","slug":"%e4%bb%8e%e9%9b%b6%e5%bc%80%e5%a7%8b%ef%bc%9agithub-%e9%a1%b9%e7%9b%ae%e4%b8%8b%e8%bd%bd%e5%88%b0%e6%9c%ac%e5%9c%b0%e4%bd%bf%e7%94%a8%e5%ae%8c%e6%95%b4%e6%8c%87%e5%8d%97","status":"publish","type":"post","link":"https:\/\/numsimlab.com\/?p=304","title":{"rendered":"\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357"},"content":{"rendered":"\n\n\n\n\n\n\n\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357<\/title>\n<style>\n :root {\n --bg: #f8f9fb;\n --surface: #ffffff;\n --ink: #1a1a2e;\n --muted: #5a6578;\n --rule: #e2e5ea;\n --accent: #2563eb;\n --accent2: #059669;\n --code-bg: #1e293b;\n --code-text: #e2e8f0;\n --warn-bg: #fffbeb;\n --warn-border: #f59e0b;\n --err-bg: #fef2f2;\n --err-border: #ef4444;\n --ok-bg: #ecfdf5;\n --ok-border: #10b981;\n --info-bg: #eff6ff;\n --info-border: #3b82f6;\n --tip-bg: #f5f3ff;\n --tip-border: #8b5cf6;\n }\n * { margin: 0; padding: 0; box-sizing: border-box; }\n body {\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;\n background: var(--bg);\n color: var(--ink);\n line-height: 1.75;\n font-size: 15px;\n }\n .container { max-width: 900px; margin: 0 auto; padding: 2rem 1.25rem 3rem; }\n\n \/* Header *\/\n .page-header { margin-bottom: 2.5rem; text-align: center; }\n .page-header h1 { font-size: 1.8rem; font-weight: 800; letter-spacing: -0.02em; margin-bottom: 0.5rem; }\n .page-header p { color: var(--muted); font-size: 1rem; max-width: 600px; margin: 0 auto; }\n .badge { display: inline-block; background: var(--accent); color: white; padding: 0.25rem 0.75rem; border-radius: 999px; font-size: 0.75rem; font-weight: 600; margin-bottom: 0.8rem; text-transform: uppercase; letter-spacing: 0.05em; }\n\n \/* Cards *\/\n .card { background: var(--surface); border: 1px solid var(--rule); border-radius: 12px; padding: 1.75rem 2rem; margin-bottom: 1.5rem; }\n .card h2 { font-size: 1.25rem; font-weight: 700; margin-bottom: 1rem; padding-bottom: 0.5rem; border-bottom: 2px solid var(--accent); display: inline-block; }\n .card h3 { font-size: 1.05rem; font-weight: 600; margin: 1.5rem 0 0.5rem; color: var(--accent); }\n .card h3:first-child { margin-top: 0; }\n .card p, .card li { color: var(--muted); margin-bottom: 0.6rem; }\n .card ul, .card ol { padding-left: 1.5rem; margin-bottom: 0.75rem; }\n li { margin-bottom: 0.4rem; }\n\n \/* Step list with big numbers *\/\n .steps { counter-reset: step; list-style: none; padding-left: 0; }\n .steps li { counter-increment: step; position: relative; padding: 0.8rem 0 0.8rem 3rem; border-bottom: 1px solid var(--rule); margin-bottom: 0; }\n .steps li:last-child { border-bottom: none; }\n .steps li::before {\n content: counter(step);\n position: absolute; left: 0; top: 0.8rem;\n width: 2.1rem; height: 2.1rem; border-radius: 50%;\n background: var(--accent); color: #fff;\n font-size: 0.85rem; font-weight: 700;\n display: flex; align-items: center; justify-content: center;\n }\n\n \/* Command banner *\/\n .cmd-banner { display: flex; align-items: center; gap: 0.75rem; background: var(--code-bg); color: var(--code-text); padding: 0.85rem 1.25rem; border-radius: 8px; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.88rem; margin-bottom: 1rem; overflow-x: auto; }\n .cmd-banner .prompt { color: #6ee7b7; user-select: none; }\n .cmd-banner .cmd-text { white-space: nowrap; }\n\n \/* Code blocks *\/\n pre { background: var(--code-bg); color: var(--code-text); padding: 1.1rem 1.25rem; border-radius: 8px; overflow-x: auto; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.85rem; line-height: 1.6; margin: 0.75rem 0; }\n code { background: var(--bg); color: var(--accent); padding: 0.15rem 0.4rem; border-radius: 4px; font-family: \"SF Mono\", Monaco, \"Cascadia Code\", Consolas, monospace; font-size: 0.87em; }\n pre code { background: transparent; color: inherit; padding: 0; }\n .code-comment { color: #94a3b8; }\n .code-keyword { color: #f472b6; }\n .code-string { color: #a5f3fc; }\n\n \/* Callouts *\/\n .callout { padding: 1rem 1.25rem; border-radius: 8px; margin: 1rem 0; border-left: 4px solid; }\n .callout.warn { background: var(--warn-bg); border-color: var(--warn-border); }\n .callout.err { background: var(--err-bg); border-color: var(--err-border); }\n .callout.ok { background: var(--ok-bg); border-color: var(--ok-border); }\n .callout.info { background: var(--info-bg); border-color: var(--info-border); }\n .callout.tip { background: var(--tip-bg); border-color: var(--tip-border); }\n .callout strong { display: block; margin-bottom: 0.3rem; color: var(--ink); }\n\n \/* Table *\/\n .table-wrap { overflow-x: auto; margin: 1rem 0; }\n table { width: 100%; border-collapse: collapse; font-size: 0.9rem; min-width: 500px; }\n th, td { padding: 0.65rem 0.9rem; text-align: left; border-bottom: 1px solid var(--rule); }\n th { background: var(--bg); font-weight: 600; color: var(--ink); white-space: nowrap; }\n tr:hover td { background: var(--bg); }\n\n \/* Two-column compare *\/\n .compare-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin: 1rem 0; }\n .compare-box { border: 1px solid var(--rule); border-radius: 8px; padding: 1.1rem; background: var(--surface); }\n .compare-box .box-title { font-weight: 700; font-size: 0.88rem; margin-bottom: 0.5rem; }\n\n \/* Tags *\/\n .tag { display: inline-block; padding: 0.18rem 0.55rem; border-radius: 4px; font-size: 0.78rem; font-weight: 600; margin-right: 0.3rem; }\n .tag-req { background: var(--accent); color: #fff; }\n .tag-opt { background: var(--accent2); color: #fff; }\n\n \/* Summary box *\/\n .summary-box { background: var(--surface); border: 2px solid var(--accent); border-radius: 12px; padding: 1.5rem 1.75rem; margin-top: 1.5rem; }\n .summary-box h2 { border-bottom-color: var(--accent2); margin-top: 0; }\n .summary-row { display: flex; gap: 1.5rem; margin: 0.75rem 0; align-items: flex-start; }\n .summary-row .s-label { flex-shrink: 0; font-weight: 700; font-size: 0.9rem; color: var(--accent); min-width: 120px; }\n .summary-row .s-desc { color: var(--muted); font-size: 0.92rem; }\n\n \/* Footer *\/\n footer { text-align: center; color: var(--muted); font-size: 0.8rem; margin-top: 2rem; padding-top: 1rem; border-top: 1px solid var(--rule); }\n\n \/* Responsive *\/\n @media (max-width: 640px) {\n .compare-grid { grid-template-columns: 1fr; }\n .summary-row { flex-direction: column; gap: 0.4rem; }\n .page-header h1 { font-size: 1.5rem; }\n .card { padding: 1.25rem 1.5rem; }\n }\n<\/style>\n<\/head>\n<body>\n<div class=\"container\">\n\n <div class=\"page-header\">\n <span class=\"badge\">GitHub \u5165\u95e8\u6559\u7a0b<\/span>\n <h1>\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357<\/h1>\n <p>\u8986\u76d6\u4ece\u6ce8\u518c GitHub \u8d26\u53f7\u3001\u514b\u9686\u9879\u76ee\u3001\u5b89\u88c5\u4f9d\u8d56\u5230\u8fd0\u884c\u9879\u76ee\u7684\u5b8c\u6574\u6d41\u7a0b\uff0c\u65e0\u9700\u4efb\u4f55\u524d\u7f6e\u7ecf\u9a8c<\/p>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e00\uff1a\u51c6\u5907\u5de5\u4f5c<\/h2>\n\n <h3>1.1 \u6ce8\u518c GitHub \u8d26\u53f7<\/h3>\n <p>\u5982\u679c\u5c1a\u672a\u62e5\u6709 GitHub \u8d26\u53f7\uff0c\u9700\u8981\u5148\u5728\u5b98\u7f51\u6ce8\u518c\uff1a<\/p>\n <ol>\n <li>\u8bbf\u95ee <a href=\"https:\/\/github.com\" target=\"_blank\">github.com<\/a><\/li>\n <li>\u70b9\u51fb\u53f3\u4e0a\u89d2 <strong>Sign up<\/strong>\uff0c\u6309\u63d0\u793a\u586b\u5199\u90ae\u7bb1\u3001\u5bc6\u7801\u3001\u7528\u6237\u540d<\/li>\n <li>\u5b8c\u6210\u90ae\u7bb1\u9a8c\u8bc1<\/li>\n <\/ol>\n <div class=\"callout tip\">\n <strong>\u63d0\u793a<\/strong>\n GitHub \u5728\u56fd\u5185\u8bbf\u95ee\u53ef\u80fd\u4e0d\u7a33\u5b9a\uff0c\u5982\u9047\u52a0\u8f7d\u7f13\u6162\u6216\u6253\u4e0d\u5f00\uff0c\u53ef\u5c1d\u8bd5\u4f7f\u7528\u7f51\u7edc\u52a0\u901f\u5de5\u5177\u6216\u955c\u50cf\u7ad9\u70b9\u3002\n <\/div>\n\n <h3>1.2 \u5b89\u88c5 Git<\/h3>\n <p>Git \u662f\u4e0b\u8f7d\u548c\u7ba1\u7406\u4ee3\u7801\u7248\u672c\u7684\u6838\u5fc3\u5de5\u5177\uff0c\u9700\u8981\u5728\u672c\u5730\u5148\u5b89\u88c5\u3002<\/p>\n\n <p><strong>Windows \u7528\u6237\uff1a<\/strong><\/p>\n <ol>\n <li>\u8bbf\u95ee <a href=\"https:\/\/git-scm.com\/downloads\" target=\"_blank\">git-scm.com\/downloads<\/a><\/li>\n <li>\u4e0b\u8f7d Windows \u7248\u672c\u5b89\u88c5\u5305\uff0c\u53cc\u51fb\u8fd0\u884c<\/li>\n <li>\u5b89\u88c5\u8fc7\u7a0b\u4e2d\u4fdd\u6301\u9ed8\u8ba4\u9009\u9879\u5373\u53ef\uff0c\u4e00\u8def\u70b9\u51fb <strong>Next<\/strong> \u5230\u5b8c\u6210<\/li>\n <li>\u5b89\u88c5\u5b8c\u6210\u540e\uff0c\u9a8c\u8bc1\u662f\u5426\u6210\u529f\uff1a<\/li>\n <\/ol>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git –version<\/span>\n <\/div>\n <p>\u82e5\u770b\u5230\u7c7b\u4f3c <code>git version 2.43.0<\/code> \u7684\u8f93\u51fa\uff0c\u8bf4\u660e\u5b89\u88c5\u6210\u529f\u3002<\/p>\n\n <p><strong>macOS \u7528\u6237\uff1a<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git –version<\/span>\n <\/div>\n <p>\u82e5\u7cfb\u7edf\u63d0\u793a\u672a\u5b89\u88c5\uff0c\u6309\u63d0\u793a\u81ea\u52a8\u5b89\u88c5\u6216\u5148\u5b89\u88c5 <a href=\"https:\/\/brew.sh\/\" target=\"_blank\">Homebrew<\/a> \u540e\u6267\u884c\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">brew install git<\/span>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e8c\uff1a\u5728 GitHub \u4e0a\u627e\u5230\u76ee\u6807\u9879\u76ee<\/h2>\n\n <h3>2.1 \u641c\u7d22\u9879\u76ee<\/h3>\n <p>GitHub \u63d0\u4f9b\u591a\u79cd\u65b9\u5f0f\u67e5\u627e\u9879\u76ee\uff1a<\/p>\n <ul>\n <li><strong>\u641c\u7d22\u680f<\/strong>\uff1a\u76f4\u63a5\u5728 GitHub \u9996\u9875\u9876\u90e8\u8f93\u5165\u5173\u952e\u8bcd\uff08\u5982 <code>python geological modeling<\/code>\uff09<\/li>\n <li><strong>\u4ed6\u4eba\u63a8\u8350<\/strong>\uff1a\u4ece\u535a\u5ba2\u3001\u6559\u7a0b\u3001\u8bba\u6587\u4e2d\u83b7\u53d6\u9879\u76ee\u94fe\u63a5<\/li>\n <li><strong>Awesome \u5217\u8868<\/strong>\uff1a\u641c\u7d22 <code>awesome-xxx<\/code> \u5173\u952e\u8bcd\uff08\u5982 <code>awesome-python<\/code>\uff09\u83b7\u53d6\u7cbe\u9009\u9879\u76ee\u5408\u96c6<\/li>\n <\/ul>\n\n <h3>2.2 \u8bc6\u522b\u9879\u76ee\u8d28\u91cf<\/h3>\n <p>\u6253\u5f00\u9879\u76ee\u4e3b\u9875\u540e\uff0c\u5173\u6ce8\u4ee5\u4e0b\u51e0\u4e2a\u6307\u6807\u5224\u65ad\u9879\u76ee\u662f\u5426\u53ef\u9760\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u6307\u6807<\/th><th>\u542b\u4e49<\/th><th>\u5efa\u8bae<\/th><\/tr>\n <tr><td>Stars<\/td><td>\u70b9\u8d5e\u6570\uff0c\u4ee3\u8868\u9879\u76ee\u53d7\u6b22\u8fce\u7a0b\u5ea6<\/td><td>100+ \u901a\u5e38\u8bf4\u660e\u9879\u76ee\u6709\u4e00\u5b9a\u8d28\u91cf<\/td><\/tr>\n <tr><td>Last Updated<\/td><td>\u6700\u540e\u66f4\u65b0\u65f6\u95f4<\/td><td>\u8fd1\u671f\u6709\u66f4\u65b0\u8bf4\u660e\u9879\u76ee\u4ecd\u5728\u7ef4\u62a4<\/td><\/tr>\n <tr><td>README<\/td><td>\u9879\u76ee\u8bf4\u660e\u6587\u6863<\/td><td>\u6587\u6863\u8d8a\u8be6\u7ec6\uff0c\u8d8a\u5bb9\u6613\u4e0a\u624b<\/td><\/tr>\n <tr><td>Issues<\/td><td>\u95ee\u9898\u53cd\u9988\u533a<\/td><td>\u5927\u91cf\u672a\u5173\u95ed\u7684\u4e25\u91cd\u95ee\u9898\u9700\u8c28\u614e<\/td><\/tr>\n <tr><td>License<\/td><td>\u5f00\u6e90\u8bb8\u53ef\u8bc1<\/td><td>MIT \/ Apache 2.0 \/ GPL \u7b49\u5141\u8bb8\u4f7f\u7528<\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>2.3 \u83b7\u53d6\u4ed3\u5e93\u5730\u5740<\/h3>\n <p>\u8fdb\u5165\u9879\u76ee\u4e3b\u9875\u540e\uff0c\u70b9\u51fb\u7eff\u8272\u7684 <strong>Code<\/strong> \u6309\u94ae\uff0c\u4f1a\u5f39\u51fa\u4e0b\u8f7d\u5730\u5740\u9009\u9879\u3002\u901a\u5e38\u6709\u4e24\u79cd\u65b9\u5f0f\uff1a<\/p>\n <div class=\"compare-grid\">\n <div class=\"compare-box\">\n <div class=\"box-title\">HTTPS \u5730\u5740\uff08\u63a8\u8350\u65b0\u624b\uff09<\/div>\n <pre><code>https:\/\/github.com\/\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/code><\/pre>\n <p style=\"font-size:0.85rem; color:var(--muted); margin-top:0.5rem;\">\u65e0\u9700\u914d\u7f6e SSH \u5bc6\u94a5\uff0c\u6bcf\u6b21\u4e0b\u8f7d\u65f6\u8f93\u5165\u7528\u6237\u540d\u548c\u5bc6\u7801\u5373\u53ef\u3002\u8fd1\u5e74\u6765 GitHub \u5df2\u6539\u7528 Personal Access Token \u4ee3\u66ff\u5bc6\u7801\u3002<\/p>\n <\/div>\n <div class=\"compare-box\">\n <div class=\"box-title\">SSH \u5730\u5740\uff08\u63a8\u8350\u957f\u671f\u5f00\u53d1\u8005\uff09<\/div>\n <pre><code>git@github.com:\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/code><\/pre>\n <p style=\"font-size:0.85rem; color:var(--muted); margin-top:0.5rem;\">\u9700\u5148\u5728\u672c\u5730\u914d\u7f6e SSH \u5bc6\u94a5\uff0c\u914d\u7f6e\u5b8c\u6210\u540e\u65e0\u9700\u91cd\u590d\u8f93\u5165\u5bc6\u7801\uff0c\u66f4\u65b9\u4fbf\u3002<\/p>\n <\/div>\n <\/div>\n\n <div class=\"callout info\">\n <strong>HTTPS \u65b9\u5f0f\u83b7\u53d6 Token \u7684\u6b65\u9aa4<\/strong>\n <ol style=\"margin-top:0.5rem;\">\n <li>GitHub \u5934\u50cf \u2192 Settings \u2192 Developer settings \u2192 Personal access tokens \u2192 Tokens (classic)<\/li>\n <li>\u70b9\u51fb Generate new token\uff0c\u52fe\u9009 <code>repo<\/code> \u6743\u9650<\/li>\n <li>\u751f\u6210\u540e\u590d\u5236\u4ee4\u724c\uff0c\u5728\u547d\u4ee4\u884c\u63d0\u793a\u8f93\u5165\u5bc6\u7801\u65f6\u7c98\u8d34\u8be5\u4ee4\u724c\u5373\u53ef<\/li>\n <\/ol>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e09\uff1a\u5c06\u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730<\/h2>\n\n <h3>3.1 \u6253\u5f00\u7ec8\u7aef\uff08\u547d\u4ee4\u884c\uff09<\/h3>\n <ul>\n <li><strong>Windows<\/strong>\uff1a\u6309 <code>Win + R<\/code> \u8f93\u5165 <code>cmd<\/code> \u6216 <code>powershell<\/code> \u56de\u8f66\uff1b\u6216\u53f3\u952e\u5f00\u59cb\u83dc\u5355\u9009\u62e9 “Windows Terminal”<\/li>\n <li><strong>macOS<\/strong>\uff1a\u6309 <code>Cmd + \u7a7a\u683c<\/code> \u641c\u7d22 “Terminal”<\/li>\n <\/ul>\n\n <h3>3.2 \u9009\u62e9\u5b58\u653e\u76ee\u5f55<\/h3>\n <p>\u5efa\u8bae\u5c06\u9879\u76ee\u5b58\u653e\u5728\u4e13\u95e8\u7684\u5de5\u4f5c\u76ee\u5f55\u4e2d\uff0c\u4f8b\u5982\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">cd D:\\Projects<\/span>\n <\/div>\n <p>\uff08Windows \u4f7f\u7528\u53cd\u659c\u6760 <code>\\<\/code> \u6216\u6b63\u659c\u6760 <code>\/<\/code> \u5747\u53ef\uff09<\/p>\n\n <h3>3.3 \u6267\u884c\u514b\u9686\u547d\u4ee4<\/h3>\n <p>\u590d\u5236 GitHub \u4e0a\u7684 HTTPS \u5730\u5740\uff0c\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git clone https:\/\/github.com\/\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/span>\n <\/div>\n <p>\u82e5\u4f7f\u7528 SSH \u5730\u5740\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">git clone git@github.com:\u7528\u6237\u540d\/\u9879\u76ee\u540d.git<\/span>\n <\/div>\n\n <p>\u6210\u529f\u540e\u4f1a\u770b\u5230\u7c7b\u4f3c\u8f93\u51fa\uff1a<\/p>\n <pre><code>Cloning into '\u9879\u76ee\u540d'...\nremote: Enumerating objects: 1234, done.\nremote: Total 1234 (delta 0), reused 0 (delta 0), pack-reused 1234\nReceiving objects: 100% (1234\/1234), 5.67 MiB | 2.10 MiB\/s, done.\nResolving deltas: 100% (567\/567), done.<\/code><\/pre>\n\n <h3>3.4 \u8fdb\u5165\u9879\u76ee\u76ee\u5f55<\/h3>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">cd \u9879\u76ee\u540d<\/span>\n <\/div>\n\n <div class=\"callout ok\">\n <strong>\u5b8c\u6210\u9a8c\u8bc1<\/strong>\n \u6267\u884c <code>ls<\/code>\uff08macOS\/Linux\uff09\u6216 <code>dir<\/code>\uff08Windows\uff09\u67e5\u770b\u76ee\u5f55\u5185\u5bb9\uff0c\u82e5\u80fd\u770b\u5230\u9879\u76ee\u6587\u4ef6\uff08\u5982 README.md\u3001src \u6587\u4ef6\u5939\u7b49\uff09\uff0c\u8bf4\u660e\u4e0b\u8f7d\u6210\u529f\u3002\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u56db\uff1a\u5b89\u88c5\u9879\u76ee\u4f9d\u8d56<\/h2>\n\n <h3>4.1 \u68c0\u67e5 Python \u73af\u5883<\/h3>\n <p>\u5927\u591a\u6570\u9879\u76ee\u9700\u8981 Python \u73af\u5883\u8fd0\u884c\u3002\u5148\u786e\u8ba4\u662f\u5426\u5df2\u5b89\u88c5 Python\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">python –version<\/span>\n <\/div>\n <p>\u82e5\u663e\u793a\u7248\u672c\u53f7\uff08\u5982 <code>Python 3.11.4<\/code>\uff09\uff0c\u8bf4\u660e\u5df2\u5b89\u88c5\u3002\u82e5\u672a\u5b89\u88c5\uff0c\u8bbf\u95ee <a href=\"https:\/\/www.python.org\/downloads\/\" target=\"_blank\">python.org<\/a> \u4e0b\u8f7d\u5b89\u88c5\u3002<\/p>\n\n <h3>4.2 \u521b\u5efa\u865a\u62df\u73af\u5883\uff08\u5f3a\u70c8\u63a8\u8350\uff09<\/h3>\n <p>\u865a\u62df\u73af\u5883\u53ef\u9694\u79bb\u4e0d\u540c\u9879\u76ee\u7684\u4f9d\u8d56\uff0c\u907f\u514d\u7248\u672c\u51b2\u7a81\u3002\u5728\u9879\u76ee\u76ee\u5f55\u5185\u6267\u884c\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">python -m venv venv<\/span>\n <\/div>\n <p>\u521b\u5efa\u5b8c\u6210\u540e\uff0c\u6fc0\u6d3b\u865a\u62df\u73af\u5883\uff1a<\/p>\n\n <div class=\"compare-grid\">\n <div class=\"compare-box\">\n <div class=\"box-title\">Windows<\/div>\n <div class=\"cmd-banner\" style=\"margin-bottom:0;\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">venv\\Scripts\\activate<\/span>\n <\/div>\n <\/div>\n <div class=\"compare-box\">\n <div class=\"box-title\">macOS \/ Linux<\/div>\n <div class=\"cmd-banner\" style=\"margin-bottom:0;\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">source venv\/bin\/activate<\/span>\n <\/div>\n <\/div>\n <\/div>\n\n <p>\u6fc0\u6d3b\u6210\u529f\u540e\uff0c\u547d\u4ee4\u884c\u63d0\u793a\u7b26\u524d\u4f1a\u51fa\u73b0 <code>(venv)<\/code> \u6807\u8bb0\uff1a<\/p>\n <pre><code>(venv) D:\\Projects\\\u9879\u76ee\u540d><\/code><\/pre>\n\n <h3>4.3 \u67e5\u770b\u9879\u76ee\u4f9d\u8d56\u6587\u4ef6<\/h3>\n <p>\u9879\u76ee\u901a\u5e38\u4f1a\u5728\u4ee5\u4e0b\u6587\u4ef6\u4e2d\u5217\u51fa\u4f9d\u8d56\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u6587\u4ef6<\/th><th>\u5b89\u88c5\u547d\u4ee4<\/th><th>\u8bf4\u660e<\/th><\/tr>\n <tr><td><code>requirements.txt<\/code><\/td><td><code>pip install -r requirements.txt<\/code><\/td><td>\u6700\u5e38\u89c1\u7684\u4f9d\u8d56\u6e05\u5355<\/td><\/tr>\n <tr><td><code>pyproject.toml<\/code><\/td><td><code>pip install -e .<\/code><\/td><td>\u73b0\u4ee3 Python \u9879\u76ee\u6807\u51c6<\/td><\/tr>\n <tr><td><code>setup.py<\/code><\/td><td><code>pip install -e .<\/code><\/td><td>\u4f20\u7edf\u5b89\u88c5\u65b9\u5f0f<\/td><\/tr>\n <tr><td><code>environment.yml<\/code><\/td><td><code>conda env create -f environment.yml<\/code><\/td><td>Conda \u73af\u5883\u9879\u76ee<\/td><\/tr>\n <\/table>\n <\/div>\n\n <p>\u67e5\u770b\u9879\u76ee\u76ee\u5f55\u4e2d\u6709\u54ea\u4e9b\u6587\u4ef6\uff0c\u4f18\u5148\u627e <code>requirements.txt<\/code> \u6216 <code>pyproject.toml<\/code>\u3002<\/p>\n\n <h3>4.4 \u5b89\u88c5\u4f9d\u8d56<\/h3>\n\n <p><strong>\u60c5\u51b5 A\uff1a\u53ea\u6709 requirements.txt<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip install -r requirements.txt<\/span>\n <\/div>\n\n <p><strong>\u60c5\u51b5 B\uff1a\u6709 pyproject.toml \u4e14\u9700\u8981\u672c\u5730\u5f00\u53d1<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip install -r requirements.txt -e .<\/span>\n <\/div>\n <div class=\"callout info\">\n <strong>\u8bf4\u660e<\/strong>\n <code>-r requirements.txt<\/code> \u5b89\u88c5\u7b2c\u4e09\u65b9\u5e93\uff1b<code>-e .<\/code> \u4ee5\u53ef\u7f16\u8f91\u6a21\u5f0f\u5b89\u88c5\u9879\u76ee\u672c\u8eab\uff0c\u4f7f\u5f97\u4fee\u6539\u4ee3\u7801\u540e\u65e0\u9700\u91cd\u65b0\u5b89\u88c5\u5373\u53ef\u751f\u6548\u3002\n <\/div>\n\n <p><strong>\u60c5\u51b5 C\uff1a\u4f7f\u7528 Conda \u73af\u5883<\/strong><\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">conda env create -f environment.yml<\/span>\n <\/div>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">$<\/span>\n <span class=\"cmd-text\">conda activate \u73af\u5883\u540d<\/span>\n <\/div>\n\n <h3>4.5 \u9a8c\u8bc1\u4f9d\u8d56\u5b89\u88c5<\/h3>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">pip list<\/span>\n <\/div>\n <p>\u67e5\u770b\u5217\u8868\u4e2d\u662f\u5426\u5305\u542b\u4e86\u9879\u76ee\u6240\u9700\u7684\u4f9d\u8d56\u5305\uff08\u5982 numpy\u3001pandas\u3001requests \u7b49\uff09\u3002<\/p>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e94\uff1a\u8fd0\u884c\u9879\u76ee<\/h2>\n\n <h3>5.1 \u9605\u8bfb\u9879\u76ee README<\/h3>\n <p>\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u7684 <code>README.md<\/code> \u662f\u4f7f\u7528\u8bf4\u660e\u4e66\uff0c\u901a\u5e38\u5305\u542b\uff1a<\/p>\n <ul>\n <li>\u9879\u76ee\u529f\u80fd\u7b80\u4ecb<\/li>\n <li>\u5b89\u88c5\u6b65\u9aa4<\/li>\n <li>\u5feb\u901f\u5f00\u59cb\u793a\u4f8b\uff08Quick Start\uff09<\/li>\n <li>\u4f7f\u7528\u65b9\u6cd5\u548c\u53c2\u6570\u8bf4\u660e<\/li>\n <\/ul>\n <p>\u53ef\u901a\u8fc7\u547d\u4ee4\u884c\u67e5\u770b\uff0c\u6216\u5728 GitHub \u7f51\u9875\u4e0a\u76f4\u63a5\u9605\u8bfb\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">type README.md<\/span>\n <\/div>\n <p>\uff08macOS\/Linux \u4f7f\u7528 <code>cat README.md<\/code>\uff09<\/p>\n\n <h3>5.2 \u5bfb\u627e\u5165\u53e3\u6587\u4ef6<\/h3>\n <p>\u4e0d\u540c\u9879\u76ee\u6709\u4e0d\u540c\u7684\u8fd0\u884c\u65b9\u5f0f\uff1a<\/p>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9879\u76ee\u7c7b\u578b<\/th><th>\u5178\u578b\u5165\u53e3<\/th><th>\u8fd0\u884c\u65b9\u5f0f<\/th><\/tr>\n <tr><td>Python \u811a\u672c<\/td><td><code>main.py<\/code> \/ <code>run.py<\/code><\/td><td><code>python main.py<\/code><\/td><\/tr>\n <tr><td>\u547d\u4ee4\u884c\u5de5\u5177<\/td><td><code>__main__.py<\/code><\/td><td><code>python -m \u5305\u540d<\/code><\/td><\/tr>\n <tr><td>Web \u5e94\u7528<\/td><td><code>app.py<\/code> \/ <code>manage.py<\/code><\/td><td><code>python app.py<\/code> \u6216 <code>flask run<\/code><\/td><\/tr>\n <tr><td>Jupyter Notebook<\/td><td><code>examples\/*.ipynb<\/code><\/td><td><code>jupyter notebook<\/code><\/td><\/tr>\n <tr><td>Node.js \u9879\u76ee<\/td><td><code>package.json<\/code><\/td><td><code>npm install && npm start<\/code><\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>5.3 \u8fd0\u884c\u793a\u4f8b<\/h3>\n <p>\u4ee5\u5178\u578b\u7684 Python \u9879\u76ee\u4e3a\u4f8b\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">python examples\/demo.py<\/span>\n <\/div>\n <p>\u82e5\u9879\u76ee\u63d0\u4f9b\u547d\u4ee4\u884c\u5de5\u5177\u5165\u53e3\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">python -m \u9879\u76ee\u540d –help<\/span>\n <\/div>\n\n <div class=\"callout ok\">\n <strong>\u8fd0\u884c\u6210\u529f\u6807\u5fd7<\/strong>\n \u82e5\u770b\u5230\u9884\u671f\u7684\u8f93\u51fa\u7ed3\u679c\uff08\u5982\u8ba1\u7b97\u7ed3\u679c\u3001\u56fe\u8868\u3001\u7f51\u9875\u670d\u52a1\u7b49\uff09\uff0c\u8bf4\u660e\u9879\u76ee\u5df2\u6b63\u5e38\u8fd0\u884c\u3002\u82e5\u9047\u5230\u9519\u8bef\uff0c\u67e5\u770b\u4e0b\u65b9\u7684\u5e38\u89c1\u95ee\u9898\u6392\u67e5\u3002\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u516d\uff1a\u5e38\u89c1\u95ee\u9898\u6392\u67e5<\/h2>\n\n <h3>6.1 \u514b\u9686\u5931\u8d25<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>Could not resolve host<\/code><\/td><td>\u7f51\u7edc\u95ee\u9898<\/td><td>\u68c0\u67e5\u7f51\u7edc\u8fde\u63a5\uff0c\u5c1d\u8bd5\u4f7f\u7528\u4ee3\u7406\u6216\u52a0\u901f\u5668<\/td><\/tr>\n <tr><td><code>Authentication failed<\/code><\/td><td>\u6743\u9650\u6216 Token \u9519\u8bef<\/td><td>\u786e\u8ba4 HTTPS \u5730\u5740\u6b63\u786e\uff0c\u6216\u91cd\u65b0\u751f\u6210 Personal Access Token<\/td><\/tr>\n <tr><td><code>Permission denied (publickey)<\/code><\/td><td>SSH \u5bc6\u94a5\u672a\u914d\u7f6e<\/td><td>\u5207\u6362\u5230 HTTPS \u5730\u5740\uff0c\u6216\u914d\u7f6e SSH \u5bc6\u94a5<\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>6.2 \u4f9d\u8d56\u5b89\u88c5\u5931\u8d25<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>No module named 'xxx'<\/code><\/td><td>\u4f9d\u8d56\u672a\u5b89\u88c5<\/td><td><code>pip install xxx<\/code><\/td><\/tr>\n <tr><td><code>Could not find a version<\/code><\/td><td>Python \u7248\u672c\u4e0d\u517c\u5bb9<\/td><td>\u68c0\u67e5 README \u8981\u6c42\u7684 Python \u7248\u672c\uff0c\u521b\u5efa\u5bf9\u5e94\u7248\u672c\u865a\u62df\u73af\u5883<\/td><\/tr>\n <tr><td><code>Failed building wheel<\/code><\/td><td>\u7f3a\u5c11\u7f16\u8bd1\u5de5\u5177<\/td><td>Windows \u5b89\u88c5 <a href=\"https:\/\/visualstudio.microsoft.com\/visual-cpp-build-tools\/\" target=\"_blank\">C++ Build Tools<\/a><\/td><\/tr>\n <\/table>\n <\/div>\n\n <h3>6.3 \u8fd0\u884c\u65f6\u62a5\u9519<\/h3>\n <div class=\"table-wrap\">\n <table>\n <tr><th>\u9519\u8bef\u4fe1\u606f<\/th><th>\u539f\u56e0<\/th><th>\u89e3\u51b3\u65b9\u6848<\/th><\/tr>\n <tr><td><code>ModuleNotFoundError<\/code><\/td><td>\u6a21\u5757\u672a\u5b89\u88c5\u6216\u8def\u5f84\u95ee\u9898<\/td><td>\u786e\u8ba4\u865a\u62df\u73af\u5883\u5df2\u6fc0\u6d3b\uff0c\u91cd\u65b0\u6267\u884c <code>pip install<\/code><\/td><\/tr>\n <tr><td><code>FileNotFoundError<\/code><\/td><td>\u7f3a\u5c11\u6570\u636e\u6587\u4ef6\u6216\u914d\u7f6e\u6587\u4ef6<\/td><td>\u68c0\u67e5 README \u4e2d\u662f\u5426\u9700\u8981\u4e0b\u8f7d\u989d\u5916\u6570\u636e\u6216\u8bbe\u7f6e\u73af\u5883\u53d8\u91cf<\/td><\/tr>\n <tr><td><code>Port already in use<\/code><\/td><td>\u7aef\u53e3\u88ab\u5360\u7528<\/td><td>\u5173\u95ed\u5360\u7528\u7aef\u53e3\u7684\u7a0b\u5e8f\uff0c\u6216\u4fee\u6539\u9879\u76ee\u914d\u7f6e\u6587\u4ef6\u4e2d\u7684\u7aef\u53e3\u53f7<\/td><\/tr>\n <\/table>\n <\/div>\n\n <div class=\"callout tip\">\n <strong>\u4e07\u80fd\u6392\u67e5\u987a\u5e8f<\/strong>\n <ol style=\"margin-top:0.5rem;\">\n <li>\u786e\u8ba4\u865a\u62df\u73af\u5883\u5df2\u6fc0\u6d3b\uff08\u63d0\u793a\u7b26\u524d\u6709 <code>(venv)<\/code>\uff09<\/li>\n <li>\u786e\u8ba4\u5728\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u6267\u884c\u547d\u4ee4<\/li>\n <li>\u91cd\u65b0\u9605\u8bfb README \u4e2d\u7684\u5b89\u88c5\u548c\u8fd0\u884c\u8bf4\u660e<\/li>\n <li>\u67e5\u770b\u9879\u76ee\u7684 Issues \u9875\u9762\u662f\u5426\u6709\u4eba\u9047\u5230\u76f8\u540c\u95ee\u9898<\/li>\n <\/ol>\n <\/div>\n <\/div>\n\n \n <div class=\"card\">\n <h2>\u9636\u6bb5\u4e03\uff1a\u8fdb\u9636\u4f7f\u7528\uff08\u53ef\u9009\uff09<\/h2>\n\n <h3>7.1 \u4fdd\u6301\u9879\u76ee\u66f4\u65b0<\/h3>\n <p>\u82e5\u9879\u76ee\u6709\u66f4\u65b0\uff0c\u53ef\u901a\u8fc7\u4ee5\u4e0b\u547d\u4ee4\u540c\u6b65\u6700\u65b0\u4ee3\u7801\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git pull origin main<\/span>\n <\/div>\n <p>\uff08\u82e5\u4e3b\u5206\u652f\u540d\u4e3a <code>master<\/code>\uff0c\u5219\u66ff\u6362\u4e3a <code>master<\/code>\uff09<\/p>\n\n <h3>7.2 \u5207\u6362\u9879\u76ee\u7248\u672c<\/h3>\n <p>\u67d0\u4e9b\u9879\u76ee\u9700\u8981\u7279\u5b9a\u7248\u672c\uff08\u5982\u8bba\u6587\u590d\u73b0\uff09\uff0c\u53ef\u67e5\u770b\u7248\u672c\u6807\u7b7e\u5e76\u5207\u6362\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git tag<\/span>\n <\/div>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">git checkout v1.0.0<\/span>\n <\/div>\n\n <h3>7.3 \u9000\u51fa\u865a\u62df\u73af\u5883<\/h3>\n <p>\u4f7f\u7528\u5b8c\u6bd5\u540e\uff0c\u9000\u51fa\u865a\u62df\u73af\u5883\uff1a<\/p>\n <div class=\"cmd-banner\">\n <span class=\"prompt\">(venv) $<\/span>\n <span class=\"cmd-text\">deactivate<\/span>\n <\/div>\n <\/div>\n\n \n <div class=\"summary-box\">\n <h2>\u5b8c\u6574\u6d41\u7a0b\u901f\u67e5<\/h2>\n <div class=\"summary-row\"><div class=\"s-label\">\u51c6\u5907<\/div><div class=\"s-desc\">\u6ce8\u518c GitHub \u8d26\u53f7 \u2192 \u5b89\u88c5 Git \u2192 \u5b89\u88c5 Python<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u67e5\u627e<\/div><div class=\"s-desc\">\u5728 GitHub \u641c\u7d22\u9879\u76ee \u2192 \u68c0\u67e5 Stars \u548c README \u8d28\u91cf \u2192 \u590d\u5236\u4ed3\u5e93\u5730\u5740<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u4e0b\u8f7d<\/div><div class=\"s-desc\">\u6253\u5f00\u7ec8\u7aef \u2192 \u9009\u62e9\u76ee\u5f55 \u2192 <code>git clone \u5730\u5740<\/code> \u2192 \u8fdb\u5165\u9879\u76ee\u76ee\u5f55<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u914d\u7f6e<\/div><div class=\"s-desc\">\u521b\u5efa\u865a\u62df\u73af\u5883 <code>python -m venv venv<\/code> \u2192 \u6fc0\u6d3b \u2192 \u5b89\u88c5\u4f9d\u8d56<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u8fd0\u884c<\/div><div class=\"s-desc\">\u9605\u8bfb README \u2192 \u627e\u5230\u5165\u53e3\u6587\u4ef6 \u2192 \u6267\u884c\u8fd0\u884c\u547d\u4ee4<\/div><\/div>\n <div class=\"summary-row\"><div class=\"s-label\">\u7ef4\u62a4<\/div><div class=\"s-desc\"><code>git pull<\/code> \u66f4\u65b0\u4ee3\u7801 \u2192 \u9047\u5230\u95ee\u9898\u67e5\u770b Issues \u2192 \u5fc5\u8981\u65f6\u5207\u6362\u7248\u672c<\/div><\/div>\n <\/div>\n\n <footer>\n <p>\u57fa\u4e8e Git \u5b98\u65b9\u6587\u6863\u4e0e Python \u6253\u5305\u6307\u5357\u6574\u7406<\/p>\n <\/footer>\n\n<\/div>\n<\/body>\n<\/html>\n\n","protected":false},"excerpt":{"rendered":"<p>\u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230\u672c\u5730\u4f7f\u7528\u5b8c\u6574\u6307\u5357 GitHub \u5165\u95e8\u6559\u7a0b \u4ece\u96f6\u5f00\u59cb\uff1aGitHub \u9879\u76ee\u4e0b\u8f7d\u5230 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11,9],"tags":[],"class_list":["post-304","post","type-post","status-publish","format-standard","hentry","category-cad","category-ai"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=304"}],"version-history":[{"count":1,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304\/revisions"}],"predecessor-version":[{"id":305,"href":"https:\/\/numsimlab.com\/index.php?rest_route=\/wp\/v2\/posts\/304\/revisions\/305"}],"wp:attachment":[{"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=304"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=304"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/numsimlab.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=304"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}