{"id":3306,"date":"2026-08-26T15:29:03","date_gmt":"2026-08-26T06:29:03","guid":{"rendered":"https:\/\/qol-kk.com\/wp2\/?p=3306"},"modified":"2026-08-26T15:29:03","modified_gmt":"2026-08-26T06:29:03","slug":"20260825-plan009","status":"publish","type":"post","link":"https:\/\/qol-kk.com\/wp2\/blog\/2026\/08\/26\/20260825-plan009\/","title":{"rendered":"uv \u3067 Python \u30d1\u30c3\u30b1\u30fc\u30b8\u7ba1\u7406\u3092\u59cb\u3081\u308b\uff08pip \/ Poetry \u3068\u306e\u6bd4\u8f03\uff09"},"content":{"rendered":"

\u6982\u8981<\/h2>\n

Python \u306e\u30d1\u30c3\u30b1\u30fc\u30b8\u7ba1\u7406\u306f\u9577\u3089\u304f pip<\/code> + venv<\/code> + requirements.txt<\/code> \u304c\u5b9a\u756a\u3067\u3057\u305f\u304c\u3001\u4f9d\u5b58\u89e3\u6c7a\u306e\u9045\u3055\u30fb\u30ed\u30c3\u30af\u306e\u5f31\u3055\u30fbPython \u672c\u4f53\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u7ba1\u7406\u3092\u5225\u30c4\u30fc\u30eb\u306b\u983c\u308b\u70b9\u304c\u8ab2\u984c\u3067\u3057\u305f\u3002uv<\/code> \u306f Rust \u88fd\u306e\u9ad8\u901f\u306a\u30d1\u30c3\u30b1\u30fc\u30b8\uff0f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u30de\u30cd\u30fc\u30b8\u30e3\u3067\u3001\u3053\u308c\u3089\u30921\u3064\u306e\u30d0\u30a4\u30ca\u30ea\u306b\u7d71\u5408\u3057\u307e\u3059\u3002\u672c\u8a18\u4e8b\u3067\u306f uv \u3092\u624b\u3092\u52d5\u304b\u3057\u306a\u304c\u3089\u5c0e\u5165\u3057\u3001pip<\/code> \/ Poetry<\/code> \u3068\u306e\u9055\u3044\u3092\u6574\u7406\u3057\u307e\u3059\u3002<\/p>\n

uv \u3068\u306f\u4f55\u304b<\/h2>\n

uv \u306f Ruff \u306e\u958b\u767a\u5143\uff08Astral\uff09\u304c\u958b\u767a\u3059\u308b Python \u5411\u3051\u30c4\u30fc\u30eb\u3067\u3001\u6b21\u306e\u5f79\u5272\u3092\u7d71\u5408\u3057\u3066\u3044\u307e\u3059\u3002<\/p>\n

    \n
  • \u4eee\u60f3\u74b0\u5883\u306e\u4f5c\u6210\uff08venv \u76f8\u5f53\uff09<\/li>\n
  • \u4f9d\u5b58\u89e3\u6c7a\u30fb\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\uff08pip \u76f8\u5f53\uff09<\/li>\n
  • \u30ed\u30c3\u30af\u30d5\u30a1\u30a4\u30eb\u30fb\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u7ba1\u7406\uff08Poetry \/ pip-tools \u76f8\u5f53\uff09<\/li>\n
  • Python \u672c\u4f53\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u30fb\u5207\u66ff\uff08pyenv \u76f8\u5f53\uff09<\/li>\n
  • CLI \u30c4\u30fc\u30eb\u306e\u9694\u96e2\u5b9f\u884c\uff08pipx \u76f8\u5f53\uff09<\/li>\n<\/ul>\n

    Rust \u5b9f\u88c5\uff0b\u30b0\u30ed\u30fc\u30d0\u30eb\u30ad\u30e3\u30c3\u30b7\u30e5\u306b\u3088\u308a\u3001\u4f9d\u5b58\u89e3\u6c7a\u3068\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u304c\u9ad8\u901f\u3067\u3059\u3002<\/p>\n

    \u30a4\u30f3\u30b9\u30c8\u30fc\u30eb<\/h2>\n
    # macOS \/ Linux\r\ncurl -LsSf https:\/\/astral.sh\/uv\/install.sh | sh\r\n\r\n# Windows (PowerShell)\r\npowershell -c \"irm https:\/\/astral.sh\/uv\/install.ps1 | iex\"\r\n\r\n# pipx \/ Homebrew \u3067\u3082\u53ef\r\npipx install uv\r\nbrew install uv<\/pre>\n
    \u78ba\u8a8d\u3068\u30a2\u30c3\u30d7\u30c7\u30fc\u30c8:<\/p>\n
    uv --version\r\nuv self update<\/pre>\n
    \u30cf\u30f3\u30ba\u30aa\u30f31: \u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3092\u4f5c\u308b<\/h2>\n
    uv init my-app\r\ncd my-app<\/pre>\n
    \u751f\u6210\u7269:<\/p>\n
    my-app\/\r\n\u251c\u2500\u2500 .python-version\r\n\u251c\u2500\u2500 pyproject.toml\r\n\u251c\u2500\u2500 README.md\r\n\u2514\u2500\u2500 main.py<\/pre>\n
    pyproject.toml<\/code>\uff08\u629c\u7c8b\uff09:<\/p>\n
    [project]\r\nname = \"my-app\"\r\nversion = \"0.1.0\"\r\nrequires-python = \">=3.12\"\r\ndependencies = []<\/pre>\n
    \u30cf\u30f3\u30ba\u30aa\u30f32: \u4f9d\u5b58\u3092\u8ffd\u52a0\u3059\u308b<\/h2>\n
    uv add requests               # \u672c\u756a\u4f9d\u5b58\r\nuv add --dev pytest ruff      # \u958b\u767a\u4f9d\u5b58\r\nuv add \"requests>=2.31,<3\"    # \u30d0\u30fc\u30b8\u30e7\u30f3\u6307\u5b9a\r\nuv remove requests            # \u524a\u9664<\/pre>\n
    uv add<\/code> 1\u56de\u3067\u300c.venv \u4f5c\u6210 \u2192 \u4f9d\u5b58\u89e3\u6c7a \u2192 pyproject.toml \u66f4\u65b0 \u2192 uv.lock \u66f4\u65b0 \u2192 \u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u300d\u307e\u3067\u307e\u3068\u3081\u3066\u5b9f\u884c\u3055\u308c\u307e\u3059\u3002<\/p>\n
    \u30cf\u30f3\u30ba\u30aa\u30f33: \u30b3\u30fc\u30c9\u3092\u5b9f\u884c\u3059\u308b<\/h2>\n
    uv run python main.py\r\nuv run pytest\r\nuv run ruff check .<\/pre>\n
    uv run<\/code> \u306f\u5b9f\u884c\u524d\u306b\u30ed\u30c3\u30af\u3068\u74b0\u5883\u3092\u81ea\u52d5\u540c\u671f\u3059\u308b\u305f\u3081\u3001\u4eee\u60f3\u74b0\u5883\u306e\u6709\u52b9\u5316\u3092\u7701\u3051\u307e\u3059\u3002\u5f93\u6765\u3069\u304a\u308a\u306e\u6709\u52b9\u5316\u3082\u53ef\u80fd\u3067\u3059\u3002<\/p>\n
    source .venv\/bin\/activate     # Windows: .venv\\Scripts\\activate\r\npython main.py<\/pre>\n
    \u30cf\u30f3\u30ba\u30aa\u30f34: \u30ed\u30c3\u30af\u3068\u540c\u671f<\/h2>\n
    uv lock            # pyproject.toml \u304b\u3089 uv.lock \u3092\u751f\u6210\u30fb\u66f4\u65b0\r\nuv sync            # uv.lock \u3069\u304a\u308a\u306b .venv \u3092\u63c3\u3048\u308b<\/pre>\n
    CI \u3067\u306f\u6b21\u306e\u3088\u3046\u306b\u300c\u30ed\u30c3\u30af\u304c\u6700\u65b0\u3067\u3042\u308b\u3053\u3068\u300d\u3092\u691c\u8a3c\u3057\u3066\u304b\u3089\u56fa\u5b9a\u540c\u671f\u3059\u308b\u3068\u5b89\u5168\u3067\u3059\u3002<\/p>\n
    uv lock --check    # lock \u304c\u305a\u308c\u3066\u3044\u305f\u3089\u5931\u6557\r\nuv sync --frozen   # lock \u3092\u66f8\u304d\u63db\u3048\u305a\u3001\u305d\u306e\u5185\u5bb9\u3067\u540c\u671f<\/pre>\n
    uv.lock<\/code> \u306f Git \u306b\u30b3\u30df\u30c3\u30c8\u3057\u3066\u5171\u6709\u3057\u307e\u3059\u3002<\/p>\n
    \u30cf\u30f3\u30ba\u30aa\u30f35: Python \u672c\u4f53\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u7ba1\u7406<\/h2>\n
    uv python list             # \u5229\u7528\u53ef\u80fd\u306a Python \u4e00\u89a7\r\nuv python install 3.12     # \u53d6\u5f97\r\nuv python pin 3.12         # .python-version \u3092\u66f4\u65b0<\/pre>\n
    uv run<\/code> \/ uv sync<\/code> \u306f .python-version<\/code> \u3068 requires-python<\/code> \u3092\u898b\u3066\u3001\u5fc5\u8981\u306a Python \u3092\u81ea\u52d5\u3067\u7528\u610f\u3057\u307e\u3059\uff08pyenv \u304c\u4e0d\u8981\u306b\u306a\u308b\u30b1\u30fc\u30b9\u304c\u591a\u3044\uff09\u3002<\/p>\n
    \u30cf\u30f3\u30ba\u30aa\u30f36: CLI \u30c4\u30fc\u30eb\u306e\u9694\u96e2\u5b9f\u884c\uff08pipx \u76f8\u5f53\uff09<\/h2>\n
    uvx ruff check .           # \u4e00\u6642\u5b9f\u884c\uff08\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3092\u6b8b\u3055\u306a\u3044\uff09\r\nuv tool install ruff       # \u6052\u4e45\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb<\/pre>\n
    pip \/ Poetry \u3068\u306e\u6bd4\u8f03<\/h2>\n\n\n\n\n\n\n\n\n\n
    \u89b3\u70b9<\/th>\npip + venv<\/th>\nPoetry<\/th>\nuv<\/th>\n<\/tr>\n<\/thead>\n
    \u4eee\u60f3\u74b0\u5883<\/td>\n\u5225\u9014 venv<\/td>\n\u5185\u8535<\/td>\n\u5185\u8535<\/td>\n<\/tr>\n
    \u30ed\u30c3\u30af<\/td>\nrequirements.txt\uff08\u624b\u904b\u7528\/pip-tools\uff09<\/td>\npoetry.lock<\/td>\nuv.lock<\/td>\n<\/tr>\n
    Python \u672c\u4f53\u7ba1\u7406<\/td>\n\u5225\u30c4\u30fc\u30eb<\/td>\n\u5225\u30c4\u30fc\u30eb<\/td>\n\u5185\u8535<\/td>\n<\/tr>\n
    CLI \u30c4\u30fc\u30eb\u9694\u96e2<\/td>\npipx \u5225\u9014<\/td>\n\u2015<\/td>\nuvx \u5185\u8535<\/td>\n<\/tr>\n
    \u5b9f\u88c5 \/ \u901f\u5ea6<\/td>\nPython \/ \u6a19\u6e96<\/td>\nPython \/ \u6a19\u6e96<\/td>\nRust \/ \u9ad8\u901f<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \u4f7f\u3044\u5206\u3051\u306e\u76ee\u5b89:<\/p>\n
      \n
    • 1\u30d5\u30a1\u30a4\u30eb\u52d5\u304b\u3059\u3060\u3051 \u2192 pip \u3067\u5341\u5206<\/li>\n
    • Poetry \u8cc7\u7523\u306b\u539a\u304f\u4e57\u3063\u3066\u3044\u308b \u2192 \u7d99\u7d9a\u3082\u5408\u7406\u7684<\/li>\n
    • \u4f9d\u5b58\u30fbCI\u30fbPython \u30d0\u30fc\u30b8\u30e7\u30f3\u30fbCLI \u307e\u3067\u4e00\u672c\u5316\u3057\u3066\u901f\u304f\u3057\u305f\u3044 \u2192 uv<\/li>\n<\/ul>\n
      \u65e2\u5b58\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u304b\u3089\u306e\u79fb\u884c<\/h2>\n
      requirements.txt \u304b\u3089<\/h3>\n
      uv add -r requirements.txt\r\nuv pip compile requirements.txt -o requirements.lock<\/pre>\n
      uv pip install<\/code> \/ uv pip freeze<\/code> \u306e\u3088\u3046\u306b\u3001pip \u306e\u9ad8\u901f\u306a\u4ee3\u66ff\u30d0\u30c3\u30af\u30a8\u30f3\u30c9\u3068\u3057\u3066\u4f7f\u3046\u9053\u3082\u3042\u308a\u307e\u3059\u3002<\/p>\n
      Poetry \u304b\u3089<\/h3>\n
      [tool.poetry]<\/code> \u306b\u66f8\u304b\u308c\u305f\u4f9d\u5b58\u3092 PEP 621 \u306e [project.dependencies]<\/code> \u306b\u79fb\u3057\u66ff\u3048\u3001uv lock<\/code> \u3067\u30ed\u30c3\u30af\u3092\u751f\u6210\u3057\u76f4\u3059\u306e\u304c\u57fa\u672c\u65b9\u91dd\u3067\u3059\u3002<\/p>\n
      \u78ba\u8a8d\u65b9\u6cd5<\/h2>\n
      uv --version\r\nuv run python -c \"import sys; print(sys.executable)\"  # .venv \u3092\u6307\u3057\u3066\u3044\u308c\u3070 OK\r\nuv tree                                               # \u4f9d\u5b58\u30c4\u30ea\u30fc<\/pre>\n
      \u6ce8\u610f\u70b9<\/h2>\n
        \n
      • \u30b5\u30d6\u30b3\u30de\u30f3\u30c9\u306f\u30d0\u30fc\u30b8\u30e7\u30f3\u3067\u5909\u308f\u308b\u305f\u3081\u3001uv help<\/code> \u3068 uv --version<\/code> \u3092\u6b63\u3068\u3059\u308b<\/li>\n
      • uv.lock<\/code> \u306f\u5fc5\u305a\u30b3\u30df\u30c3\u30c8\u3059\u308b\uff08\u518d\u73fe\u6027\u306e\u8981\uff09<\/li>\n
      • uv sync<\/code> \u306f\u74b0\u5883\u3092\u300c\u30ed\u30c3\u30af\u306b\u63c3\u3048\u308b\u300d\u305f\u3081\u3001\u30ed\u30c3\u30af\u5916\u306e\u624b\u52d5\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u306f\u6d88\u3048\u308b\u53ef\u80fd\u6027\u304c\u3042\u308b\u3002\u8ffd\u52a0\u306f uv add<\/code> \u306b\u7d71\u4e00\u3059\u308b<\/li>\n
      • \u4f01\u696d\u5185\u30d7\u30ed\u30ad\u30b7\uff0f\u30d7\u30e9\u30a4\u30d9\u30fc\u30c8\u30a4\u30f3\u30c7\u30c3\u30af\u30b9\u3067\u306f UV_INDEX_URL<\/code> \u3084 [[tool.uv.index]]<\/code> \u306e\u8a2d\u5b9a\u304c\u5fc5\u8981\u306b\u306a\u308b\u3053\u3068\u304c\u3042\u308b<\/li>\n
      • pip \u4e92\u63db\u306f\u5b8c\u5168\u3067\u306f\u306a\u3044\u305f\u3081\u3001\u7279\u6b8a\u30aa\u30d7\u30b7\u30e7\u30f3\u30fb\u30d7\u30e9\u30b0\u30a4\u30f3\u4f9d\u5b58\u306f\u4e8b\u524d\u691c\u8a3c\u3059\u308b<\/li>\n<\/ul>\n
        \u307e\u3068\u3081<\/h2>\n
          \n
        • uv \u306f\u4eee\u60f3\u74b0\u5883\u30fb\u4f9d\u5b58\u30fb\u30ed\u30c3\u30af\u30fbPython \u672c\u4f53\u30fbCLI \u30c4\u30fc\u30eb\u30921\u30d0\u30a4\u30ca\u30ea\u306b\u7d71\u5408\u3057\u305f\u9ad8\u901f\u30c4\u30fc\u30eb<\/li>\n
        • \u65b0\u898f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306f uv init<\/code> \u2192 uv add<\/code> \u2192 uv run<\/code> \u306e3\u30b3\u30de\u30f3\u30c9\u3067\u56de\u308a\u59cb\u3081\u308b<\/li>\n
        • \u518d\u73fe\u6027\u306f uv.lock<\/code> + uv sync<\/code>\uff08CI \u3067\u306f --frozen<\/code> \/ --check<\/code>\uff09\u3067\u62c5\u4fdd\u3059\u308b<\/li>\n
        • pip \/ Poetry \u3092\u5168\u5426\u5b9a\u3059\u308b\u3082\u306e\u3067\u306f\u306a\u304f\u3001\u300c\u4e00\u672c\u5316\u300d\u3068\u300c\u901f\u5ea6\u300d\u3092\u53d6\u308a\u305f\u3044\u3068\u304d\u306e\u5f37\u529b\u306a\u9078\u629e\u80a2<\/li>\n<\/ul>\n
          \u307e\u305a\u306f\u5c0f\u3055\u306a\u65e2\u5b58\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u30921\u3064 uv \u306b\u8f09\u305b\u66ff\u3048\u3066\u3001uv sync<\/code> \u306e\u901f\u3055\u3068 uv run<\/code> \u306e\u624b\u8efd\u3055\u3092\u4f53\u611f\u3057\u3066\u307f\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
          Python \u306e\u30d1\u30c3\u30b1\u30fc\u30b8\u7ba1\u7406\u306f\u9577\u3089\u304f pip + venv + requirements.txt \u304c\u5b9a\u756a\u3067\u3057\u305f\u304c\u3001\u4f9d\u5b58\u89e3\u6c7a\u306e\u9045\u3055\u30fb\u30ed\u30c3\u30af\u306e\u5f31\u3055\u30fbPython \u672c\u4f53\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u7ba1\u7406\u3092\u5225\u30c4\u30fc\u30eb\u306b\u983c\u308b\u70b9\u304c\u8ab2\u984c\u3067\u3057\u305f\u3002uv \u306f Rust \u88fd\u306e\u9ad8\u901f\u2026<\/p>\n","protected":false},"author":1,"featured_media":3305,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"vkexunit_cta_each_option":"","footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[1],"tags":[],"class_list":["post-3306","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-1"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/qol-kk.com\/wp2\/wp-content\/uploads\/2026\/08\/20260825-plan009-thumbnail.png","jetpack-related-posts":[],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3306","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/comments?post=3306"}],"version-history":[{"count":1,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3306\/revisions"}],"predecessor-version":[{"id":3312,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3306\/revisions\/3312"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media\/3305"}],"wp:attachment":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media?parent=3306"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/categories?post=3306"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/tags?post=3306"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}