{"id":668,"date":"2026-02-04T18:37:58","date_gmt":"2026-02-04T10:37:58","guid":{"rendered":"https:\/\/blog.itsmygo.uk\/2026\/02\/04\/%e5%88%a5%e5%86%8d%e7%94%a8-sys-path-insert-%e4%ba%86-%e7%94%a8-uv-hatchling-%e8%ae%93%e5%85%b1%e7%94%a8%e6%a8%a1%e7%b5%84%e8%ae%8a%e6%ad%a3%e5%bc%8f%e5%a5%97%e4%bb%b6\/"},"modified":"2026-02-04T18:37:58","modified_gmt":"2026-02-04T10:37:58","slug":"%e5%88%a5%e5%86%8d%e7%94%a8-sys-path-insert-%e4%ba%86-%e7%94%a8-uv-hatchling-%e8%ae%93%e5%85%b1%e7%94%a8%e6%a8%a1%e7%b5%84%e8%ae%8a%e6%ad%a3%e5%bc%8f%e5%a5%97%e4%bb%b6","status":"publish","type":"post","link":"https:\/\/blog.itsmygo.uk\/wordpress\/2026\/02\/04\/%e5%88%a5%e5%86%8d%e7%94%a8-sys-path-insert-%e4%ba%86-%e7%94%a8-uv-hatchling-%e8%ae%93%e5%85%b1%e7%94%a8%e6%a8%a1%e7%b5%84%e8%ae%8a%e6%ad%a3%e5%bc%8f%e5%a5%97%e4%bb%b6\/","title":{"rendered":"\u5225\u518d\u7528 sys.path.insert \u4e86\u2014\u2014\u7528 uv + hatchling \u8b93\u5171\u7528\u6a21\u7d44\u8b8a\u6b63\u5f0f\u5957\u4ef6"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">\u4f60\u53ef\u80fd\u5beb\u904e\u9019\u7a2e code<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u591a\u500b\u5b50\u5c08\u6848\u8981\u5171\u7528\u4e00\u7d44\u5de5\u5177\u6a21\u7d44\uff0c\u65bc\u662f\u5728\u6bcf\u500b\u9032\u5165\u9ede\u52a0\u4e0a\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\"><span class=\"hljs-keyword\">import<\/span> sys\n<span class=\"hljs-keyword\">from<\/span> pathlib <span class=\"hljs-keyword\">import<\/span> Path\nsys.path.insert(<span class=\"hljs-number\">0<\/span>, str(Path(__file__).parent.parent))\n\n<span class=\"hljs-keyword\">from<\/span> common.utils <span class=\"hljs-keyword\">import<\/span> some_helper\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">runtime \u80fd\u8dd1\uff0c\u4f46\u554f\u984c\u4e0d\u5c11\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>IDE \u7d05\u7dda\u6eff\u5929\u98db<\/strong>\u2014\u2014Pylance \u4e0d\u8a8d <code>sys.path<\/code> \u52d5\u614b\u4fee\u6539\uff0cimport \u5168\u90e8\u6a19\u7d05<\/li>\n\n\n<li><strong>\u8def\u5f91\u8106\u5f31<\/strong>\u2014\u2014\u642c\u500b\u6a94\u6848\u5c31\u7206\uff0c<code>.parent.parent<\/code> \u6578\u91cf\u8981\u4eba\u5de5\u5c0d\u9f4a<\/li>\n\n\n<li><strong>\u8d8a\u5beb\u8d8a\u4e82<\/strong>\u2014\u2014\u6709\u4eba\u5beb <code>if __package__:<\/code> \/ <code>else:<\/code> \u96d9\u5206\u652f\u4f86\u540c\u6642\u652f\u63f4\u6a21\u7d44\u548c\u8173\u672c\u6a21\u5f0f\uff0c\u53ef\u8b80\u6027\u76f4\u63a5\u780d\u534a<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">\u66f4\u597d\u7684\u505a\u6cd5\uff1a\u8b93\u5b83\u8b8a\u6210\u6b63\u5f0f\u5957\u4ef6<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u6838\u5fc3\u601d\u8def\u5f88\u7c21\u55ae\u2014\u2014\u5728 <code>pyproject.toml<\/code> \u52a0 build-system\uff0c\u8b93 <code>uv sync<\/code> \u4ee5 editable \u6a21\u5f0f\u5b89\u88dd\u4f60\u7684\u5171\u7528\u6a21\u7d44\u3002\u4e4b\u5f8c\u6240\u6709 import \u90fd\u662f\u6a19\u6e96\u5957\u4ef6\u8def\u5f91\uff0cIDE \u548c runtime \u90fd\u8a8d\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. \u628a\u5171\u7528\u6a21\u7d44\u642c\u5230\u6839\u76ee\u9304<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># Before                    # After<\/span>\nproject\/                    project\/\n\u251c\u2500\u2500 agents\/                 \u251c\u2500\u2500 agent_common\/    \u2190 \u642c\u51fa\u4f86\n\u2502   \u251c\u2500\u2500 common\/             \u2502   \u251c\u2500\u2500 __init__.py\n\u2502   \u2502   \u251c\u2500\u2500 __init__.py     \u2502   \u251c\u2500\u2500 tracker.py\n\u2502   \u2502   \u2514\u2500\u2500 tracker.py      \u2502   \u2514\u2500\u2500 helpers.py\n\u2502   \u251c\u2500\u2500 project_a\/          \u251c\u2500\u2500 agents\/\n\u2502   \u2502   \u2514\u2500\u2500 agent.py        \u2502   \u251c\u2500\u2500 project_a\/\n\u2502   \u2514\u2500\u2500 project_b\/          \u2502   \u2502   \u2514\u2500\u2500 agent.py\n\u2502       \u2514\u2500\u2500 agent.py        \u2502   \u2514\u2500\u2500 project_b\/\n\u2514\u2500\u2500 pyproject.toml          \u2502       \u2514\u2500\u2500 agent.py\n                            \u2514\u2500\u2500 pyproject.toml\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">2. pyproject.toml \u52a0\u5169\u500b\u5340\u584a<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\">&#91;build-system]\nrequires = &#91;<span class=\"hljs-string\">\"hatchling\"<\/span>]\nbuild-backend = <span class=\"hljs-string\">\"hatchling.build\"<\/span>\n\n&#91;tool.hatch.build.targets.wheel]\npackages = &#91;<span class=\"hljs-string\">\"agent_common\"<\/span>]\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><code>packages<\/code> \u8981\u660e\u78ba\u6307\u5b9a\uff0c\u56e0\u70ba hatchling \u9810\u8a2d\u627e\u8ddf\u5c08\u6848\u540d\u7a31\u5c0d\u61c9\u7684\u76ee\u9304\u3002\u5982\u679c\u4f60\u7684\u5957\u4ef6\u76ee\u9304\u540d\u8ddf <code>[project] name<\/code> \u4e0d\u4e00\u81f4\uff0c\u5c31\u9700\u8981\u9019\u884c\u3002<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\">3. uv sync<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">uv sync\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">hatchling \u6703\u4ee5 editable \u6a21\u5f0f\u5b89\u88dd\uff0c<code>agent_common<\/code> \u8b8a\u6210\u6b63\u5f0f\u53ef import \u7684\u5957\u4ef6\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">4. \u628a\u6240\u6709 hack \u63db\u6210\u4e7e\u6de8\u7684 import<\/h3>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"CSS\" data-shcb-language-slug=\"css\"><span><code class=\"hljs language-css\"># <span class=\"hljs-selector-tag\">Before<\/span>\n<span class=\"hljs-selector-tag\">import<\/span> <span class=\"hljs-selector-tag\">sys<\/span>\n<span class=\"hljs-selector-tag\">sys<\/span><span class=\"hljs-selector-class\">.path<\/span><span class=\"hljs-selector-class\">.insert<\/span>(0, <span class=\"hljs-selector-tag\">str<\/span>(<span class=\"hljs-selector-tag\">Path<\/span>(__<span class=\"hljs-selector-tag\">file__<\/span>)<span class=\"hljs-selector-class\">.parent<\/span><span class=\"hljs-selector-class\">.parent<\/span>))\n<span class=\"hljs-selector-tag\">from<\/span> <span class=\"hljs-selector-tag\">common<\/span><span class=\"hljs-selector-class\">.tracker<\/span> <span class=\"hljs-selector-tag\">import<\/span> <span class=\"hljs-selector-tag\">SubagentTracker<\/span>\n\n# <span class=\"hljs-selector-tag\">After<\/span>\n<span class=\"hljs-selector-tag\">from<\/span> <span class=\"hljs-selector-tag\">agent_common<\/span><span class=\"hljs-selector-class\">.tracker<\/span> <span class=\"hljs-selector-tag\">import<\/span> <span class=\"hljs-selector-tag\">SubagentTracker<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">CSS<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">css<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u522a\u6389 <code>import sys<\/code>\u3001\u522a\u6389 <code>sys.path.insert<\/code>\u3001\u522a\u6389 <code>if __package__:<\/code> \u5206\u652f\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u5c31\u9019\u6a23<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u6574\u500b\u904e\u7a0b\u53ea\u52d5\u4e86\u4e09\u500b\u6771\u897f\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><code>mv<\/code> \u642c\u76ee\u9304<\/li>\n\n\n<li><code>pyproject.toml<\/code> \u52a0 6 \u884c\u8a2d\u5b9a<\/li>\n\n\n<li>\u6bcf\u500b\u6a94\u6848\u628a <code>from common.<\/code> \u6539\u6210 <code>from agent_common.<\/code><\/li>\n\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u4e4b\u5f8c IDE \u4e0d\u518d\u5831\u932f\u3001import \u8def\u5f91\u7a69\u5b9a\u3001\u65b0\u4eba\u770b code \u4e0d\u7528\u731c <code>sys.path<\/code> \u5728\u5e79\u561b\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5982\u679c\u4f60\u7684\u5171\u7528\u6a21\u7d44\u9700\u8981\u88ab\u591a\u500b\u5b50\u5c08\u6848 import\uff0c\u8b93\u5b83\u6210\u70ba\u6b63\u5f0f\u5b89\u88dd\u7684\u5957\u4ef6\uff0c\u800c\u4e0d\u662f\u9760 <code>sys.path<\/code> hack\u3002<code>uv<\/code> + <code>hatchling<\/code> \u7684 editable \u6a21\u5f0f\u8b93\u9019\u4ef6\u4e8b\u5e7e\u4e4e\u96f6\u6210\u672c\u3002<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5982\u679c\u4f60\u7684\u5171\u7528\u6a21\u7d44\u9700\u8981\u88ab\u591a\u500b\u5b50\u5c08\u6848 import\uff0c\u8b93\u5b83\u6210\u70ba\u6b63\u5f0f\u5b89\u88dd\u7684\u5957\u4ef6\uff0c\u800c\u4e0d\u662f\u9760 sys.path hack\u3002uv + hatchling \u7684 editable \u6a21\u5f0f\u8b93\u9019\u4ef6\u4e8b\u5e7e\u4e4e\u96f6\u6210\u672c\u3002<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rolpb_likes":0,"footnotes":""},"categories":[601],"tags":[604,602,240,239,241,603],"class_list":["post-668","post","type-post","status-publish","format-standard","hentry","category-python","tag-editable-install","tag-hatchling","tag-python","tag-uv","tag-241","tag-603"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":7}},"_links":{"self":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/668","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/comments?post=668"}],"version-history":[{"count":0,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/668\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/media?parent=668"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/categories?post=668"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/tags?post=668"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}