<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>環境構築 &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/environment-setup/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Sat, 21 Nov 2026 11:14:38 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>環境構築 &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</title>
		<link>https://cfxlog.com/linux-vps-roadmap/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Fri, 20 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5928</guid>

					<description><![CDATA[VPS で Web サイトを公開するまでの作業は、大きく5つの段階に分けられます。 この記事では、段階ごとに何をするのか、なぜ必要なのかを短くまとめ、詳しい手順の記事へ案内します。 僕は以前エックスサーバーVPSを使って [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>個人で VPS を借りたいけど、何から始めればいいか分からない</li>



<li>Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい</li>



<li>HTTPS 化や Docker での運用まで、どの順番で進めればいいか迷う</li>
</ul>
</div></div>



<p class="wp-block-paragraph">VPS で Web サイトを公開するまでの作業は、<strong>大きく5つの段階</strong>に分けられます。</p>



<p class="wp-block-paragraph">この記事では、段階ごとに何をするのか、なぜ必要なのかを短くまとめ、詳しい手順の記事へ案内します。</p>



<p class="wp-block-paragraph">僕は以前エックスサーバーVPSを使っていて、今は KAGOYA CLOUD VPS に移っています。</p>



<p class="wp-block-paragraph">nginx は Docker で動かしていて、このブログもその nginx から配信しています。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>VPS でサイトを公開するまでの5段階</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>VPS を借りる</li>



<li>安全にログインできるようにする</li>



<li>Web サーバー（nginx）を立てる</li>



<li>HTTPS とドメインを設定する</li>



<li>Docker で運用する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">①〜④は、サイトを公開するのに<strong>必ず通る段階</strong>です。⑤は、慣れてから移っても間に合います。</p>



<h2 class="wp-block-heading">① VPS を借りる：プランと OS を決めてサーバーを作る</h2>



<p class="wp-block-paragraph">最初に、VPS の事業者を選んでサーバーを1台作ります。申し込みでは、メモリの大きさ（プラン）と OS を選びます。</p>



<p class="wp-block-paragraph">作り終えると、<strong>サーバーの IP アドレスと、ログインする手段</strong>が手に入ります。ここから先の作業は、すべてこのサーバーに入って行います。</p>



<p class="wp-block-paragraph">OS に迷ったら Ubuntu で大丈夫です。このブログのサーバー系の記事も、Ubuntu を前提にしています。</p>



<h3 class="wp-block-heading">メモリは何GBにするか</h3>



<p class="wp-block-paragraph">プランで一番迷うのはメモリです。僕の VPS で実際の使用量を測り、2GB で足りるかと、4GB・8GB にする目安をまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-vps-memory-size/">VPSのメモリは何GB必要？2GBで足りるかの実測と4GB・8GBの目安</a>
						<span class="p-blogCard__excerpt">VPS のプランを選んでいて、メモリを何GBにするか迷っている 2GB で足りるのか、念のため 4GB にしておくべきか分からない Docker で複数のアプリを動かすと、どれくら&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">KAGOYA CLOUD VPS で作る</h3>



<p class="wp-block-paragraph">僕が今使っているのは KAGOYA CLOUD VPS です。インスタンスの作成から最初のログインまでを、次の記事にまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-300x130.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-kagoya-vps-setup/">KAGOYA CLOUD VPSの使い方｜インスタンス作成からSSH接続・初期設定まで【Ubuntu】</a>
						<span class="p-blogCard__excerpt">KAGOYA CLOUD VPS を契約したけれど、最初に何をすればいいか分からない インスタンス作成画面の項目が多くて、どれを選べばいいか迷う SSH でログインして、最低限の初&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"><a href="https://px.a8.net/svt/ejp?a8mat=4BGO4I+CIDQQ+7YE+TR13N&amp;a8ejpredirect=https%3A%2F%2Fwww.kagoya.jp%2Fvps%2F" rel="nofollow sponsored">KAGOYA CLOUD VPS の公式サイトを見る</a></p>



<h3 class="wp-block-heading">エックスサーバーVPS で作る</h3>



<p class="wp-block-paragraph">エックスサーバーVPS の申し込み手順は、こちらの記事にあります。僕が以前使っていたときに書いたものです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-xserver-vps-setup-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-xserver-vps-setup/">【簡単】エックスサーバーVPS（XServer VPS）の申し込み方法</a>
						<span class="p-blogCard__excerpt">エックスサーバーVPS の申し込みをしたい方向けの記事です。 サーバーの契約、なんとなく身構えてしまいますよね。 なんとなく難しそう… 設定が大変そう… 複雑なんじゃ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">② 安全にログインする：SSH と一般ユーザーを用意する</h2>



<p class="wp-block-paragraph">次に、手元の PC から SSH でサーバーに入れるようにします。あわせて、root ではなく sudo できる一般ユーザーで作業する形に変えます。</p>



<p class="wp-block-paragraph">VPS は、作った直後からインターネットに公開されます。<strong>SSH へのログインの試行もすぐに届く</strong>ので、公開より先にここを固めておきます。</p>



<p class="wp-block-paragraph">実際にどんな通信が来るのかは、僕の VPS のログをまとめた記事で見られます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/vps-security-measures-300x158.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vps-security-measures/">【VPSのセキュリティ対策】個人のVPSに1週間でどんな攻撃が来たか？実際のログと防ぎ方</a>
						<span class="p-blogCard__excerpt">個人開発で Web サービスを公開するために、VPS を運用しています。 今回は、そんな僕の VPS にどんな攻撃が来ているのか、1週間分のログを集計してみました。 結果は次&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">SSH でサーバーに接続する</h3>



<p class="wp-block-paragraph">パスワードと公開鍵の2つの接続方法と、つながらないときの確かめ方は、こちらにまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ssh-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ssh-guide/">SSH接続の方法｜基本の手順から便利な設定・トラブルシューティングまで</a>
						<span class="p-blogCard__excerpt">公開鍵方式ってなんだか苦手… 秘密鍵と公開鍵、何が違うの？ 鍵のセットアップがわからん！ このような方に向けて書きました。 Webのお仕事をしていると、当然のように&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">エックスサーバーVPS を使っている場合は、VPS パネルでの鍵の作り方から書いたこちらの記事が近いです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-xserver-vps-ssh-300x158.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-xserver-vps-ssh/">【エックスサーバーVPS】SSH接続する方法</a>
						<span class="p-blogCard__excerpt">エックスサーバーVPSでSSH接続がしたい！ このような疑問にお答えします。 サーバーとの通信にはSSH接続が必須です。 慣れてしまえば簡単なのですが、サーバーを触りた&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">root でのログインをやめ、一般ユーザーで作業する</h3>



<p class="wp-block-paragraph">root のまま作業すると、打ち間違い1つでサーバー全体を壊しかねません。一般ユーザーを作り、必要なときだけ sudo を使います。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ubuntu-user-management-security-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ubuntu-user-management-security/">Ubuntuのスーパーユーザーとrootログイン禁止・sudo設定</a>
						<span class="p-blogCard__excerpt">Ubuntuのユーザーってどんなもの？ 普段rootユーザーでログインしてる… セキュリティ対策が気になる このような方に向けて書きました。 普段 root ユーザーのまま Ubunt&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">サーバーから GitHub を使う</h3>



<p class="wp-block-paragraph">サーバーで git clone するときに、手元の SSH 鍵をそのまま使う方法です。サーバーに秘密鍵を置かずに済みます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ssh-agent-forwarding-github-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ssh-agent-forwarding-github/">ローカルのSSHキーを使ってリモートサーバーからGitHub操作をする方法</a>
						<span class="p-blogCard__excerpt">リモートサーバーでGitHub操作を行うとき、秘密鍵を置くのはセキュリティ的に不安… そんな時に便利なのがSSHエージェントフォワーディングです。 これを利用すれば、リ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">鍵だけでログインする設定と、締め出されないための確かめ方は、こちらにまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vps-ssh-hardening/">sshd_configの設定｜SSHのパスワード無効・rootログイン禁止の手順</a>
						<span class="p-blogCard__excerpt">SSH のパスワードログインを止めたのに、sshd -T で見ると yes のまま sshd_config と sshd_config.d のどこに書けば効くのか分からない 設定を間違えて、自分がサーバ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">③ Web サーバーを立てる：nginx でサイトを表示する</h2>



<p class="wp-block-paragraph">ログインできたら、Web サーバーの nginx を動かします。ブラウザでアクセスしたときに、HTML を返すのが nginx の役目です。</p>



<p class="wp-block-paragraph">Django などのアプリを動かす場合も、<strong>nginx を入口にしてアプリへ転送する</strong>形が基本になります。</p>



<h3 class="wp-block-heading">nginx の基本を知る</h3>



<p class="wp-block-paragraph">nginx が何をするソフトなのかと、インストールから起動までは、こちらの入門記事にあります。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/nginx-beginner-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nginx-beginner-guide/">Nginxとは？初心者向け入門｜設定ファイルと使い方を解説</a>
						<span class="p-blogCard__excerpt">会社でNginxを使うことになったけど、何が何だかさっぱりだ… Nginxはインストールできたけど、設定ファイルの意味が全然わからない。 エラーが出てもどう対処したらいい&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">設定ファイルの場所と書き方を知る</h3>



<p class="wp-block-paragraph">nginx.conf・conf.d・sites-available のどこに書くのかをまとめました。apt 版と Docker 版の違いも書いています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nginx-config-location/">nginxの設定ファイルの場所と書き方｜nginx.conf・conf.d・sites-availableの違い</a>
						<span class="p-blogCard__excerpt">nginx の設定ファイルがどこにあるのか分からない nginx.conf・conf.d・sites-available のどこに書けばいいのか迷う location の書き方と、変更を安全に反映する手順を&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">アプリへ転送する（リバースプロキシ）</h3>



<p class="wp-block-paragraph">アプリの前に nginx を置くときは、proxy_pass の末尾の / で転送先のパスが変わることと、Host などのヘッダーを足すことに気をつけます。手元の Docker で、アプリに届くパスとヘッダーを確かめながらまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nginx-reverse-proxy/">nginxリバースプロキシの設定｜proxy_passの末尾スラッシュとHost</a>
						<span class="p-blogCard__excerpt">nginx でアプリへ転送したら、アプリ側で Host やアクセス元の IP がおかしい proxy_pass の最後に / を付けるかどうかで、転送先のパスが変わって混乱している /api/ &#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Django を Gunicorn と nginx で動かす</h3>



<p class="wp-block-paragraph">Python のアプリを公開するなら、Gunicorn でアプリを動かし、nginx から転送します。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/gunicorn-django-basics/">GunicornでDjangoプロジェクトをデプロイする方法【Nginx使用】</a>
						<span class="p-blogCard__excerpt">Gunicornの設定が難しすぎる… 動かすコマンドは？ 実践的な設定方法を教えて！ このような方に向けて書きました。 中小規模のDjangoアプリのデプロイによく使われるアプ&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">502・504 が出たら</h3>



<p class="wp-block-paragraph">nginx の裏のアプリにつながらないと、502 Bad Gateway や 504 Gateway Timeout が出ます。原因は nginx のエラーログの1行で見分けられます。手元の Docker で再現し、ログの文言ごとに原因と直し方をまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nginx-502-504-bad-gateway/">nginxの502 Bad Gateway・504の原因と直し方｜ログで切り分け</a>
						<span class="p-blogCard__excerpt">nginx の裏のアプリにつないだら、502 Bad Gateway や 504 Gateway Timeout が出た どちらも「アプリがおかしい」のは分かるが、どこから調べればいいか分からない Guni&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">④ HTTPS とドメイン：DNS を向けて証明書を取る</h2>



<p class="wp-block-paragraph">サイトが表示できたら、独自ドメインで HTTPS にします。<strong>DNS を先に設定し、そのあとで証明書を取る</strong>順番です。</p>



<p class="wp-block-paragraph">Let&#8217;s Encrypt の証明書は、ドメインがそのサーバーを指していないと発行できません。そのため、DNS が向いたのを確かめてから進めます。</p>



<p class="wp-block-paragraph">HTTP のままだと、ブラウザに「保護されていない通信」と表示されます。フォームやログインがあるサイトでは、HTTPS は欠かせません。</p>



<h3 class="wp-block-heading">DNS がサーバーを向いたか dig で確かめる</h3>



<p class="wp-block-paragraph">ドメインの A レコードを VPS の IP アドレスにしたら、dig コマンドで反映されたかを確かめます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/linux-dig-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-dig-command/">【完全保存版】digコマンドの全網羅ガイド｜DNS調査・トラブルシューティングの必須ツールを徹底解説</a>
						<span class="p-blogCard__excerpt">DNS の調査や、サイトが表示されない時のトラブルシューティングでは dig コマンドが便利。 この記事では、初級〜上級エンジニアまで必ず使える 「dig の使い方を可能な&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">メールを使わないドメインなら、SPF と DMARC で「このドメインからは送らない」と宣言しておきます。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/dns-spf-dmarc-no-mail-domain/">メール送信しないドメインのSPF・DMARC｜v=spf1 -allの設定</a>
						<span class="p-blogCard__excerpt">Web サイトだけで、メールは使わないドメインを持っている メールを送らないなら、SPF や DMARC は設定しなくていいのか知りたい TXT レコードを足したら、前からあった&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Let&#8217;s Encrypt（Certbot）で HTTPS にする</h3>



<p class="wp-block-paragraph">Certbot で証明書を取り、nginx の設定に組み込んで、自動更新まで行う手順です。Django のサイトを例にしています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-certbot-https-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-certbot-https/">【Django + Let’s Encrypt】CerbotでHTTPS化するための手順</a>
						<span class="p-blogCard__excerpt">ブラウザで警告が表示されてる 暗号化されていないので不安 ユーザー管理しているのでちゃんとしておきたい サイトを公開後にまず取り組むべきは、HTTPS化です。 HTTPS&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">ドメインのネームサーバーを VPS の事業者へ移す手順は、準備中です。</p>



<h2 class="wp-block-heading">⑤ Docker で運用する：nginx とアプリをコンテナにまとめる</h2>



<p class="wp-block-paragraph">最後は、nginx やアプリを Docker のコンテナで動かす形です。構成を compose.yaml に書いておくと、<strong>サーバーの構成がファイルに残ります</strong>。</p>



<p class="wp-block-paragraph">サーバーを作り直すときも、同じファイルから同じ構成を立ち上げられます。僕も今は、nginx を Docker で動かしています。</p>



<h3 class="wp-block-heading">Docker Compose の基本</h3>



<p class="wp-block-paragraph">compose.yaml の書き方と、よく使う docker compose のコマンドはこちらです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/docker-compose-guide/">Docker Composeの使い方｜compose.yamlの書き方とコマンド</a>
						<span class="p-blogCard__excerpt">docker run のオプションが長くなって、毎回打つのがつらい Web アプリと DB をまとめて起動・停止したい compose.yaml の depends_on や ports の書き方がよく分からな&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">docker-compose と docker compose の違い</h3>



<p class="wp-block-paragraph">古い記事のコマンドが動かないときは、新旧のコマンドの対応を見てください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-docker-command-mapping-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-docker-command-mapping/">【Docker】新旧コマンドの対応関係</a>
						<span class="p-blogCard__excerpt">Dockerの新旧コマンドの対応関係が知りたい！ docker psコマンドが古いコマンドとは知らなかった… このような方に向けて書きました。 2017年1月に公表されたDocker 1.13&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">nginx-proxy で証明書を自動で取る</h3>



<p class="wp-block-paragraph">nginx-proxy の構成で、Let&#8217;s Encrypt の証明書が何度も発行されてしまったときの原因と対策です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/docker-nginx-proxy-letsencrypt-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/docker-nginx-proxy-letsencrypt/">【Docker + nginx-proxy】Let&#8217;s Encrypt 証明書が何度も発行される原因と対策</a>
						<span class="p-blogCard__excerpt">ところが、構成ミスやDNS未設定などにより証明書の自動発行がループしてしまい、Let&#8217;s Encrypt の レートリミット（制限）に引っかかることがあります。 今回は実際に起&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">Docker Compose と nginx で、1台の VPS に複数のサイトを HTTPS で置く構成は、こちらです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/docker-compose-nginx-multi-site/">docker compose nginxで複数サイト｜1台のVPSでHTTPS化</a>
						<span class="p-blogCard__excerpt">1台の VPS で、複数のサイトやアプリを動かしたい Docker Compose で動かしているアプリを、nginx でまとめて HTTPS にしたい アプリや DB のポートをどこまで外に出し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">公開後の運用・保守</h2>



<p class="wp-block-paragraph">サイトを公開したあとは、証明書の更新やバックアップを決まった時間に回し、エラーが出たら原因を切り分けます。順番に進める手順ではないので、必要になったときに読んでください。</p>



<h3 class="wp-block-heading">決まった時間に処理を動かす（systemd タイマー）</h3>



<p class="wp-block-paragraph">僕の VPS では、証明書の更新やバックアップを systemd のタイマーで動かしています。cron の代わりに使う書き方と、動いたかの確かめ方をまとめました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-systemd-timer/">systemd timerの使い方｜cronの代わりに定期実行する設定と確認方法</a>
						<span class="p-blogCard__excerpt">VPS で、証明書の更新やバックアップを決まった時間に自動で動かしたい cron の代わりに systemd timer を使う方法を知りたい タイマーがちゃんと動いたのか、結果をど&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Django が 400 を返したら</h3>



<p class="wp-block-paragraph">Docker Compose のサービス名にアンダースコアを使うと、Django が Invalid HTTP_HOST header で 400 を返すことがあります。原因と直し方はこちらです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-invalid-http-host-underscore/">Invalid HTTP_HOST headerの原因と直し方｜Django</a>
						<span class="p-blogCard__excerpt">Django に「Invalid HTTP_HOST header」と出て、400 Bad Request になる エラーに「not valid according to RFC 1034/1035」と書かれている ALLOWED_HOSTS に &#8220;*&#8221; を入&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">補助：サーバー作業でよく使う Linux コマンド</h2>



<p class="wp-block-paragraph">どの段階でも、ファイルを探す・開く・中身を読むといった操作が出てきます。つまずいたときに見返せるよう、よく使うコマンドをまとめておきます。</p>



<p class="wp-block-paragraph">設定ファイルやログの場所が分からないときは、find で探します。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-find-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-find-command/">Linuxのファイル検索｜findでファイル名・部分一致で探す</a>
						<span class="p-blogCard__excerpt">Linux でファイルの検索がしたい！ このような方に向けて書きました。 Linux でファイル検索をしたいときは、findコマンドを使うのが効率的です。 本記事ではファイルを&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">サーバー上で設定ファイルを書き換えるときは、nano が手軽です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-nano-editor-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-nano-editor-guide/">【保存版】nano エディタ完全入門</a>
						<span class="p-blogCard__excerpt">Linux や VPS に SSH でログインしたとき、最初に出会うエディタが nano という人は多いはず。 vi は難しそう vim は覚えることが多い とりあえず今すぐファイルを直し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">長いログを開いて読むときは、less を使います。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-less-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-less-command/">【Linux】lessコマンドでログファイルの中身を閲覧してみよう！</a>
						<span class="p-blogCard__excerpt">Linuxでファイルの中身を確認したい ログファイルを見たい ページごとに閲覧したい このような方に向けて書きました。 Linux でログファイルを閲覧しようと考えたとき、&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">ログや設定の中から、特定の文字列を含む行だけを抜き出すときは grep です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-grep-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-grep-command/">【Linux】grep コマンドを使ってテキスト検索を効率化しよう！</a>
						<span class="p-blogCard__excerpt">この記事では、Linux でテキスト検索を行うためのgrepコマンドを解説します。 基本的な使い方から正規表現を使った高度な検索方法までをカバーしますので、検索に自信が&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">Docker を使わずに始めてもいいですか？</h3><div class="faq_a">
<p class="wp-block-paragraph">はい、問題ありません。</p>



<p class="wp-block-paragraph">①〜④をサーバーに直接入れて進め、慣れてから⑤の Docker へ移っても大丈夫です。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">レンタルサーバーと VPS は何が違いますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">VPS は、OS から上を自分で管理するサーバーです。</p>



<p class="wp-block-paragraph">レンタルサーバーは事業者が管理するので手間は少ないですが、入れられるソフトや設定に制限があります。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：①から順に進めれば VPS でサイトを公開できる</h2>



<p class="wp-block-paragraph">VPS でのサイト公開は、借りる・ログイン・Web サーバー・HTTPS・Docker の5段階で進みます。まずは①のサーバー作りから始めてみてください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-300x130.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-kagoya-vps-setup/">KAGOYA CLOUD VPSの使い方｜インスタンス作成からSSH接続・初期設定まで【Ubuntu】</a>
						<span class="p-blogCard__excerpt">KAGOYA CLOUD VPS を契約したけれど、最初に何をすればいいか分からない インスタンス作成画面の項目が多くて、どれを選べばいいか迷う SSH でログインして、最低限の初&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>KAGOYA CLOUD VPSの使い方｜インスタンス作成からSSH接続・初期設定まで【Ubuntu】</title>
		<link>https://cfxlog.com/linux-kagoya-vps-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 18 Nov 2026 22:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[SSH]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5866</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-1024x444.png" class="webfeedsFeaturedVisual" /></p>僕はこれまでエックスサーバーVPSを使っていましたが、料金の値上がりをきっかけに、より安い KAGOYA CLOUD VPS へ移りました。 この記事では、2026年11月6日に実際に KAGOYA CLOUD VPS  [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-1024x444.png" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>KAGOYA CLOUD VPS を契約したけれど、最初に何をすればいいか分からない</li>

<li>インスタンス作成画面の項目が多くて、どれを選べばいいか迷う</li>

<li>SSH でログインして、最低限の初期設定まで済ませたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">僕はこれまでエックスサーバーVPSを使っていましたが、料金の値上がりをきっかけに、より安い KAGOYA CLOUD VPS へ移りました。</p>



<p class="wp-block-paragraph">この記事では、<strong>2026年11月6日に実際に KAGOYA CLOUD VPS でインスタンスを作り、SSH で接続して初期設定を済ませるまでの手順</strong>を、そのときの画面とあわせてまとめます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>この記事でやること</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>Ubuntu のインスタンスを作成する</li>



<li>SSH の鍵でログインする</li>



<li>パッケージを更新して再起動する</li>



<li>SSH のパスワードログインを止める</li>



<li>独自ドメインの A レコードを KAGOYA の DNS に登録する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">料金や画面は、いずれも2026年11月6日に確認したものです。最新の内容は公式サイトで確認してください。</p>



<p class="wp-block-paragraph"><a href="https://px.a8.net/svt/ejp?a8mat=4BGO4I+CIDQQ+7YE+TR13N&amp;a8ejpredirect=https%3A%2F%2Fwww.kagoya.jp%2Fvps%2F" rel="nofollow sponsored">KAGOYA CLOUD VPS の公式サイトを見る</a></p>



<h2 class="wp-block-heading">KAGOYA CLOUD VPS でインスタンスを作成する</h2>



<p class="wp-block-paragraph">KAGOYA CLOUD VPS では、サーバー1台のことを「インスタンス」と呼びます。コントロールパネルにログインしたら、まずはインスタンスを1つ作ります。</p>



<h3 class="wp-block-heading">作成前に画面上部のお知らせを確認する</h3>



<p class="wp-block-paragraph">インスタンス一覧を開いた時点では、まだインスタンスはありません。右上の「インスタンス作成」から作成画面に進みます。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1545" height="360" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty.png" alt="KAGOYA CLOUD VPS のインスタンス一覧。作成済みインスタンスがない状態" class="wp-image-5859" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty.png 1545w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty-300x70.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty-1024x239.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty-768x179.png 768w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-list-empty-1536x358.png 1536w" sizes="(max-width: 1545px) 100vw, 1545px" /><figcaption class="wp-element-caption">作成前のインスタンス一覧（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">画面の上に赤字でお知らせが出ていることがあります。僕が作成したときは、次の2つが表示されていました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>2026年9月1日より、定期スナップショットは停止中</li>

<li>2026年11月4日より、一時的にインスタンス作成ができない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">お知らせの<a href="https://www.kagoya.jp/news/2026110437314/">障害案内</a>では、新規作成は失敗する可能性が高く、2026年11月8日以降に作成するよう案内されていました。僕は11月6日に試したところ作成できましたが、同じような案内が出ているときは、お知らせのページを先に読んでおくと安心です。</p>



<h3 class="wp-block-heading">OS とセットアップを選ぶ</h3>



<p class="wp-block-paragraph">「パッケージ」の「OSテンプレート」から OS を選びます。今回は <strong>Ubuntu Server 26.04 LTS</strong> を選びました。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1500" height="1045" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-os-setup.png" alt="インスタンス作成画面で Ubuntu Server 26.04 LTS と、セットアップの「指定しない」を選んだ状態" class="wp-image-5860" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-os-setup.png 1500w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-os-setup-300x209.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-os-setup-1024x713.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-os-setup-768x535.png 768w" sizes="(max-width: 1500px) 100vw, 1500px" /><figcaption class="wp-element-caption">OS とセットアップの選択（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">選択すると説明欄に「SSHログインユーザーは ubuntu となります」と表示されます。あとで SSH 接続するときのユーザー名なので覚えておきます。</p>



<p class="wp-block-paragraph">その下の「セットアップ」では、Docker CE や WordPress などをあらかじめ入れた状態で作成できます。今回は「指定しない」を選びました。</p>



<h3 class="wp-block-heading">スペック（料金）を選ぶ</h3>



<p class="wp-block-paragraph">「スペック」の表から、CPU・メモリ・ストレージの組み合わせを選びます。表の中の金額をクリックすると、その組み合わせが選ばれます。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1500" height="650" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec.png" alt="スペックの選択表。2コア・2GB・NVMe 200GB の日額28円・月額770円を選んだ状態" class="wp-image-5861" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec.png 1500w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-300x130.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-1024x444.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-768x333.png 768w" sizes="(max-width: 1500px) 100vw, 1500px" /><figcaption class="wp-element-caption">スペックの選択（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">僕は次の組み合わせにしました。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>選んだ値</th></tr></thead><tbody><tr><td>CPU / メモリ</td><td>2コア / 2GB</td></tr><tr><td>ストレージ</td><td>NVMe 200GB</td></tr><tr><td>料金</td><td>日額28円（月額770円）</td></tr></tbody></table><figcaption class="wp-element-caption">2026年11月6日の作成画面の表示</figcaption></figure>



<p class="wp-block-paragraph">画面には日額と月額が並んで表示されます。料金の細かい条件（日額での課金の扱いなど）は、契約前に公式サイトで確認してください。</p>



<h3 class="wp-block-heading">ログイン用認証キーを作る</h3>



<p class="wp-block-paragraph">「ログイン用認証キー」は、SSH でログインするための鍵です。初めて作るときは「作成済みのログイン用認証キーがありません」と表示されるので、右側の「ログイン用認証キー追加」から作成します。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1500" height="260" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-key-virtio.png" alt="ログイン用認証キーと virtio の設定欄" class="wp-image-5862" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-key-virtio.png 1500w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-key-virtio-300x52.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-key-virtio-1024x177.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-key-virtio-768x133.png 768w" sizes="(max-width: 1500px) 100vw, 1500px" /><figcaption class="wp-element-caption">ログイン用認証キーと virtio（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">キーを作ると、秘密鍵のファイルをダウンロードできます。KAGOYA の<a href="https://support.kagoya.jp/vps/manual/index.php?solution_id=1000">ログイン用認証キー作成手順</a>では、<strong>秘密鍵をダウンロードできるのは作成時だけ</strong>と案内されています。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：秘密鍵はなくさない</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">ダウンロードした秘密鍵を失くすと、その鍵ではログインできなくなります。ダウンロードしたら、すぐに次の章の手順で <code>~/.ssh/</code> に移しておきましょう。</p>
</div></div>



<p class="wp-block-paragraph">virtio は「ON」を選びました。</p>



<h3 class="wp-block-heading">インスタンス名を入れて作成する</h3>



<p class="wp-block-paragraph">「コンソールログインパスワード」を入力し、「インスタンス名」に分かりやすい名前を付けます。この記事では <code>my-vps</code> とします。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1500" height="490" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-name-price.png" alt="インスタンス名に my-vps と入力し、料金が28円/日・770円/月と表示された作成画面の下部" class="wp-image-5863" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-name-price.png 1500w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-name-price-300x98.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-name-price-1024x335.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-name-price-768x251.png 768w" sizes="(max-width: 1500px) 100vw, 1500px" /><figcaption class="wp-element-caption">インスタンス名と料金の確認（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">今回はセキュリティグループ、ネットワーク、ユーザーデータ、備考は何も設定していません。画面下の料金を確認して「インスタンス作成」を押せば完了です。</p>



<h3 class="wp-block-heading">インスタンスが起動中になったことを確認する</h3>



<p class="wp-block-paragraph">作成が終わると、インスタンス一覧に表示されます。左端の電源アイコンが緑色なら起動中です。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1544" height="360" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running.png" alt="インスタンス一覧に my-vps が2コア・2GB・200GB・NVMe で表示されている状態" class="wp-image-5864" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running.png 1544w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running-300x70.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running-1024x239.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running-768x179.png 768w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-instance-running-1536x358.png 1536w" sizes="(max-width: 1544px) 100vw, 1544px" /><figcaption class="wp-element-caption">作成後のインスタンス一覧。IP は伏せています（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">一覧の「IP」の列に、このインスタンスに割り当てられた IP アドレスが表示されます。次の SSH 接続で使うので控えておきます。</p>



<h2 class="wp-block-heading">SSH で VPS に接続する</h2>



<p class="wp-block-paragraph">ここからはパソコン（僕は Mac）のターミナルで作業します。以下のコマンドの <code>VPS_IP</code> は、インスタンス一覧で確認した IP アドレスに置き換えてください。</p>



<h3 class="wp-block-heading">秘密鍵を ~/.ssh に移して権限を絞る</h3>



<p class="wp-block-paragraph">ダウンロードした秘密鍵を <code>~/.ssh/</code> に移し、自分だけが読めるように権限を <code>600</code> にします。ファイル名はダウンロードしたものに合わせてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>mv ~/Downloads/my-vps.key ~/.ssh/
chmod 600 ~/.ssh/my-vps.key</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">mv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/Downloads/my-vps.key</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.ssh/</span></span>
<span class="line"><span style="color: #DCDCAA">chmod</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">600</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.ssh/my-vps.key</span></span></code></pre></div>



<p class="wp-block-paragraph">ダウンロードフォルダには元のファイルを残さないようにしました。</p>



<h3 class="wp-block-heading">ubuntu ユーザーでログインする</h3>



<p class="wp-block-paragraph">ユーザー名は、OS 選択時に表示された <code>ubuntu</code> です。<code>-i</code> で秘密鍵を指定して接続します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ssh -i ~/.ssh/my-vps.key ubuntu@VPS_IP</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">ssh</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-i</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.ssh/my-vps.key</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ubuntu@VPS_IP</span></span></code></pre></div>



<p class="wp-block-paragraph">初めて接続するときは、サーバーのホスト鍵を信頼するか聞かれます。<code>yes</code> と答えると <code>~/.ssh/known_hosts</code> に登録され、次からは聞かれなくなります。</p>



<h3 class="wp-block-heading">接続できたサーバーの状態を確認する</h3>



<p class="wp-block-paragraph">ログインできたら、ユーザー名・アーキテクチャ・OS を確認しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>id -un
uname -m
head /etc/os-release</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">id</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-un</span></span>
<span class="line"><span style="color: #DCDCAA">uname</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-m</span></span>
<span class="line"><span style="color: #DCDCAA">head</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/etc/os-release</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の環境では、次のように表示されました。</p>



<figure class="wp-block-table"><table><thead><tr><th>確認したこと</th><th>結果</th></tr></thead><tbody><tr><td>ログインユーザー</td><td>ubuntu</td></tr><tr><td>アーキテクチャ</td><td>x86_64</td></tr><tr><td>OS</td><td>Ubuntu 26.04 LTS</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">作成直後のサーバーは、メモリ 1.6GiB、スワップ 4.7GiB、ルートディスクは 194GB のうち 178GB が空いていました。2GB プランでも、OS から見えるメモリは 2GB より少し小さくなります。Docker や nginx はまだ入っていない、まっさらな状態です。</p>



<h3 class="wp-block-heading">毎回のコマンドを短くする（~/.ssh/config）</h3>



<p class="wp-block-paragraph">毎回 <code>-i</code> や IP を打つのは面倒なので、Mac の <code>~/.ssh/config</code> に接続先を登録しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Host my-vps
    HostName VPS_IP
    User ubuntu
    IdentityFile ~/.ssh/my-vps.key
    IdentitiesOnly yes
    ForwardAgent no</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Host my-vps</span></span>
<span class="line"><span style="color: #D4D4D4">    HostName VPS_IP</span></span>
<span class="line"><span style="color: #D4D4D4">    User ubuntu</span></span>
<span class="line"><span style="color: #D4D4D4">    IdentityFile ~/.ssh/my-vps.key</span></span>
<span class="line"><span style="color: #D4D4D4">    IdentitiesOnly yes</span></span>
<span class="line"><span style="color: #D4D4D4">    ForwardAgent no</span></span></code></pre></div>



<p class="wp-block-paragraph">これで次のコマンドだけで接続できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ssh my-vps</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">ssh</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my-vps</span></span></code></pre></div>



<h2 class="wp-block-heading">最初にやっておく初期設定</h2>



<p class="wp-block-paragraph">ログインできたら、使い始める前に最低限の設定を済ませます。</p>



<h3 class="wp-block-heading">パッケージを更新して再起動する</h3>



<p class="wp-block-paragraph">まずは Ubuntu のパッケージを最新にします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo apt update
sudo apt upgrade</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">apt</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">update</span></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">apt</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">upgrade</span></span></code></pre></div>



<p class="wp-block-paragraph">更新の内容によっては、ログイン時のメッセージに <code>System restart required</code> と表示されます。再起動が必要になった原因のパッケージは、次のファイルで確認できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cat /var/run/reboot-required.pkgs</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">cat</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/var/run/reboot-required.pkgs</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の環境でもこの表示が出て、原因は <code>libc6</code> でした。再起動します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo reboot</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">reboot</span></span></code></pre></div>



<p class="wp-block-paragraph">SSH の接続はいったん切れます。少し待ってから、同じ鍵で再接続できることを確認しました。</p>



<h3 class="wp-block-heading">SSH のパスワードログインを止める</h3>



<p class="wp-block-paragraph">鍵でログインできることを確認したら、パスワードでのログインと root での直接ログインを止めます。Ubuntu では <code>/etc/ssh/sshd_config.d/</code> に設定ファイルを追加する方法が手軽です。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：今のターミナルは閉じない</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">設定を間違えると、新しく SSH 接続できなくなることがあります。作業中のターミナルは閉じずに残し、別のターミナルで再接続を確かめてから閉じてください。</p>
</div></div>



<p class="wp-block-paragraph">nano で設定ファイルを作ります。<strong>ファイル名は <code>01-</code> のように小さい番号から始めます</strong>。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>補足：ファイル名の番号が大事な理由</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>sshd_config.d</code> の中のファイルは名前順に読み込まれ、同じ設定が複数あるときは<strong>最初に読み込んだ値</strong>が使われます。クラウドの初期設定で <code>50-cloud-init.conf</code> などに <code>PasswordAuthentication yes</code> が書かれていると、それより後ろの名前のファイルに <code>no</code> と書いても効きません。</p>
</div></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo nano /etc/ssh/sshd_config.d/01-local.conf</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nano</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/etc/ssh/sshd_config.d/01-local.conf</span></span></code></pre></div>



<p class="wp-block-paragraph">中身は次の4行です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
PubkeyAuthentication yes</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">PasswordAuthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">KbdInteractiveAuthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">PermitRootLogin no</span></span>
<span class="line"><span style="color: #D4D4D4">PubkeyAuthentication yes</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>設定</th><th>意味</th></tr></thead><tbody><tr><td>PasswordAuthentication no</td><td>パスワードでのログインを許可しない</td></tr><tr><td>KbdInteractiveAuthentication no</td><td>キーボード入力式の認証（パスワード入力の一種）を許可しない</td></tr><tr><td>PermitRootLogin no</td><td>root ユーザーで直接ログインさせない</td></tr><tr><td>PubkeyAuthentication yes</td><td>鍵での認証を使う</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">nano の操作に慣れていない方は、こちらの記事も参考にしてください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-nano-editor-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-nano-editor-guide/">【保存版】nano エディタ完全入門</a>
						<span class="p-blogCard__excerpt">Linux や VPS に SSH でログインしたとき、最初に出会うエディタが nano という人は多いはず。 vi は難しそう vim は覚えることが多い とりあえず今すぐファイルを直し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">保存したら、設定に誤りがないかを確認してから反映します。<code>sshd -t</code> は、問題がなければ何も表示しません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo sshd -t
sudo systemctl reload ssh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sshd</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-t</span></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">systemctl</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">reload</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ssh</span></span></code></pre></div>



<p class="wp-block-paragraph">実際に有効になっている値は、<code>sshd -T</code> で確認できます。<code>passwordauthentication no</code> と表示されれば、パスワードログインは止まっています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo sshd -T | grep -i passwordauthentication</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sshd</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-T</span><span style="color: #D4D4D4"> | </span><span style="color: #DCDCAA">grep</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-i</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">passwordauthentication</span></span></code></pre></div>



<p class="wp-block-paragraph">別のターミナルから鍵で再接続できれば完了です。僕の環境でも、<code>sshd -t</code> が通り、鍵での再接続ができることを確認しました。</p>



<p class="wp-block-paragraph">Ubuntu のユーザー管理や root 権限については、こちらの記事で詳しく解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ubuntu-user-management-security-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ubuntu-user-management-security/">Ubuntuのスーパーユーザーとrootログイン禁止・sudo設定</a>
						<span class="p-blogCard__excerpt">Ubuntuのユーザーってどんなもの？ 普段rootユーザーでログインしてる… セキュリティ対策が気になる このような方に向けて書きました。 普段 root ユーザーのまま Ubunt&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">Docker を入れる（必要な場合）</h3>



<p class="wp-block-paragraph">僕は VPS でアプリをコンテナで動かすため、Docker 公式の apt リポジトリから Docker Engine と Compose プラグインを入れました。手順は <a href="https://docs.docker.com/engine/install/ubuntu/">Docker 公式のインストール手順（Ubuntu）</a>のとおりです。2026年11月6日に入れたときのバージョンは、Docker が 29.9.3、Compose が 5.7.0 でした。</p>



<p class="wp-block-paragraph">作成画面のセットアップで「Docker CE」を選ぶ方法もありますが、今回は試していません。</p>



<h2 class="wp-block-heading">独自ドメインを KAGOYA の DNS で使う</h2>



<p class="wp-block-paragraph">VPS で Web サイトを公開するなら、ドメインと IP アドレスを結び付ける必要があります。僕はドメインを別の会社（エックスサーバードメイン）で取得し、ネームサーバーを KAGOYA に向けて、KAGOYA の DNS でレコードを管理しています。</p>



<h3 class="wp-block-heading">ネームサーバーを KAGOYA に向ける</h3>



<p class="wp-block-paragraph">ドメインを取得した会社の管理画面で、ネームサーバーを次の2つに設定します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ns0.kagoya.net</li>

<li>ns1.kagoya.net</li>
</ul>
</div></div>



<p class="wp-block-paragraph">KAGOYA CLOUD VPS 側にドメインを登録した直後は、DNS レコードは0件でした。</p>



<h3 class="wp-block-heading">A レコードを登録する</h3>



<p class="wp-block-paragraph">KAGOYA の DNS レコード設定画面で「レコード追加」を押し、サブドメインごとに A レコードを登録します。値には VPS の IPv4 アドレスを入れます。</p>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="1544" height="510" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records.png" alt="KAGOYA の DNS レコード設定画面に app と map の A レコードが登録された状態" class="wp-image-5865" srcset="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records.png 1544w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records-300x99.png 300w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records-1024x338.png 1024w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records-768x254.png 768w, https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-dns-records-1536x507.png 1536w" sizes="(max-width: 1544px) 100vw, 1544px" /><figcaption class="wp-element-caption">A レコードを2件登録した状態。値の IP は伏せています（2026年11月6日撮影）</figcaption></figure>



<p class="wp-block-paragraph">この画面例では <code>app.example.com</code> と <code>map.example.com</code> の2件を登録しています。ルートドメイン（<code>example.com</code> そのもの）は、使い道が決まっていなかったので登録していません。</p>



<h3 class="wp-block-heading">反映を dig で確認する</h3>



<p class="wp-block-paragraph">KAGOYA の<a href="https://support.kagoya.jp/vps/manual/index.php?action=artikel&amp;artlang=ja&amp;cat=35&amp;id=37">公式マニュアル</a>では、レコードを設定してからネームサーバーに反映されるまで約15分かかり、更新は毎時0・15・30・45分に行われると案内されています（2026年11月6日確認）。</p>



<p class="wp-block-paragraph">実際、登録した直後に KAGOYA のネームサーバーへ問い合わせると <code>REFUSED</code> が返ってきました。少し待ってから、次のコマンドで A レコードが返ることを確認しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>dig @ns0.kagoya.net app.example.com A +norecurse +noall +comments +answer
dig @ns1.kagoya.net app.example.com A +norecurse +noall +comments +answer
dig +short A app.example.com</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">dig</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">@ns0.kagoya.net</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">app.example.com</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">A</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+norecurse</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+noall</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+comments</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+answer</span></span>
<span class="line"><span style="color: #DCDCAA">dig</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">@ns1.kagoya.net</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">app.example.com</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">A</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+norecurse</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+noall</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+comments</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+answer</span></span>
<span class="line"><span style="color: #DCDCAA">dig</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">+short</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">A</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">app.example.com</span></span></code></pre></div>



<p class="wp-block-paragraph">1行目と2行目は KAGOYA のネームサーバーに直接聞くコマンド、3行目はふだん使っている DNS で名前解決できるかを確かめるコマンドです。どれも VPS の IP アドレスが返れば反映済みです。</p>



<p class="wp-block-paragraph">dig の使い方は、こちらの記事でまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/linux-dig-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-dig-command/">【完全保存版】digコマンドの全網羅ガイド｜DNS調査・トラブルシューティングの必須ツールを徹底解説</a>
						<span class="p-blogCard__excerpt">DNS の調査や、サイトが表示されない時のトラブルシューティングでは dig コマンドが便利。 この記事では、初級〜上級エンジニアまで必ず使える 「dig の使い方を可能な&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">初期設定を終えた後の状態</h2>



<h3 class="wp-block-heading">2GB プランでのメモリの余裕</h3>



<p class="wp-block-paragraph">僕はこの 2GB プランに、Web アプリ2つ分のコンテナ（Next.js 2つ、Django、PostgreSQL、Redis）と nginx を Docker で同居させています。公開直後の実測は次のとおりでした。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>公開直後</th><th>再起動後の点検時</th></tr></thead><tbody><tr><td>メモリ使用量</td><td>約728MiB</td><td>―</td></tr><tr><td>利用可能なメモリ</td><td>約908MiB</td><td>1,052MB（1,636MB中）</td></tr><tr><td>スワップ使用量</td><td>約235MiB</td><td>0MB</td></tr></tbody></table><figcaption class="wp-element-caption">僕の構成での実測値</figcaption></figure>



<p class="wp-block-paragraph">小さめのアプリなら、2GB でも複数同居させられる余裕がありました。ただしアプリの中身によって大きく変わるので、目安として見てください。</p>



<h3 class="wp-block-heading">今回はまだやっていないこと</h3>



<p class="wp-block-paragraph">この記事の時点では、次のことはまだ行っていません。必要に応じて検討してください。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>UFW（ファイアウォール）の有効化</li>

<li>スナップショットの取得（作成時点では定期スナップショットが停止中と案内されていた）</li>

<li>VPS の外へのバックアップ</li>
</ul>
</div></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">KAGOYA CLOUD VPS でインスタンスを作り、SSH で接続して初期設定を済ませるまでの流れをまとめました。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>KAGOYA CLOUD VPS の初期設定の流れ</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>お知らせを確認してからインスタンスを作成する</li>



<li>秘密鍵を ~/.ssh に移し、権限を 600 にする</li>



<li>ubuntu ユーザーで SSH 接続する</li>



<li>パッケージを更新し、必要なら再起動する</li>



<li>鍵で入れることを確かめてから、パスワードログインを止める</li>



<li>独自ドメインを使うなら、KAGOYA の DNS に A レコードを登録する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">2GB・NVMe 200GB のプランが月額770円（2026年11月6日時点）で使えるので、個人の Web アプリやブログを動かす VPS を探している方は検討してみてください。</p>



<p class="wp-block-paragraph"><a href="https://px.a8.net/svt/ejp?a8mat=4BGO4I+CIDQQ+7YE+TR13N&amp;a8ejpredirect=https%3A%2F%2Fwww.kagoya.jp%2Fvps%2F" rel="nofollow sponsored">KAGOYA CLOUD VPS の公式サイトを見る</a></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Claude Codeの使い方｜始め方とCLAUDE.mdの書き方・権限設定</title>
		<link>https://cfxlog.com/claude-code-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 08 Nov 2026 01:00:00 +0000</pubDate>
				<category><![CDATA[Mac]]></category>
		<category><![CDATA[CLIツール]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/claude-code-guide/</guid>

					<description><![CDATA[Claude Code は、ターミナルで動く Anthropic の AI のコーディング用ツールです。ファイルを読んで、コードを書き換え、コマンドを実行するところまで任せられます。僕はいま、毎日の開発のほとんどを Cl [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Claude Code を使ってみたいけれど、インストールから何をすればいいか分からない</li>

<li>CLAUDE.md に何を書けばいいのか、どこに置けばいいのか分からない</li>

<li>確認の画面が何度も出る。どこまで許可してよいのか不安</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Claude Code は、ターミナルで動く Anthropic の AI のコーディング用ツールです。ファイルを読んで、コードを書き換え、コマンドを実行するところまで任せられます。僕はいま、毎日の開発のほとんどを Claude Code で進めていて、プロジェクトごとに <code>CLAUDE.md</code> を置いてルールを書いています。</p>



<p class="wp-block-paragraph">この記事では、インストールと最初のログインから、<code>CLAUDE.md</code> の書き方、権限の許可ルール、プランモード、よく使うスラッシュコマンド、会話の文脈の扱い、サブエージェントまでを、僕の使い方を交えて説明します。最後に、秘密情報と取り返しのつかない操作についての注意点をまとめます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>この記事の前提（2026年11月18日に確認）</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>macOS 27.2、Claude Code 2.1.327</li>

<li>機能・コマンド・オプションは、公式ドキュメント（<a href="https://code.claude.com/docs/en/overview" target="_blank" rel="noopener">code.claude.com/docs</a>）で確認日に確かめたものです</li>

<li>Claude Code は更新が速く、名前や既定の動きがよく変わります。手元の版と違うときは、公式ドキュメントと <code>/help</code> の表示を優先してください</li>
</ul>
</div></div>



<h2 class="wp-block-heading">Claude Code とは</h2>



<h3 class="wp-block-heading">ターミナルで AI に作業を任せるツール</h3>



<p class="wp-block-paragraph">ブラウザのチャットと違い、Claude Code は<strong>自分のパソコンのプロジェクトのフォルダの中で</strong>動きます。頼んだことに合わせて、自分でファイルを探して読み、編集し、テストなどのコマンドを実行します。ファイルの編集やコマンドの実行の前には、許可を求める画面が出ます（あとで説明する権限の設定で変えられます）。</p>



<p class="wp-block-paragraph">ターミナルのほかに、VS Code の拡張機能（<code>anthropic.claude-code</code>、VS Code 1.94.0 以上）や JetBrains のプラグインからも使えます。ターミナルで起動した Claude Code を IDE とつなぐときは <code>/ide</code> を使います。VS Code の準備は<a href="https://cfxlog.com/mac-vscode-setup/">Mac に VS Code を入れて設定する記事</a>にまとめています。</p>



<h3 class="wp-block-heading">使うのに必要なもの</h3>



<p class="wp-block-paragraph">使うには、次のどれかのアカウントが必要です。<strong>無料プランは対象外</strong>と公式ドキュメントに書かれています。</p>



<ul class="wp-block-list">
<li>Claude の有料プラン（Pro・Max・Ultra・Team・Enterprise）</li>

<li>Claude Console（API の従量課金）</li>

<li>Amazon Bedrock・Google Cloud・Microsoft Foundry などのクラウド経由</li>
</ul>



<p class="wp-block-paragraph">料金はプランや使い方で変わり、改定もあるので、この記事には金額を書きません。最新の金額は公式の<a href="https://claude.com/pricing" target="_blank" rel="noopener">料金ページ（claude.com/pricing）</a>で確かめてください。</p>



<h2 class="wp-block-heading">Claude Code をインストールする</h2>



<h3 class="wp-block-heading">Mac・Linux はインストーラーで入れる</h3>



<p class="wp-block-paragraph">公式が勧めているのは、ネイティブ版のインストーラーです。Node.js は要りません。対応するのは macOS 13 以上、Ubuntu 20.04 以上、Windows 10（1809）以上です。Mac と Linux（WSL を含む）では、ターミナルで次を実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>curl -fsSL https://claude.ai/install.sh | bash</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-fsSL</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://claude.ai/install.sh</span><span style="color: #D4D4D4"> | </span><span style="color: #DCDCAA">bash</span></span></code></pre></div>



<p class="wp-block-paragraph">ターミナルの基本的な使い方は<a href="https://cfxlog.com/mac-terminal-complete-guide/">Mac のターミナルの使い方の記事</a>で紹介しています。</p>



<h3 class="wp-block-heading">Homebrew・Windows で入れる</h3>



<p class="wp-block-paragraph">Homebrew を使っているなら、cask でも入れられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew install --cask claude-code</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--cask</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">claude-code</span></span></code></pre></div>



<p class="wp-block-paragraph">Windows の PowerShell では、次のどちらかです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">irm</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://claude.ai/install.ps1</span><span style="color: #D4D4D4"> | </span><span style="color: #DCDCAA">iex</span></span>
<span class="line"><span style="color: #DCDCAA">winget</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Anthropic.ClaudeCode</span></span></code></pre></div>



<p class="wp-block-paragraph">npm でも入れられますが、Node.js 22 以上が要り、<code>sudo</code> は使わないよう案内されています。</p>



<h3 class="wp-block-heading">更新と調子が悪いときの診断</h3>



<p class="wp-block-paragraph">ネイティブ版は自動で更新されます。手動で更新するときと、入れ方や設定に問題がないか診断するときは、次のコマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>claude --version
claude update
claude doctor</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">claude</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span>
<span class="line"><span style="color: #DCDCAA">claude</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">update</span></span>
<span class="line"><span style="color: #DCDCAA">claude</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">doctor</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>Homebrew・winget で入れた場合</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">Homebrew と winget で入れたものは、既定では自動で更新されません。<code>brew upgrade</code> などで、ときどき自分で更新してください。</p>
</div></div>



<h2 class="wp-block-heading">最初の起動とログイン</h2>



<h3 class="wp-block-heading">プロジェクトのフォルダで claude を起動する</h3>



<p class="wp-block-paragraph">Claude Code は、<strong>起動したフォルダを作業の範囲</strong>として扱います。作業したいプロジェクトのフォルダへ移動してから起動します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cd /path/to/myapp
claude</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">cd</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/myapp</span></span>
<span class="line"><span style="color: #DCDCAA">claude</span></span></code></pre></div>



<p class="wp-block-paragraph">初めて起動したときは、ブラウザが開いてログインの画面になります。使うアカウントでログインして許可すれば、ターミナルに戻って会話を始められます。</p>



<h3 class="wp-block-heading">ログインし直す・アカウントを切り替える</h3>



<p class="wp-block-paragraph">あとからアカウントを切り替えるときは、Claude Code の中で <code>/login</code>・<code>/logout</code> を使います。シェルから直接ログインするなら <code>claude auth login</code> です。</p>



<h3 class="wp-block-heading">前の会話を続ける</h3>



<p class="wp-block-paragraph">Claude Code を閉じても、会話は残っています。同じフォルダで次のように起動すると、前の会話の続きから始められます。</p>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>やること</th></tr></thead><tbody><tr><td><code>claude -c</code></td><td>直前の会話を続ける</td></tr><tr><td><code>claude -r</code></td><td>一覧から会話を選んで続ける</td></tr><tr><td><code>/resume</code></td><td>起動したあとで、会話を選んで続ける</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">作業を途中で止めて、次の日に同じ話の続きをしたいときに便利です。</p>



<h2 class="wp-block-heading">CLAUDE.md でプロジェクトのルールを書く</h2>



<p class="wp-block-paragraph"><code>CLAUDE.md</code> は、Claude Code が起動するたびに読む説明書です。テストのコマンドや、守ってほしいルールを書いておくと、毎回説明しなくて済みます。</p>



<h3 class="wp-block-heading">置き場所と読み込まれる順番</h3>



<figure class="wp-block-table"><table><thead><tr><th>置き場所</th><th>効く範囲</th><th>使いどころ</th></tr></thead><tbody><tr><td><code>~/.claude/CLAUDE.md</code></td><td>自分のすべてのプロジェクト</td><td>返答の言語など、自分の好み</td></tr><tr><td><code>./CLAUDE.md</code> か <code>./.claude/CLAUDE.md</code></td><td>そのプロジェクト</td><td>テストのコマンド、プロジェクトのルール。Git に入れてチームで共有する</td></tr><tr><td><code>./CLAUDE.local.md</code></td><td>そのプロジェクトの自分だけ</td><td>自分だけのメモ。<code>.gitignore</code> に入れる</td></tr><tr><td><code>.claude/rules/*.md</code></td><td>そのプロジェクト</td><td>ルールをテーマごとのファイルに分ける</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">起動したフォルダから上の階層へさかのぼって、見つかった <code>CLAUDE.md</code> をすべて読みます。サブフォルダにある <code>CLAUDE.md</code> は、そのフォルダの中のファイルを扱うときに読まれます。</p>



<p class="wp-block-paragraph">僕は、全部のプロジェクトをまとめた親のフォルダに共通の <code>CLAUDE.md</code> を置き、プロジェクトの一覧と共通の技術（Python は uv、コンテナは Docker Compose など）を書いています。各プロジェクトのフォルダには、そのプロジェクトだけのルールを書いた <code>CLAUDE.md</code> を置いています。どのプロジェクトで起動しても、共通のルールと個別のルールの両方が読まれます。</p>



<h3 class="wp-block-heading">/init で雛形を作る</h3>



<p class="wp-block-paragraph">最初の <code>CLAUDE.md</code> は、Claude Code に作ってもらうのが早いです。プロジェクトのフォルダで起動して、次のように入力します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Claude Code の入力欄</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/init</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">/init</span></span></code></pre></div>



<p class="wp-block-paragraph">Claude Code がファイルの構成やテストのコマンドを調べて、<code>CLAUDE.md</code> の雛形を書きます。すでに <code>CLAUDE.md</code> があるときは、直したほうがよい点を提案してくれます。あとから手で直したいときは <code>/memory</code> で開けます。</p>



<h3 class="wp-block-heading">書いておくとよいこと（僕の CLAUDE.md の例）</h3>



<p class="wp-block-paragraph">僕がプロジェクトの <code>CLAUDE.md</code> に書いている内容をもとに、架空のプロジェクト（myapp）向けに書いた例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Markdown</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># myapp

Django の API と Next.js の画面からなる Web アプリ。

## コマンド

- テスト：`uv run pytest`
- lint：`uv run ruff check .`
- 開発サーバー：`docker compose up -d`

## ルール

- 返答は日本語で書く
- `.env` に秘密情報を置く。値をコードやコミットメッセージに書かない
- `compose.yaml` の `ports:` は `127.0.0.1:` に限る
- `git push`・本番への反映・データの削除などは、承認を得てから行う

## 詳しい手順

- デプロイ手順：@docs/deploy.md</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6; font-weight: bold"># myapp</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">Django の API と Next.js の画面からなる Web アプリ。</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6; font-weight: bold">## コマンド</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> テスト：</span><span style="color: #CE9178">`uv run pytest`</span></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> lint：</span><span style="color: #CE9178">`uv run ruff check .`</span></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> 開発サーバー：</span><span style="color: #CE9178">`docker compose up -d`</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6; font-weight: bold">## ルール</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> 返答は日本語で書く</span></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">`.env`</span><span style="color: #D4D4D4"> に秘密情報を置く。値をコードやコミットメッセージに書かない</span></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">`compose.yaml`</span><span style="color: #D4D4D4"> の </span><span style="color: #CE9178">`ports:`</span><span style="color: #D4D4D4"> は </span><span style="color: #CE9178">`127.0.0.1:`</span><span style="color: #D4D4D4"> に限る</span></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">`git push`</span><span style="color: #D4D4D4">・本番への反映・データの削除などは、承認を得てから行う</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6; font-weight: bold">## 詳しい手順</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6796E6">-</span><span style="color: #D4D4D4"> デプロイ手順：@docs/deploy.md</span></span></code></pre></div>



<p class="wp-block-paragraph">書いているのは、大きく分けて次の3つです。</p>



<ol class="wp-block-list is-style-num_circle">
<li><strong>コマンド</strong>：テスト・lint・起動の方法。書いておくと、変更のあとに自分でテストを走らせてくれます</li>



<li><strong>やってはいけないこと</strong>：秘密情報をコードに書かない、ポートを外に開けない、など。最初から全部を書こうとせず、困ったことがあったらそのたびに1行ずつ足して育てていくとよいです</li>



<li><strong>確認してほしいタイミング</strong>：push や本番への反映、データの削除のように、やり直しにくい操作の前</li>
</ol>



<p class="wp-block-paragraph">ほかに、親のフォルダの共通の <code>CLAUDE.md</code> には「画面を変えたら、狭いスマホの幅と PC の幅の両方で確かめる」「データの出典を確かめ、推測で埋めない」のような、作業の進め方も書いています。</p>



<h3 class="wp-block-heading">短く、具体的に書く</h3>



<p class="wp-block-paragraph"><code>CLAUDE.md</code> は毎回の会話で読み込まれ、そのぶん会話に使える量（文脈）を使います。公式ドキュメントでは、<strong>1ファイル200行以内</strong>を目安にしています。</p>



<ul class="wp-block-list">
<li>「きれいなコードを書く」のようなあいまいな書き方より、「関数名は snake_case」のように確かめられる書き方にする</li>

<li>長い手順書は別のファイルにして、<code>@docs/deploy.md</code> のように <code>@</code> で取り込む（入れ子は4段まで）</li>

<li>守られなかったルールは、書き方を具体的にするか、次に説明する権限の設定で止める</li>
</ul>



<h2 class="wp-block-heading">権限の確認と許可のルール</h2>



<p class="wp-block-paragraph">Claude Code は、ファイルの編集やコマンドの実行の前に許可を求めます。どこまで自動で進めてよいかは、<strong>権限モード</strong>と<strong>許可のルール</strong>で決めます。</p>



<h3 class="wp-block-heading">権限モードの種類</h3>



<figure class="wp-block-table"><table><thead><tr><th>モード</th><th>動き</th></tr></thead><tbody><tr><td><code>default</code>（画面の表示は Manual）</td><td>編集やコマンドの前に毎回確かめる</td></tr><tr><td><code>acceptEdits</code></td><td>ファイルの編集は確かめずに進める</td></tr><tr><td><code>plan</code></td><td>調べて計画を立てるだけで、ファイルは編集しない（次の章）</td></tr><tr><td><code>auto</code></td><td>安全かどうかを判断しながら、確認を減らして進める</td></tr><tr><td><code>dontAsk</code></td><td>許可のルールで許したものだけ実行し、それ以外は確かめずに断る</td></tr><tr><td><code>bypassPermissions</code></td><td>確認をすべて飛ばす。<code>--dangerously-skip-permissions</code> と同じ</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">公式ドキュメントによると、v2.1.283 以降は、対話で起動したセッションは <code>auto</code> モードで始まります（<code>auto</code> に対応していないモデルもあります）。<code>claude -p</code> で一度だけ実行するときは <code>default</code> で始まります。</p>



<h3 class="wp-block-heading">Shift+Tab でモードを切り替える</h3>



<p class="wp-block-paragraph">会話の途中では、<strong>Shift+Tab</strong> を押すたびにモードが切り替わります。起動するときに決めておくなら、<code>--permission-mode</code> を付けます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>claude --permission-mode plan</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">claude</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--permission-mode</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">plan</span></span></code></pre></div>



<h3 class="wp-block-heading">settings.json に許可のルールを書く</h3>



<p class="wp-block-paragraph">毎回同じコマンドを許可しているなら、プロジェクトの <code>.claude/settings.json</code> にルールを書いておけます。たとえば次のように書けます。ルールは <code>allow</code>（確かめずに許可）・<code>ask</code>（毎回確かめる）・<code>deny</code>（禁止）の3種類です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JSON</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
  "permissions": {
    "allow": [
      "Bash(uv run pytest *)",
      "Bash(uv run ruff check *)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "ask": [
      "Bash(git commit *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;permissions&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;allow&quot;</span><span style="color: #D4D4D4">: [</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(uv run pytest *)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(uv run ruff check *)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(git status)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(git diff *)&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    ],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;ask&quot;</span><span style="color: #D4D4D4">: [</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(git commit *)&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    ],</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;deny&quot;</span><span style="color: #D4D4D4">: [</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(git push *)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Bash(rm -rf *)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Read(./.env)&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&quot;Read(./.env.*)&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    ]</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">この例では、テスト・lint・<code>git status</code>・<code>git diff</code> は確かめずに実行し、コミットは毎回確かめ、<code>git push</code> と <code>rm -rf</code>、<code>.env</code> の読み取りは禁止しています。</p>



<ul class="wp-block-list">
<li><code>Bash(uv run pytest *)</code> の <code>*</code> は、後ろに続く引数を表します。<code>*</code> の前の空白は必要で、<code>Bash(ls *)</code> は <code>lsof</code> には当たりません。末尾の「空白＋<code>*</code>」は引数のないコマンドにも当たるので、<code>Bash(git push *)</code> は引数のない <code>git push</code> も止めます</li>

<li><code>Bash(git push *)</code> は <code>git -C . push</code> のような別の書き方までは止めません（公式ドキュメントにもこの例があります）。確認の画面を読む習慣は残しておきます</li>

<li><code>Read(./.env)</code> のようにファイルの場所でも書けます（書き方は .gitignore と同じ）</li>

<li>ルールは <code>deny</code> → <code>ask</code> → <code>allow</code> の順に見て、最初に当たったものが効きます。<code>allow</code> に入れても、<code>deny</code> に当たれば禁止です</li>
</ul>



<p class="wp-block-paragraph">設定のファイルは何か所かにあり、強い順に「管理者の設定 ＞ コマンドラインの指定 ＞ <code>.claude/settings.local.json</code>（自分だけ） ＞ <code>.claude/settings.json</code>（プロジェクト） ＞ <code>~/.claude/settings.json</code>（自分の全プロジェクト）」です。<code>allow</code> などのリストは上書きではなく足し合わされます。</p>



<h3 class="wp-block-heading">/permissions でルールを見直す</h3>



<p class="wp-block-paragraph">いま効いているルールの一覧は <code>/permissions</code> で見られ、足したり消したりもできます。公式ドキュメントも、ルールを定期的に見直すよう勧めています。広すぎる許可がないかを、ときどき確かめるとよいです。</p>



<h2 class="wp-block-heading">プランモードで先に計画を立てる</h2>



<p class="wp-block-paragraph">大きめの変更を頼むときは、いきなりコードを書かせずに、<strong>プランモード</strong>で計画を出してもらうと安心です。プランモードの間、Claude Code は調べて計画を書くだけで、承認するまでソースを編集しません。</p>



<h3 class="wp-block-heading">プランモードに入る3つの方法</h3>



<ul class="wp-block-list">
<li>会話の途中で <strong>Shift+Tab</strong> を押して、プランモードになるまで切り替える（公式ドキュメントでは、プランモードの間は <code>plan mode on</code> という表示が出ると説明されています）</li>

<li><code>/plan</code> のあとに頼みたいことを書く（例：<code>/plan ログイン画面にパスワードの再設定を足したい</code>）</li>

<li>起動するときに <code>claude --permission-mode plan</code></li>
</ul>



<h3 class="wp-block-heading">計画を確かめて承認する</h3>



<p class="wp-block-paragraph">計画ができると、承認するかどうかの画面になります。内容でよければ承認し、直したい点があれば、そのまま追加の指示を書きます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：計画の画面で Shift+Tab を押すと承認になる</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">承認の画面で Shift+Tab を押すと、その計画を承認したことになります。承認せずにプランモードから抜けたいときは、先に <strong>Esc</strong> を押してください。</p>
</div></div>



<p class="wp-block-paragraph">データベースの変更や、複数のファイルにまたがる変更のように、やり直しにくい作業に向いています。コードを書き始める前の計画の段階なら、「その方法だと既存のデータが消える」といった食い違いを、直すのが簡単なうちに見つけられます。</p>



<h2 class="wp-block-heading">よく使うスラッシュコマンド</h2>



<h3 class="wp-block-heading">覚えておくと便利なコマンド</h3>



<p class="wp-block-paragraph">Claude Code の入力欄で <code>/</code> から始まるコマンドを入力すると、組み込みの機能を呼び出せます。使えるコマンドは <code>/help</code> で確かめられます。</p>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>やること</th></tr></thead><tbody><tr><td><code>/help</code></td><td>使い方とコマンドの一覧を出す</td></tr><tr><td><code>/init</code></td><td><code>CLAUDE.md</code> の雛形を作る</td></tr><tr><td><code>/memory</code></td><td><code>CLAUDE.md</code> を開いて編集する</td></tr><tr><td><code>/permissions</code></td><td>許可のルール（allow・ask・deny）を見る・変える</td></tr><tr><td><code>/model</code></td><td>使うモデルを切り替える</td></tr><tr><td><code>/context</code></td><td>文脈（コンテキスト）の使用量を見る</td></tr><tr><td><code>/compact</code></td><td>ここまでの会話を要約して、文脈を空ける</td></tr><tr><td><code>/clear</code></td><td>文脈を空にして新しい会話を始める</td></tr><tr><td><code>/resume</code></td><td>前の会話を選んで続ける</td></tr><tr><td><code>/rewind</code></td><td>会話やコードを前の時点に戻す</td></tr><tr><td><code>/usage</code></td><td>使った量とプランの上限を見る</td></tr><tr><td><code>/config</code></td><td>設定の画面を開く</td></tr><tr><td><code>/exit</code></td><td>終了する</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">名前が変わったコマンドに注意</h3>



<p class="wp-block-paragraph">古い記事に出てくるコマンドの中には、名前が変わったものがあります。たとえば <code>/cost</code> は <code>/usage</code>、<code>/review</code> は <code>/code-review</code> の別名になりました。自分で作るコマンドも、いまは <code>.claude/skills/&lt;名前&gt;/SKILL.md</code> に書く「スキル」が勧められています（<code>.claude/commands/</code> も引き続き動きます）。</p>



<h2 class="wp-block-heading">会話の文脈（コンテキスト）を管理する</h2>



<p class="wp-block-paragraph">Claude Code が一度に覚えておける会話の量（文脈）には上限があります。長く作業を続けると、最初のほうの指示を忘れたり、動きが遅くなったりします。</p>



<h3 class="wp-block-heading">/context で使用量を見る</h3>



<p class="wp-block-paragraph"><code>/context</code> を実行すると、いまの文脈の使用量が表示されます（公式の説明では、色分けした図で表示されます）。<code>CLAUDE.md</code> や読み込んだファイル、会話がどれだけ使っているかが分かります。</p>



<h3 class="wp-block-heading">/compact で会話を要約する</h3>



<p class="wp-block-paragraph"><code>/compact</code> は、ここまでの会話を要約して文脈を空けるコマンドです。後ろに、要約で残してほしいことを書けます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Claude Code の入力欄</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/compact 決まった設計と、まだ直していないテストの一覧を残して</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">/compact 決まった設計と、まだ直していないテストの一覧を残して</span></span></code></pre></div>



<p class="wp-block-paragraph">上限に近づくと、Claude Code は自動でも要約します（自動で要約するタイミングは <code>/autocompact</code> で変えられます）。区切りのよいところで自分から <code>/compact</code> すれば、上の例のように、要約で残してほしいことを指示できます。</p>



<h3 class="wp-block-heading">/clear で話題を切り替える・/rewind で戻る</h3>



<p class="wp-block-paragraph">前の作業と関係のない作業を始めるときは、<code>/compact</code> より <code>/clear</code> で文脈を空にしたほうが、前の話に引きずられません。</p>



<p class="wp-block-paragraph">Claude Code の変更が思っていたものと違ったときは、<code>/rewind</code> で会話とコードを前の時点に戻せます。入力欄が空のときに <strong>Esc を2回</strong>押しても、同じ巻き戻しのメニューが開きます。</p>



<h2 class="wp-block-heading">サブエージェントに作業を分ける</h2>



<p class="wp-block-paragraph">サブエージェントは、メインの会話とは別の文脈で動く、専門の担当です。調べものやレビューのように、途中の経過は要らず結果だけほしい作業を任せると、メインの会話の文脈を使わずに済みます。</p>



<h3 class="wp-block-heading">組み込みのサブエージェント</h3>



<p class="wp-block-paragraph">最初から、ファイルを探して調べる <code>Explore</code>、計画を立てる <code>Plan</code>、何でも頼める <code>general-purpose</code> が入っています。「このリポジトリで、ログインの処理がどこにあるか調べて」のように頼むと、Claude Code が必要に応じて使います。</p>



<h3 class="wp-block-heading">自分でサブエージェントを作る</h3>



<p class="wp-block-paragraph">サブエージェントは、プロジェクトの <code>.claude/agents/</code>（自分の全プロジェクトなら <code>~/.claude/agents/</code>）に Markdown のファイルで置きます。コードレビューの担当の例です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Markdown</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>---
name: code-reviewer
description: 変更したコードを読み、バグ・セキュリティ・読みやすさの問題を指摘する。コードを書き換えたあとに使う。
tools: Read, Grep, Glob, Bash
model: inherit
---

あなたはコードレビューの担当です。git diff で変更を確かめ、次の順に指摘してください。

1. 動かなくなる・データが壊れるおそれ
2. 秘密情報の書き込み、権限の広げすぎ
3. 読みにくい名前や重複

指摘には、ファイル名と行、理由、直し方を書いてください。コードは書き換えないでください。</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">---</span></span>
<span class="line"><span style="color: #569CD6">name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">code-reviewer</span></span>
<span class="line"><span style="color: #569CD6">description</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">変更したコードを読み、バグ・セキュリティ・読みやすさの問題を指摘する。コードを書き換えたあとに使う。</span></span>
<span class="line"><span style="color: #569CD6">tools</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">Read, Grep, Glob, Bash</span></span>
<span class="line"><span style="color: #569CD6">model</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">inherit</span></span>
<span class="line"><span style="color: #D4D4D4">---</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">あなたはコードレビューの担当です。git diff で変更を確かめ、次の順に指摘してください。</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6796E6">1.</span><span style="color: #D4D4D4"> 動かなくなる・データが壊れるおそれ</span></span>
<span class="line"><span style="color: #6796E6">2.</span><span style="color: #D4D4D4"> 秘密情報の書き込み、権限の広げすぎ</span></span>
<span class="line"><span style="color: #6796E6">3.</span><span style="color: #D4D4D4"> 読みにくい名前や重複</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">指摘には、ファイル名と行、理由、直し方を書いてください。コードは書き換えないでください。</span></span></code></pre></div>



<p class="wp-block-paragraph">先頭の <code>---</code> で囲んだ部分のうち、必須なのは <code>name</code> と <code>description</code> だけです。<code>tools</code> を省くと、メインと同じツールをすべて使えます。レビューの担当のように書き換えてほしくないものは、使えるツールを絞っておきます。</p>



<h3 class="wp-block-heading">サブエージェントを呼び出す</h3>



<p class="wp-block-paragraph">Claude Code は <code>description</code> を見て、どのサブエージェントに任せるかを決めます。確実に使ってほしいときは、名前を出して頼みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Claude Code の入力欄</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>code-reviewer のサブエージェントで、いまの変更をレビューして</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">code-reviewer のサブエージェントで、いまの変更をレビューして</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>description</code> に「コードを書き換えたあとに使う」のように使う場面を書いておくと、頼まなくても使ってくれることが増えます。</p>



<h2 class="wp-block-heading">使うときの注意点</h2>



<h3 class="wp-block-heading">秘密情報を読ませない</h3>



<p class="wp-block-paragraph">Claude Code は、頼まれた作業のためにプロジェクトの中のファイルを読みます。<code>.env</code> のような秘密情報のファイルも、止めなければ読めてしまいます。読ませたくないファイルは、<code>settings.json</code> の <code>deny</code> に <code>Read(./.env)</code> のように書いておきます。</p>



<ul class="wp-block-list">
<li>以前の <code>.claudeignore</code> は効きません。<code>Read</code> の <code>deny</code> ルールを使います</li>

<li>コマンドの実行をサンドボックスで囲む機能（<code>/sandbox</code>）もあります。既定ではオフで、オンにしても <code>~/.ssh</code> などはそのままだと読めるので、<code>deny</code> で塞ぐ必要があります</li>

<li>パスワードや API キーを会話に貼らない。<code>CLAUDE.md</code> にも値は書かず、「<code>.env</code> に置く」とだけ書く</li>
</ul>



<h3 class="wp-block-heading">取り返しのつかない操作は必ず確かめる</h3>



<p class="wp-block-paragraph"><code>git push</code>、<code>rm -rf</code>、データベースの削除、本番へのデプロイのように、やり直しにくい操作は、確認の画面を必ず読んでから許可します。</p>



<ul class="wp-block-list">
<li>許可する前に、実行されるコマンドの全文を読む。<code>&amp;&amp;</code> でつながった長いコマンドは、後ろのほうまで読む</li>

<li>やり直しにくい操作は <code>deny</code> か <code>ask</code> に入れ、<code>CLAUDE.md</code> にも「承認を得てから行う」と書いておく</li>

<li><code>bypassPermissions</code>（<code>--dangerously-skip-permissions</code>）は、壊れても困らない使い捨ての環境だけで使う</li>

<li>大きな作業の前にコミットしておくと、思っていたのと違う変更になっても Git で戻せる</li>
</ul>



<p class="wp-block-paragraph">僕の <code>CLAUDE.md</code> にも「push・本番への反映・データの削除などは、承認を得てから行う」と書いています。ただ、<code>CLAUDE.md</code> はあくまでお願いなので、<strong>必ず止めたいものは権限のルールで止める</strong>のが確実です。公式ドキュメントも、確実に止めたいことは権限のルールで設定するよう勧めています。Git の取り消しの基本は<a href="https://cfxlog.com/git-basics-cui/">Git の基本コマンドの記事</a>も参考にしてください。</p>



<h3 class="wp-block-heading">信頼できない内容をそのまま渡さない</h3>



<p class="wp-block-paragraph">Web ページや他人が書いたファイルの中に、AI への指示のような文が紛れ込んでいることがあります。知らないリポジトリや Web の内容を読ませるときは、勝手にコマンドを実行させないよう、確認の画面を残したまま使います。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Claude Code を使い始めるときに押さえておきたいことをまとめます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>インストールは <code>curl -fsSL https://claude.ai/install.sh | bash</code>。プロジェクトのフォルダで <code>claude</code> を起動し、ブラウザでログインする</li>

<li><code>CLAUDE.md</code> には、コマンド・やってはいけないこと・確認してほしいタイミングを短く書く。最初は <code>/init</code> で作る</li>

<li>よく使うコマンドは <code>settings.json</code> の <code>allow</code> に、やり直しにくい操作は <code>deny</code> に書く</li>

<li>大きな変更はプランモードで計画を確かめてから進める</li>

<li>長い作業は <code>/context</code> で使用量を見て、<code>/compact</code> や <code>/clear</code> で整理する</li>

<li>秘密情報は <code>Read</code> の <code>deny</code> で読ませず、確認の画面は全文を読んでから許可する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Claude Code は、ルールを書けば書いただけ、自分のやり方に沿って動いてくれるようになります。まずは1つのプロジェクトで <code>/init</code> を実行して、<code>CLAUDE.md</code> を育てるところから始めてみてください。</p>

]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Docker Composeの使い方｜compose.yamlの書き方とコマンド</title>
		<link>https://cfxlog.com/docker-compose-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 07 Nov 2026 01:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[Docker]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/docker-compose-guide/</guid>

					<description><![CDATA[僕は、Django・Next.js・PostgreSQL で作った Web アプリも、WordPress と MariaDB も、その前に置く nginx のリバースプロキシも、すべて Docker Compose で動 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>docker run</code> のオプションが長くなって、毎回打つのがつらい</li>

<li>Web アプリと DB をまとめて起動・停止したい</li>

<li><code>compose.yaml</code> の <code>depends_on</code> や <code>ports</code> の書き方がよく分からない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">僕は、Django・Next.js・PostgreSQL で作った Web アプリも、WordPress と MariaDB も、その前に置く nginx のリバースプロキシも、すべて Docker Compose で動かしています。コンテナが何個あっても、<code>docker compose up -d</code> の1行で起動できるからです。</p>



<p class="wp-block-paragraph">この記事では、<strong>compose.yaml の書き方と、よく使う docker compose コマンド</strong>をまとめます。あわせて、僕の環境で使っている <code>depends_on</code> と <code>healthcheck</code>、<code>.env</code>、ポートを <code>127.0.0.1</code> に限る理由、<code>restart</code> と <code>mem_limit</code> の決め方も紹介します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>この記事で確認した環境（2026年11月18日）</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>macOS 27.2（Docker Desktop）</li>

<li>Docker Engine 28.2.2、Docker Compose v2.36.2</li>

<li>イメージ：python:3.12-alpine、postgres:16-alpine、nginx:1.30-alpine</li>
</ul>
</div></div>



<h2 class="wp-block-heading">Docker Compose とは</h2>



<h3 class="wp-block-heading">docker run を1つのファイルにまとめる</h3>



<p class="wp-block-paragraph">Docker Compose は、複数のコンテナの設定を <code>compose.yaml</code> という1つのファイルに書いておき、まとめて起動・停止するツールです。<code>docker run</code> では、コンテナごとに次のような長いコマンドを打つ必要があります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker network create myapp_default
docker run -d --name db --network myapp_default \
  -e POSTGRES_PASSWORD=change-me -v db_data:/var/lib/postgresql/data postgres:16-alpine
docker run -d --name nginx --network myapp_default -p 127.0.0.1:8080:80 nginx:1.30-alpine</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">network</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">create</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp_default</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">db</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--network</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp_default</span><span style="color: #D4D4D4"> </span><span style="color: #D7BA7D">\</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">-e</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">POSTGRES_PASSWORD=change-me</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-v</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">db_data:/var/lib/postgresql/data</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">postgres:16-alpine</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--network</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp_default</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-p</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">127.0</span><span style="color: #CE9178">.0.1:8080:80</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx:1.30-alpine</span></span></code></pre></div>



<p class="wp-block-paragraph">Compose なら、これらをファイルに書いておき、<code>docker compose up -d</code> だけで起動できます。ネットワークも自動で作られ、コンテナどうしはサービス名（<code>db</code> など）で通信できます。<code>docker</code> コマンドそのものの使い方は<a href="https://cfxlog.com/linux-docker-command-mapping/">Linux コマンドと Docker コマンドの対応の記事</a>で紹介しています。</p>



<h3 class="wp-block-heading">docker compose と docker-compose の違い</h3>



<p class="wp-block-paragraph">いまの Compose は <code>docker</code> コマンドのプラグイン（Compose V2）で、<code>docker compose</code>（間にスペース）と書きます。古い記事に出てくる <code>docker-compose</code>（ハイフン）は以前の版のコマンドです。バージョンは次のコマンドで確かめられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Docker Compose version v2.36.2-desktop.1</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Docker Compose version v2.36.2-desktop.1</span></span></code></pre></div>



<p class="wp-block-paragraph">ファイル名も、いまは <code>compose.yaml</code> が標準です。<code>docker-compose.yml</code> も引き続き読み込まれます。</p>



<h2 class="wp-block-heading">compose.yaml の書き方</h2>



<h3 class="wp-block-heading">例にする構成</h3>



<p class="wp-block-paragraph">この記事では、次の3つのサービスを動かす <code>myapp</code> を例にします。僕が運用している Web アプリの形を、小さくしたものです。</p>



<figure class="wp-block-table"><table><thead><tr><th>サービス</th><th>イメージ</th><th>役割</th></tr></thead><tbody><tr><td><code>web</code></td><td>自分で build（Python）</td><td>アプリ本体。8000番で待ち受ける</td></tr><tr><td><code>db</code></td><td><code>postgres:16-alpine</code></td><td>データベース</td></tr><tr><td><code>nginx</code></td><td><code>nginx:1.30-alpine</code></td><td>リバースプロキシ。外から受けるのはここだけ</td></tr></tbody></table></figure>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>myapp/
├── compose.yaml
├── .env
├── nginx/
│   └── default.conf
└── web/
    ├── Dockerfile
    └── app.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">myapp/</span></span>
<span class="line"><span style="color: #D4D4D4">├── compose.yaml</span></span>
<span class="line"><span style="color: #D4D4D4">├── .env</span></span>
<span class="line"><span style="color: #D4D4D4">├── nginx/</span></span>
<span class="line"><span style="color: #D4D4D4">│   └── default.conf</span></span>
<span class="line"><span style="color: #D4D4D4">└── web/</span></span>
<span class="line"><span style="color: #D4D4D4">    ├── Dockerfile</span></span>
<span class="line"><span style="color: #D4D4D4">    └── app.py</span></span></code></pre></div>



<h3 class="wp-block-heading">compose.yaml の全体</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>name: myapp

services:
  web:
    build: ./web
    image: myapp-web:local
    environment:
      APP_MESSAGE: ${APP_MESSAGE:-hello from web}
      DB_HOST: db
      DB_NAME: ${DB_NAME:?Set DB_NAME in .env}
      DB_USER: ${DB_USER:?Set DB_USER in .env}
      DB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('https://cfxlog.com/health', timeout=3).close()"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 10s
    mem_limit: 256m
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: ${DB_NAME:?Set DB_NAME in .env}
      POSTGRES_USER: ${DB_USER:?Set DB_USER in .env}
      POSTGRES_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U \"$$POSTGRES_USER\" -d \"$$POSTGRES_DB\""]
      interval: 5s
      timeout: 5s
      retries: 5
    mem_limit: 256m
    restart: unless-stopped

  nginx:
    image: nginx:1.30-alpine
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      web:
        condition: service_healthy
    mem_limit: 64m
    restart: unless-stopped

volumes:
  db_data:</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">myapp</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">web</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">build</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">./web</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">myapp-web:local</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">APP_MESSAGE</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${APP_MESSAGE:-hello from web}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">DB_HOST</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">db</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">DB_NAME</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_NAME:?Set DB_NAME in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">DB_USER</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_USER:?Set DB_USER in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">DB_PASSWORD</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_PASSWORD:?Set DB_PASSWORD in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">depends_on</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">condition</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">service_healthy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">healthcheck</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">test</span><span style="color: #D4D4D4">: [</span><span style="color: #CE9178">&quot;CMD&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;python&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;-c&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;import urllib.request; urllib.request.urlopen(&apos;https://cfxlog.com/health#39;, timeout=3).close()&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">interval</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">10s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">timeout</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">retries</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">3</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">start_period</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">10s</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">256m</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">unless-stopped</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">postgres:16-alpine</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">POSTGRES_DB</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_NAME:?Set DB_NAME in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">POSTGRES_USER</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_USER:?Set DB_USER in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">POSTGRES_PASSWORD</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_PASSWORD:?Set DB_PASSWORD in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">db_data:/var/lib/postgresql/data</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">healthcheck</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">test</span><span style="color: #D4D4D4">: [</span><span style="color: #CE9178">&quot;CMD-SHELL&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;pg_isready -U </span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">$$POSTGRES_USER</span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178"> -d </span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">$$POSTGRES_DB</span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">interval</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">timeout</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">retries</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">5</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">256m</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">unless-stopped</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">nginx</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">nginx:1.30-alpine</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">&quot;127.0.0.1:8080:80&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">depends_on</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">web</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">condition</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">service_healthy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">64m</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">unless-stopped</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db_data</span><span style="color: #D4D4D4">:</span></span></code></pre></div>



<p class="wp-block-paragraph">長く見えますが、<code>services:</code> の下にサービスごとの設定を並べ、最後に <code>volumes:</code> でデータの置き場所を宣言しているだけです。</p>



<h3 class="wp-block-heading">よく使う項目</h3>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>意味</th></tr></thead><tbody><tr><td><code>name</code></td><td>プロジェクト名。コンテナ・ネットワーク・ボリュームの名前の先頭に付く</td></tr><tr><td><code>image</code></td><td>使うイメージ。<code>build</code> と一緒に書くと、build したイメージにこの名前が付く</td></tr><tr><td><code>build</code></td><td>Dockerfile のあるフォルダ。ここからイメージを作る</td></tr><tr><td><code>environment</code></td><td>コンテナに渡す環境変数</td></tr><tr><td><code>ports</code></td><td>ホストに公開するポート（<code>ホスト側:コンテナ側</code>）</td></tr><tr><td><code>volumes</code></td><td>データの保存先やファイルのマウント</td></tr><tr><td><code>depends_on</code></td><td>先に起動しておくサービス</td></tr><tr><td><code>healthcheck</code></td><td>コンテナが正常に動いているかを確かめるコマンド</td></tr><tr><td><code>restart</code></td><td>コンテナが止まったときに自動で起動し直すか</td></tr><tr><td><code>mem_limit</code></td><td>使えるメモリの上限</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">web の Dockerfile と nginx の設定</h3>



<p class="wp-block-paragraph"><code>web</code> は、確認用の小さな Python のアプリです。実際の Django アプリなら、ここが Gunicorn で動く Django になります（Gunicorn については<a href="https://cfxlog.com/gunicorn-django-basics/">Gunicorn と Django の記事</a>で紹介しています）。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Dockerfile</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>FROM python:3.12-alpine
WORKDIR /app
COPY app.py .
EXPOSE 8000
CMD ["python", "app.py"]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">FROM</span><span style="color: #D4D4D4"> python:3.12-alpine</span></span>
<span class="line"><span style="color: #569CD6">WORKDIR</span><span style="color: #D4D4D4"> /app</span></span>
<span class="line"><span style="color: #569CD6">COPY</span><span style="color: #D4D4D4"> app.py .</span></span>
<span class="line"><span style="color: #569CD6">EXPOSE</span><span style="color: #D4D4D4"> 8000</span></span>
<span class="line"><span style="color: #569CD6">CMD</span><span style="color: #D4D4D4"> [</span><span style="color: #CE9178">&quot;python&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;app.py&quot;</span><span style="color: #D4D4D4">]</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os
import socket
from http.server import BaseHTTPRequestHandler, HTTPServer


class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path == "/health":
            body = "ok\n"
        else:
            # DB のコンテナにサービス名で接続できるかを確かめる
            try:
                socket.create_connection((os.environ["DB_HOST"], 5432), timeout=3).close()
                db = "reachable"
            except OSError as e:
                db = f"error: {e}"
            body = f"{os.environ.get('APP_MESSAGE')}\ndb: {db}\n"
        self.send_response(200)
        self.send_header("Content-Type", "text/plain; charset=utf-8")
        self.end_headers()
        self.wfile.write(body.encode())


if __name__ == "__main__":
    print("listening on 0.0.0.0:8000", flush=True)
    HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> os</span></span>
<span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> socket</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> http.server </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseHTTPRequestHandler, HTTPServer</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Handler</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseHTTPRequestHandler</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">do_GET</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.path == </span><span style="color: #CE9178">&quot;/health&quot;</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">            body = </span><span style="color: #CE9178">&quot;ok</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">else</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #6A9955"># DB のコンテナにサービス名で接続できるかを確かめる</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">                socket.create_connection((os.environ[</span><span style="color: #CE9178">&quot;DB_HOST&quot;</span><span style="color: #D4D4D4">], </span><span style="color: #B5CEA8">5432</span><span style="color: #D4D4D4">), </span><span style="color: #9CDCFE">timeout</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">).close()</span></span>
<span class="line"><span style="color: #D4D4D4">                db = </span><span style="color: #CE9178">&quot;reachable&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">except</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">OSError</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> e:</span></span>
<span class="line"><span style="color: #D4D4D4">                db = </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;error: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">e</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">            body = </span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">os.environ.get(</span><span style="color: #CE9178">&apos;APP_MESSAGE&apos;</span><span style="color: #D4D4D4">)</span><span style="color: #569CD6">}</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">db: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">db</span><span style="color: #569CD6">}</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.send_response(</span><span style="color: #B5CEA8">200</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.send_header(</span><span style="color: #CE9178">&quot;Content-Type&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;text/plain; charset=utf-8&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.end_headers()</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.wfile.write(body.encode())</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">__name__</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;__main__&quot;</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;listening on 0.0.0.0:8000&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">flush</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    HTTPServer((</span><span style="color: #CE9178">&quot;0.0.0.0&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">8000</span><span style="color: #D4D4D4">), Handler).serve_forever()</span></span></code></pre></div>



<p class="wp-block-paragraph">nginx は、受けたリクエストを <code>web</code> の8000番へ渡すだけの設定です。<code>proxy_pass</code> にサービス名の <code>web</code> を書けば、Compose のネットワークの中で名前が解決されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">nginx</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>server {
    listen 80;

    location / {
        proxy_pass http://web:8000;/
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">server</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">   </span><span style="color: #569CD6"> listen </span><span style="color: #D4D4D4">80;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">location</span><span style="color: #D4D4D4"> / {</span></span>
<span class="line"><span style="color: #D4D4D4">       </span><span style="color: #569CD6"> proxy_pass </span><span style="color: #D4D4D4">http://web:8000;/</span></span>
<span class="line"><span style="color: #D4D4D4">       </span><span style="color: #569CD6"> proxy_set_header </span><span style="color: #D4D4D4">Host $</span><span style="color: #9CDCFE">host</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">       </span><span style="color: #569CD6"> proxy_set_header </span><span style="color: #D4D4D4">X-Forwarded-For $</span><span style="color: #9CDCFE">proxy_add_x_forwarded_for</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">よく使う docker compose コマンド</h2>



<p class="wp-block-paragraph">コマンドは、<code>compose.yaml</code> のあるフォルダで実行します。</p>



<h3 class="wp-block-heading">起動する（up -d）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose up -d</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>-d</code> を付けると、バックグラウンドで起動してターミナルに戻ります。付けないと、全サービスのログが流れ続ける状態になり、<code>Ctrl + C</code> で止まります。</p>



<p class="wp-block-paragraph"><code>build:</code> のあるサービスは、イメージがまだなければ最初の <code>up</code> で作られます。2回目以降は、<strong>すでにイメージがあれば作り直しません</strong>。コードを変えたら <code>--build</code> を付けます。例の <code>myapp</code> を初めて起動したときの出力です（イメージを作る部分は省略しています）。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose up -d --build</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--build</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>（イメージを作る出力は省略）
 web  Built
 Network myapp_default  Creating
 Network myapp_default  Created
 Volume "myapp_db_data"  Creating
 Volume "myapp_db_data"  Created
 Container myapp-db-1  Creating
 Container myapp-db-1  Created
 Container myapp-web-1  Creating
 Container myapp-web-1  Created
 Container myapp-nginx-1  Creating
 Container myapp-nginx-1  Created
 Container myapp-db-1  Starting
 Container myapp-db-1  Started
 Container myapp-db-1  Waiting
 Container myapp-db-1  Healthy
 Container myapp-web-1  Starting
 Container myapp-web-1  Started
 Container myapp-web-1  Waiting
 Container myapp-web-1  Healthy
 Container myapp-nginx-1  Starting
 Container myapp-nginx-1  Started</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">（イメージを作る出力は省略）</span></span>
<span class="line"><span style="color: #D4D4D4"> web  Built</span></span>
<span class="line"><span style="color: #D4D4D4"> Network myapp_default  Creating</span></span>
<span class="line"><span style="color: #D4D4D4"> Network myapp_default  Created</span></span>
<span class="line"><span style="color: #D4D4D4"> Volume &quot;myapp_db_data&quot;  Creating</span></span>
<span class="line"><span style="color: #D4D4D4"> Volume &quot;myapp_db_data&quot;  Created</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Creating</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Created</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Creating</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Created</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Creating</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Created</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Started</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Waiting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Healthy</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Started</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Waiting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Healthy</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Started</span></span></code></pre></div>



<p class="wp-block-paragraph">ネットワーク（<code>myapp_default</code>）とボリューム（<code>myapp_db_data</code>）が自動で作られ、<code>db</code> → <code>web</code> → <code>nginx</code> の順に起動しました。<code>Waiting</code> と <code>Healthy</code> は、後で説明する healthcheck を待っているところです。コンテナ名は「プロジェクト名-サービス名-番号」になります。</p>



<p class="wp-block-paragraph">ブラウザか <code>curl</code> で <code>https://cfxlog.com/</code> を開くと、nginx を通して <code>web</code> の応答が返りました。<code>web</code> から <code>db</code> にも、サービス名でつながっています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>curl -s https://cfxlog.com/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-s</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://cfxlog.com/</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>hello from .env
db: reachable</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">hello from .env</span></span>
<span class="line"><span style="color: #D4D4D4">db: reachable</span></span></code></pre></div>



<h3 class="wp-block-heading">状態を見る（ps）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose ps</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ps</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>NAME            IMAGE                COMMAND                   SERVICE   CREATED          STATUS                    PORTS
myapp-db-1      postgres:16-alpine   "docker-entrypoint.s…"   db        12 seconds ago   Up 11 seconds (healthy)   5432/tcp
myapp-nginx-1   nginx:1.30-alpine    "/docker-entrypoint.…"   nginx     12 seconds ago   Up Less than a second     127.0.0.1:8080->80/tcp
myapp-web-1     myapp-web:local      "python app.py"           web       12 seconds ago   Up 5 seconds (healthy)    8000/tcp</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">NAME            IMAGE                COMMAND                   SERVICE   CREATED          STATUS                    PORTS</span></span>
<span class="line"><span style="color: #D4D4D4">myapp-db-1      postgres:16-alpine   &quot;docker-entrypoint.s…&quot;   db        12 seconds ago   Up 11 seconds (healthy)   5432/tcp</span></span>
<span class="line"><span style="color: #D4D4D4">myapp-nginx-1   nginx:1.30-alpine    &quot;/docker-entrypoint.…&quot;   nginx     12 seconds ago   Up Less than a second     127.0.0.1:8080-&gt;80/tcp</span></span>
<span class="line"><span style="color: #D4D4D4">myapp-web-1     myapp-web:local      &quot;python app.py&quot;           web       12 seconds ago   Up 5 seconds (healthy)    8000/tcp</span></span></code></pre></div>



<p class="wp-block-paragraph">動いているコンテナの一覧です。<code>STATUS</code> に healthcheck の結果（<code>healthy</code>）、<code>PORTS</code> に公開しているポートが出ます。ホストに公開しているのは nginx の <code>127.0.0.1:8080->80/tcp</code> だけで、<code>db</code> と <code>web</code> はコンテナの中のポート番号だけが表示されています。<code>docker compose ps -a</code> とすると、止まっているコンテナも表示されます。</p>



<h3 class="wp-block-heading">ログを見る（logs -f）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose logs web</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">logs</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>web-1  | listening on 0.0.0.0:8000
web-1  | 127.0.0.1 - - [18/Nov/2026 05:21:16] "GET /health HTTP/1.1" 200 -
web-1  | 172.18.0.4 - - [18/Nov/2026 05:21:17] "GET / HTTP/1.1" 200 -</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">web-1  | listening on 0.0.0.0:8000</span></span>
<span class="line"><span style="color: #D4D4D4">web-1  | 127.0.0.1 - - [18/Nov/2026 05:21:16] &quot;GET /health HTTP/1.1&quot; 200 -</span></span>
<span class="line"><span style="color: #D4D4D4">web-1  | 172.18.0.4 - - [18/Nov/2026 05:21:17] &quot;GET / HTTP/1.1&quot; 200 -</span></span></code></pre></div>



<p class="wp-block-paragraph">行の先頭にサービス名が付きます。healthcheck の <code>/health</code> と、nginx から届いたリクエストが記録されていました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose logs -f web
docker compose logs --tail 3 nginx</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">logs</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-f</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">logs</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--tail</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx</span></span></code></pre></div>



<p class="wp-block-paragraph">サービス名を省くと、全サービスのログがまとめて出ます。<code>-f</code> は新しいログを流し続ける指定で、<code>Ctrl + C</code> で抜けます。<code>--tail</code> で、最後の何行だけを見るかを指定できます。</p>



<h3 class="wp-block-heading">コンテナの中でコマンドを実行する（exec）</h3>



<p class="wp-block-paragraph">動いているコンテナの中で、シェルやコマンドを実行します。指定するのはコンテナ名ではなく、<code>compose.yaml</code> のサービス名です。DB にテーブルを作り、1行入れてみました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose exec db psql -U myapp -d myapp -c "CREATE TABLE notes (body text); INSERT INTO notes VALUES ('kept');"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">db</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">psql</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-U</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;CREATE TABLE notes (body text); INSERT INTO notes VALUES (&apos;kept&apos;);&quot;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>CREATE TABLE
INSERT 0 1</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">CREATE TABLE</span></span>
<span class="line"><span style="color: #D4D4D4">INSERT 0 1</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose exec web sh -c 'echo $APP_MESSAGE'
docker compose exec web python --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sh</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;echo $APP_MESSAGE&apos;</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>hello from .env
Python 3.12.16</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">hello from .env</span></span>
<span class="line"><span style="color: #D4D4D4">Python 3.12.16</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>docker compose exec web sh</code> とすれば、コンテナの中のシェルに入れます。Django なら <code>docker compose exec web python manage.py migrate</code> のように、<code>manage.py</code> の実行にも使います。</p>



<h3 class="wp-block-heading">イメージを作り直す（build）</h3>



<p class="wp-block-paragraph"><code>web/app.py</code> の <code>/health</code> の応答を <code>ok</code> から <code>ok v2</code> に書き換えてから、<code>up -d</code> だけを実行してみました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose up -d
docker compose exec web wget -qO- https://cfxlog.com/health</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">wget</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-qO-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://cfxlog.com/health</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly> Container myapp-db-1  Running
 Container myapp-web-1  Running
 Container myapp-nginx-1  Running
（中略）
ok</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">ok</span></span></code></pre></div>



<p class="wp-block-paragraph">イメージがすでにあるので作り直されず、古いコードのまま <code>ok</code> が返りました。<code>build</code> でイメージを作り直してから <code>up -d</code> すると、変更が反映されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose build web
docker compose up -d
docker compose exec web wget -qO- https://cfxlog.com/health</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">build</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">wget</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-qO-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://cfxlog.com/health</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>（イメージを作る出力は省略）
 web  Built
 Container myapp-db-1  Running
 Container myapp-web-1  Recreate
 Container myapp-web-1  Recreated
 Container myapp-nginx-1  Running
（中略）
ok v2</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">（イメージを作る出力は省略）</span></span>
<span class="line"><span style="color: #D4D4D4"> web  Built</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Recreate</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Recreated</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">ok v2</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>build</code> はイメージを作るだけで、動いているコンテナは入れ替わりません。そのあとの <code>up -d</code> で、<code>web</code> だけが新しいイメージで作り直されました（<code>Recreate</code>）。<code>up -d --build</code> は、この2つを1回で行う書き方です。</p>



<h3 class="wp-block-heading">再起動する（restart）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose restart web</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">restart</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">web</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly> Container myapp-web-1  Restarting
 Container myapp-web-1  Started</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Restarting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Started</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>restart</code> は、いまあるコンテナをそのまま止めて起動し直します。公式ドキュメントにあるとおり、<strong>compose.yaml や .env を書き換えた内容は、restart では反映されません</strong>。</p>



<p class="wp-block-paragraph">なお、restart の直後に <code>curl</code> でアクセスしたところ、nginx から <code>502 Bad Gateway</code> が返りました。<code>web</code> が起動し直している最中だったためと考えられます。再起動した直後の数秒は、このようにエラーになることがあります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;html>
&lt;head>&lt;title>502 Bad Gateway&lt;/title>&lt;/head>
（以下略）</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&lt;html&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">&lt;head&gt;&lt;title&gt;502 Bad Gateway&lt;/title&gt;&lt;/head&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">（以下略）</span></span></code></pre></div>



<p class="wp-block-paragraph">設定を変えたときは、<code>restart</code> ではなく <code>docker compose up -d</code> を実行します。<code>.env</code> の <code>APP_MESSAGE</code> を <code>changed in .env</code> に書き換えてから実行すると、設定の変わった <code>web</code> だけが作り直され、新しい値になりました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose up -d
curl -s https://cfxlog.com/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span>
<span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-s</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://cfxlog.com/</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly> Container myapp-db-1  Running
 Container myapp-web-1  Recreate
 Container myapp-web-1  Recreated
 Container myapp-nginx-1  Running
（中略）
changed in .env
db: reachable</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Recreate</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Recreated</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Running</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">changed in .env</span></span>
<span class="line"><span style="color: #D4D4D4">db: reachable</span></span></code></pre></div>



<h3 class="wp-block-heading">止める（down / stop）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose stop
docker compose down
docker compose down -v</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">stop</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-v</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>コンテナ</th><th>ネットワーク</th><th>名前付きボリューム（DB のデータ）</th></tr></thead><tbody><tr><td><code>stop</code></td><td>止める（残る）</td><td>残る</td><td>残る</td></tr><tr><td><code>down</code></td><td>削除する</td><td>削除する</td><td>残る</td></tr><tr><td><code>down -v</code></td><td>削除する</td><td>削除する</td><td><strong>削除する</strong></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">普段止めるときは <code>down</code> で十分で、DB のデータは名前付きボリュームに残ります（次の「ボリュームでデータを残す」で確かめています）。<code>down -v</code> はデータまで消すので、作り直してよい開発用の環境のときだけ使います。</p>



<h3 class="wp-block-heading">コマンドの早見表</h3>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>やること</th></tr></thead><tbody><tr><td><code>docker compose up -d</code></td><td>バックグラウンドで起動（設定が変わったものは作り直す）</td></tr><tr><td><code>docker compose up -d --build</code></td><td>イメージを作り直してから起動</td></tr><tr><td><code>docker compose ps</code></td><td>状態を見る（<code>-a</code> で止まったものも）</td></tr><tr><td><code>docker compose logs -f &lt;サービス&gt;</code></td><td>ログを流し続けて見る</td></tr><tr><td><code>docker compose exec &lt;サービス&gt; &lt;コマンド&gt;</code></td><td>コンテナの中で実行</td></tr><tr><td><code>docker compose build</code></td><td>イメージを作る</td></tr><tr><td><code>docker compose restart &lt;サービス&gt;</code></td><td>そのまま起動し直す（設定の変更は反映されない）</td></tr><tr><td><code>docker compose down</code></td><td>コンテナとネットワークを削除（<code>-v</code> でボリュームも）</td></tr><tr><td><code>docker compose config</code></td><td>変数を展開した最終形を表示・文法を確かめる</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">docker compose config で書き間違いを確かめる</h2>



<h3 class="wp-block-heading">変数を展開した最終形を表示する</h3>



<p class="wp-block-paragraph"><code>docker compose config</code> は、<code>.env</code> の値を埋め込んだあとの、Compose が実際に使う設定を表示します。コンテナは起動しないので、書き換えたあとの確認に便利です。例の <code>myapp</code> で実行した結果の一部です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose config</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">config</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>name: myapp
services:
  db:
    environment:
      POSTGRES_DB: myapp
      POSTGRES_PASSWORD: change-me
      POSTGRES_USER: myapp
（中略）
    image: postgres:16-alpine
    mem_limit: "268435456"
（中略）
  nginx:
（中略）
    ports:
      - mode: ingress
        host_ip: 127.0.0.1
        target: 80
        published: "8080"
        protocol: tcp
（中略）
volumes:
  db_data:
    name: myapp_db_data</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">name: myapp</span></span>
<span class="line"><span style="color: #D4D4D4">services:</span></span>
<span class="line"><span style="color: #D4D4D4">  db:</span></span>
<span class="line"><span style="color: #D4D4D4">    environment:</span></span>
<span class="line"><span style="color: #D4D4D4">      POSTGRES_DB: myapp</span></span>
<span class="line"><span style="color: #D4D4D4">      POSTGRES_PASSWORD: change-me</span></span>
<span class="line"><span style="color: #D4D4D4">      POSTGRES_USER: myapp</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">    image: postgres:16-alpine</span></span>
<span class="line"><span style="color: #D4D4D4">    mem_limit: &quot;268435456&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">  nginx:</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">    ports:</span></span>
<span class="line"><span style="color: #D4D4D4">      - mode: ingress</span></span>
<span class="line"><span style="color: #D4D4D4">        host_ip: 127.0.0.1</span></span>
<span class="line"><span style="color: #D4D4D4">        target: 80</span></span>
<span class="line"><span style="color: #D4D4D4">        published: &quot;8080&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        protocol: tcp</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">volumes:</span></span>
<span class="line"><span style="color: #D4D4D4">  db_data:</span></span>
<span class="line"><span style="color: #D4D4D4">    name: myapp_db_data</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.env</code> の値が入り、<code>256m</code> と書いた <code>mem_limit</code> がバイト数（268435456）で表示されています。ボリュームの実際の名前は、プロジェクト名が付いた <code>myapp_db_data</code> になることも分かります。</p>



<p class="wp-block-paragraph">サービス名やボリューム名だけを見たいときは、<code>--services</code>・<code>--volumes</code> を付けます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose config --services</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">config</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--services</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>db
web
nginx</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">db</span></span>
<span class="line"><span style="color: #D4D4D4">web</span></span>
<span class="line"><span style="color: #D4D4D4">nginx</span></span></code></pre></div>



<h3 class="wp-block-heading">書き間違いを見つける</h3>



<p class="wp-block-paragraph"><code>-q</code>（<code>--quiet</code>）を付けると、問題がなければ何も表示せず、間違いがあるときだけエラーを出します。わざとインデントをずらしたファイルと、<code>restart</code> を <code>restarts</code> と書き間違えたファイルで試しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose config -q</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">config</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-q</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>yaml: line 51: mapping values are not allowed in this context</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">yaml: line 51: mapping values are not allowed in this context</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>validating /path/to/myapp/compose.yaml: services.db Additional property restarts is not allowed</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">validating /path/to/myapp/compose.yaml: services.db Additional property restarts is not allowed</span></span></code></pre></div>



<p class="wp-block-paragraph">YAML の文法の誤りだけでなく、存在しない項目名も見つけてくれます。<code>compose.yaml</code> を書き換えたら、<code>up</code> の前に一度 <code>config -q</code> を通しておくと安心です。</p>



<h2 class="wp-block-heading">環境変数と .env</h2>



<h3 class="wp-block-heading">.env に値を書く</h3>



<p class="wp-block-paragraph">パスワードなど、ファイルに直接書きたくない値は、<code>compose.yaml</code> と同じフォルダの <code>.env</code> に書きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># .env
DB_NAME=myapp
DB_USER=myapp
DB_PASSWORD=change-me
APP_MESSAGE=hello from .env</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"># .env</span></span>
<span class="line"><span style="color: #D4D4D4">DB_NAME=myapp</span></span>
<span class="line"><span style="color: #D4D4D4">DB_USER=myapp</span></span>
<span class="line"><span style="color: #D4D4D4">DB_PASSWORD=change-me</span></span>
<span class="line"><span style="color: #D4D4D4">APP_MESSAGE=hello from .env</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>compose.yaml</code> の中の <code>${DB_PASSWORD}</code> のような部分が、<code>.env</code> の値に置き換わります。<code>.env</code> は Compose が自動で読み込むので、指定は要りません。別のファイルを使うときは <code>--env-file</code> で渡します。</p>



<h3 class="wp-block-heading">${変数:?} で必須に、${変数:-} で既定値を付ける</h3>



<figure class="wp-block-table"><table><thead><tr><th>書き方</th><th>意味</th></tr></thead><tbody><tr><td><code>${DB_NAME}</code></td><td>値を入れる。なければ空になり、警告が出る</td></tr><tr><td><code>${APP_MESSAGE:-hello from web}</code></td><td>なければ <code>hello from web</code> を使う</td></tr><tr><td><code>${DB_NAME:?Set DB_NAME in .env}</code></td><td>なければエラーで止める（メッセージ付き）</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">パスワードやデータベース名は、空のまま起動すると困るので <code>:?</code> で必須にしています。<code>.env</code> がない状態で確かめると、次のエラーで止まりました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>error while interpolating services.web.environment.DB_NAME: required variable DB_NAME is missing a value: Set DB_NAME in .env</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">error while interpolating services.web.environment.DB_NAME: required variable DB_NAME is missing a value: Set DB_NAME in .env</span></span></code></pre></div>



<h3 class="wp-block-heading">シェルの環境変数は .env より優先される</h3>



<p class="wp-block-paragraph">同じ名前の変数がシェルにもあると、<code>.env</code> よりシェルの値が使われます。<code>APP_MESSAGE="from shell"</code> を付けて <code>config</code> を実行すると、<code>.env</code> に書いた <code>hello from .env</code> ではなく、シェルの値が入りました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>APP_MESSAGE="from shell" docker compose config --format json</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #9CDCFE">APP_MESSAGE</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;from shell&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">config</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">json</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>    "web": {
（中略）
      "environment": {
        "APP_MESSAGE": "from shell",
（以下略）</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">    &quot;web&quot;: {</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">      &quot;environment&quot;: {</span></span>
<span class="line"><span style="color: #D4D4D4">        &quot;APP_MESSAGE&quot;: &quot;from shell&quot;,</span></span>
<span class="line"><span style="color: #D4D4D4">（以下略）</span></span></code></pre></div>



<p class="wp-block-paragraph">「.env を直したのに値が変わらない」ときは、シェルに同じ名前の変数が残っていないかを <code>echo $APP_MESSAGE</code> などで確かめてみてください。</p>



<h3 class="wp-block-heading">.env は Git に入れない</h3>



<p class="wp-block-paragraph"><code>.env</code> にはパスワードを書くので、<code>.gitignore</code> に入れて Git の管理から外します。代わりに、値をダミーにした <code>.env.example</code> をリポジトリに入れておくと、ほかの環境で何を設定すればよいかが分かります。</p>



<h2 class="wp-block-heading">depends_on と healthcheck で起動の順番をそろえる</h2>



<h3 class="wp-block-heading">depends_on だけでは「起動した」までしか待たない</h3>



<p class="wp-block-paragraph"><code>depends_on: [db]</code> のように書くだけだと、Compose は <code>db</code> のコンテナが<strong>起動したこと</strong>までしか待ちません。PostgreSQL は、コンテナが起動してから接続を受け付けるまでに少し時間がかかります。そのため、アプリが先に DB へつなぎに行って失敗することがあります。</p>



<h3 class="wp-block-heading">healthcheck と condition: service_healthy を組み合わせる</h3>



<p class="wp-block-paragraph">そこで、<code>db</code> に <code>healthcheck</code> を書き、<code>web</code> の <code>depends_on</code> に <code>condition: service_healthy</code> を付けます。こうすると、<code>db</code> の healthcheck が成功する（<code>healthy</code> になる）まで、<code>web</code> の起動を待ちます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>  web:
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U \"$$POSTGRES_USER\" -d \"$$POSTGRES_DB\""]
      interval: 5s
      timeout: 5s
      retries: 5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">web</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">depends_on</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">condition</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">service_healthy</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">postgres:16-alpine</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">healthcheck</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">test</span><span style="color: #D4D4D4">: [</span><span style="color: #CE9178">&quot;CMD-SHELL&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;pg_isready -U </span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">$$POSTGRES_USER</span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178"> -d </span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">$$POSTGRES_DB</span><span style="color: #D7BA7D">\&quot;</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">interval</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">timeout</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">retries</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">5</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>意味</th></tr></thead><tbody><tr><td><code>test</code></td><td>確かめるコマンド。終了コード0なら成功</td></tr><tr><td><code>interval</code></td><td>確かめる間隔</td></tr><tr><td><code>timeout</code></td><td>1回の確認の制限時間</td></tr><tr><td><code>retries</code></td><td>何回続けて失敗したら <code>unhealthy</code> にするか</td></tr><tr><td><code>start_period</code></td><td>起動直後の、失敗を数えない猶予の時間</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">例では、同じ考え方で <code>nginx</code> も <code>web</code> の healthcheck を待つようにしています。<code>docker compose stop</code> で全部止めてから起動し直すと、この順番で立ち上がりました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose stop
docker compose up -d</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">stop</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>（stop の出力と、up の最初の数行は省略）
 Container myapp-db-1  Starting
 Container myapp-db-1  Started
 Container myapp-db-1  Waiting
 Container myapp-db-1  Healthy
 Container myapp-web-1  Starting
 Container myapp-web-1  Started
 Container myapp-web-1  Waiting
 Container myapp-web-1  Healthy
 Container myapp-nginx-1  Starting
 Container myapp-nginx-1  Started</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">（stop の出力と、up の最初の数行は省略）</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Started</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Waiting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Healthy</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Started</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Waiting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-web-1  Healthy</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Starting</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-nginx-1  Started</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>db</code> が <code>Healthy</code> になってから <code>web</code> が起動し、<code>web</code> が <code>Healthy</code> になってから <code>nginx</code> が起動しています。</p>



<h3 class="wp-block-heading">healthcheck の書き方の注意</h3>



<p class="wp-block-paragraph"><code>pg_isready</code> の例の <code>$$POSTGRES_USER</code> は、<code>$</code> を2つ重ねています。<code>$</code> が1つだと、Compose がファイルを読む時点で変数として置き換えてしまうからです。<code>$$</code> と書くと、コンテナの中のシェルに <code>$POSTGRES_USER</code> として渡ります。</p>



<p class="wp-block-paragraph">MariaDB の公式イメージには、確認用の <code>healthcheck.sh</code> が入っています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">healthcheck</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">test</span><span style="color: #D4D4D4">: [</span><span style="color: #CE9178">&quot;CMD&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;healthcheck.sh&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--connect&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--innodb_initialized&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">interval</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">10s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">timeout</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">retries</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">5</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">start_period</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">30s</span></span></code></pre></div>



<p class="wp-block-paragraph">自分で作るアプリなら、<code>/health</code> のような確認用の URL を用意しておき、それにアクセスするコマンドを書きます。イメージに <code>curl</code> が入っていないことも多いので、例の <code>web</code> では Python の <code>urllib</code> を使っています。</p>



<h2 class="wp-block-heading">ボリュームでデータを残す</h2>



<h3 class="wp-block-heading">名前付きボリューム</h3>



<p class="wp-block-paragraph">コンテナを削除すると、コンテナの中に書いたファイルは消えます。DB のデータのように残したいものは、名前付きボリュームに置きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>services:
  db:
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">db_data:/var/lib/postgresql/data</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db_data</span><span style="color: #D4D4D4">:</span></span></code></pre></div>



<p class="wp-block-paragraph">最後の <code>volumes:</code> で宣言した <code>db_data</code> は、Docker が管理する場所に作られます。実際の名前は、プロジェクト名の付いた <code>myapp_db_data</code> です。<code>exec</code> の例で入れた1行が、<code>down</code> のあとも残るかを確かめました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose down
docker compose ps -a
docker volume ls --filter name=myapp</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ps</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-a</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">volume</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ls</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--filter</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">name=myapp</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>（中略）
 Container myapp-db-1  Removed
 Network myapp_default  Removing
 Network myapp_default  Removed
NAME      IMAGE     COMMAND   SERVICE   CREATED   STATUS    PORTS
DRIVER    VOLUME NAME
local     myapp_db_data</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4"> Container myapp-db-1  Removed</span></span>
<span class="line"><span style="color: #D4D4D4"> Network myapp_default  Removing</span></span>
<span class="line"><span style="color: #D4D4D4"> Network myapp_default  Removed</span></span>
<span class="line"><span style="color: #D4D4D4">NAME      IMAGE     COMMAND   SERVICE   CREATED   STATUS    PORTS</span></span>
<span class="line"><span style="color: #D4D4D4">DRIVER    VOLUME NAME</span></span>
<span class="line"><span style="color: #D4D4D4">local     myapp_db_data</span></span></code></pre></div>



<p class="wp-block-paragraph">コンテナとネットワークは削除されましたが、ボリュームは残っています。もう一度起動して、テーブルの中身を見ます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose up -d
docker compose exec db psql -U myapp -d myapp -c "SELECT * FROM notes;"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span>
<span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">exec</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">db</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">psql</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-U</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;SELECT * FROM notes;&quot;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly> body 
------
 kept
(1 row)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"> body </span></span>
<span class="line"><span style="color: #D4D4D4">------</span></span>
<span class="line"><span style="color: #D4D4D4"> kept</span></span>
<span class="line"><span style="color: #D4D4D4">(1 row)</span></span></code></pre></div>



<p class="wp-block-paragraph">コンテナを作り直しても、データは残っていました。<code>down -v</code> を実行すると、ボリュームも削除されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose down -v</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-v</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>（中略）
 Volume myapp_db_data  Removing
 Volume myapp_db_data  Removed
 Network myapp_default  Removed</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4"> Volume myapp_db_data  Removing</span></span>
<span class="line"><span style="color: #D4D4D4"> Volume myapp_db_data  Removed</span></span>
<span class="line"><span style="color: #D4D4D4"> Network myapp_default  Removed</span></span></code></pre></div>



<h3 class="wp-block-heading">バインドマウントと :ro</h3>



<p class="wp-block-paragraph">ホストのファイルをそのままコンテナに見せたいときは、パスで指定します（バインドマウント）。設定ファイルのように、コンテナから書き換える必要がないものには <code>:ro</code>（読み取り専用）を付けておくと安心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>種類</th><th>書き方の例</th><th>向いているもの</th></tr></thead><tbody><tr><td>名前付きボリューム</td><td><code>db_data:/var/lib/postgresql/data</code></td><td>DB のデータ、WordPress の wp-content</td></tr><tr><td>バインドマウント</td><td><code>./nginx/default.conf:/etc/nginx/...:ro</code></td><td>設定ファイル、証明書、静的ファイル</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">ポートは 127.0.0.1 に限って公開する</h2>



<h3 class="wp-block-heading">&#8220;8080:80&#8221; と書くと、すべてのアドレスで待ち受ける</h3>



<p class="wp-block-paragraph"><code>ports</code> に <code>"8080:80"</code> とだけ書くと、ホストのすべてのネットワーク（<code>0.0.0.0</code>）の8080番で待ち受けます。VPS なら、インターネットから直接つながる状態です。</p>



<p class="wp-block-paragraph">ホストの中からだけ使えればよいポートは、<code>127.0.0.1:</code> を付けて公開先を限ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>    ports:
      - "127.0.0.1:8080:80"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">&quot;127.0.0.1:8080:80&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>config</code> の出力でも、<code>host_ip: 127.0.0.1</code> になっていることを確かめられます。起動したあとは、<code>docker compose port</code> で実際の公開先を確かめられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker compose port nginx 80</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">port</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">80</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>127.0.0.1:8080</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">127.0.0.1:8080</span></span></code></pre></div>



<p class="wp-block-paragraph">同じ Mac から <code>127.0.0.1:8080</code> にアクセスすると 200 が返りました。一方、同じ Mac の LAN 側の IP アドレス（<code>192.168.x.x</code> など）の8080番にアクセスすると、つながりませんでした（<code>curl</code> の終了コードは 7）。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>curl -s -o /dev/null -w "%{http_code}\n" https://cfxlog.com/
curl -s -m 3 -o /dev/null -w "%{http_code}\n" http://192.168.x.x:8080/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-s</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-o</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/dev/null</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-w</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;%{http_code}\n&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://cfxlog.com/</span></span>
<span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-s</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-m</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-o</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/dev/null</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-w</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;%{http_code}\n&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">http://192.168.x.x:8080/</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>200
000</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">200</span></span>
<span class="line"><span style="color: #D4D4D4">000</span></span></code></pre></div>



<h3 class="wp-block-heading">ufw などのファイアウォールでは守れないことがある</h3>



<p class="wp-block-paragraph">Linux で Docker がポートを公開するときは、Docker 自身が iptables のルールを書き込みます。そのため、ufw で8080番を閉じたつもりでも、Docker が公開したポートには外からつながってしまうことがあります（Docker の公式ドキュメントにも、ufw とは組み合わせにくいことが書かれています）。</p>



<p class="wp-block-paragraph">僕の VPS では、ファイアウォールに頼らず、<strong>compose.yaml の公開先で守る</strong>ことにしています。WordPress の管理画面のように自分だけが使うものは <code>127.0.0.1</code> に限り、SSH のポート転送でつないでいます（SSH の使い方は<a href="https://cfxlog.com/linux-ssh-guide/">SSH の記事</a>にまとめています）。</p>



<h3 class="wp-block-heading">外に出すのは nginx だけにする</h3>



<p class="wp-block-paragraph">例の <code>compose.yaml</code> では、<code>ports</code> を書いているのは <code>nginx</code> だけです。<code>web</code> と <code>db</code> はホストにポートを公開していないので、同じ Compose のネットワークの中のコンテナからしかつながりません。DB のポート（5432 や 3306）は、特に理由がなければ公開しません。</p>



<p class="wp-block-paragraph">複数の Compose のプロジェクトを1つの nginx の後ろに並べたいときは、外部のネットワークを作って共有します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>name: myapp2

services:
  web:
    image: myapp2-web:local
    networks:
      proxy:
        aliases:
          - myapp2-web

networks:
  proxy:
    external: true</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">myapp2</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">web</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">myapp2-web:local</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">networks</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">proxy</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">aliases</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">          - </span><span style="color: #CE9178">myapp2-web</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">networks</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">proxy</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">external</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">true</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>external: true</code> は、「このネットワークは Compose の外で作ったものを使う」という指定です。先に <code>docker network create proxy</code> で作っておき、nginx 側の Compose も同じ <code>proxy</code> につなぎます。nginx からは <code>myapp2-web</code> という名前で届きます。nginx と Let&#8217;s Encrypt の組み合わせは<a href="https://cfxlog.com/docker-nginx-proxy-letsencrypt/">Docker の nginx でリバースプロキシを作る記事</a>で紹介しています。</p>



<h2 class="wp-block-heading">restart の方針と mem_limit</h2>



<h3 class="wp-block-heading">restart の選び方</h3>



<figure class="wp-block-table"><table><thead><tr><th>値</th><th>動き</th></tr></thead><tbody><tr><td><code>"no"</code>（既定）</td><td>自動では起動し直さない</td></tr><tr><td><code>always</code></td><td>止まったら必ず起動し直す。手で止めても、Docker の再起動で起動する</td></tr><tr><td><code>on-failure</code></td><td>エラーで終わったときだけ起動し直す</td></tr><tr><td><code>unless-stopped</code></td><td>止まったら起動し直す。ただし手で止めたものは起動しない</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><code>no</code> は YAML では真偽値と解釈されることがあるので、<code>"no"</code> と引用符で囲んで書きます。</p>



<h3 class="wp-block-heading">僕の使い分け</h3>



<p class="wp-block-paragraph">サイトとして常に動かしておく Web アプリと nginx は <code>unless-stopped</code> にしています。サーバーを再起動しても自動で立ち上がり、メンテナンスで <code>docker compose stop</code> したときは勝手に起動しません。</p>



<p class="wp-block-paragraph">一方、記事を書くときだけ起動する WordPress は <code>restart: "no"</code> にしています。使い終わったら止めておき、サーバーの再起動で勝手に立ち上がってメモリを使わないようにするためです。</p>



<h3 class="wp-block-heading">mem_limit でメモリの上限を決める</h3>



<p class="wp-block-paragraph">小さな VPS で複数のコンテナを動かすときは、<code>mem_limit</code> でコンテナごとのメモリの上限を決めておきます。1つのコンテナがメモリを使い切って、ほかのサービスまで巻き込んで止まるのを防ぐためです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>    mem_limit: 256m</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">256m</span></span></code></pre></div>



<p class="wp-block-paragraph">設定した上限は、<code>docker stats</code> の右側に表示されます。例の <code>myapp</code> を起動した直後の使用量です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker stats --no-stream --format '{{.Name}}  {{.MemUsage}}' $(docker compose ps -q)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">stats</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-stream</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;{{.Name}}  {{.MemUsage}}&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">$(</span><span style="color: #DCDCAA">docker</span><span style="color: #CE9178"> compose ps </span><span style="color: #569CD6">-q</span><span style="color: #CE9178">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>myapp-db-1  59.44MiB / 256MiB
myapp-nginx-1  10.38MiB / 64MiB
myapp-web-1  11.85MiB / 256MiB</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">myapp-db-1  59.44MiB / 256MiB</span></span>
<span class="line"><span style="color: #D4D4D4">myapp-nginx-1  10.38MiB / 64MiB</span></span>
<span class="line"><span style="color: #D4D4D4">myapp-web-1  11.85MiB / 256MiB</span></span></code></pre></div>



<p class="wp-block-paragraph">上限を超えたコンテナは、強制的に終了させられます。小さくしすぎると落ちる原因になるので、<code>docker stats</code> で普段の使用量を見てから、余裕を持たせて決めます。僕は WordPress を 512m、MariaDB を 256m にしています。</p>



<h2 class="wp-block-heading">WordPress と MariaDB を動かす例</h2>



<h3 class="wp-block-heading">compose.yaml</h3>



<p class="wp-block-paragraph">ここまでの考え方で書いた、WordPress と MariaDB の <code>compose.yaml</code> です。<code>.env</code> には <code>DB_NAME</code>・<code>DB_USER</code>・<code>DB_PASSWORD</code>・<code>DB_ROOT_PASSWORD</code> を書きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>name: mywp

services:
  wordpress:
    image: wordpress:php8.3-apache
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: ${DB_NAME:?Set DB_NAME in .env}
      WORDPRESS_DB_USER: ${DB_USER:?Set DB_USER in .env}
      WORDPRESS_DB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
    ports:
      - "127.0.0.1:${WP_PORT:-8090}:80"
    volumes:
      - wp_content:/var/www/html/wp-content
    depends_on:
      db:
        condition: service_healthy
    mem_limit: 512m
    restart: "no"

  db:
    image: mariadb:11
    environment:
      MARIADB_DATABASE: ${DB_NAME:?Set DB_NAME in .env}
      MARIADB_USER: ${DB_USER:?Set DB_USER in .env}
      MARIADB_PASSWORD: ${DB_PASSWORD:?Set DB_PASSWORD in .env}
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:?Set DB_ROOT_PASSWORD in .env}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    mem_limit: 256m
    restart: "no"

volumes:
  wp_content:
  db_data:</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">name</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">mywp</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">wordpress</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">wordpress:php8.3-apache</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">WORDPRESS_DB_HOST</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">db</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">WORDPRESS_DB_NAME</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_NAME:?Set DB_NAME in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">WORDPRESS_DB_USER</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_USER:?Set DB_USER in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">WORDPRESS_DB_PASSWORD</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_PASSWORD:?Set DB_PASSWORD in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">&quot;127.0.0.1:${WP_PORT:-8090}:80&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">wp_content:/var/www/html/wp-content</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">depends_on</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">condition</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">service_healthy</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">512m</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;no&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">image</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">mariadb:11</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">MARIADB_DATABASE</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_NAME:?Set DB_NAME in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">MARIADB_USER</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_USER:?Set DB_USER in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">MARIADB_PASSWORD</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_PASSWORD:?Set DB_PASSWORD in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">MARIADB_ROOT_PASSWORD</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">${DB_ROOT_PASSWORD:?Set DB_ROOT_PASSWORD in .env}</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">db_data:/var/lib/mysql</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">healthcheck</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">test</span><span style="color: #D4D4D4">: [</span><span style="color: #CE9178">&quot;CMD&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;healthcheck.sh&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--connect&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--innodb_initialized&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">interval</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">10s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">timeout</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">5s</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">retries</span><span style="color: #D4D4D4">: </span><span style="color: #B5CEA8">5</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">start_period</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">30s</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">mem_limit</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">256m</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">restart</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;no&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">volumes</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">wp_content</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">db_data</span><span style="color: #D4D4D4">:</span></span></code></pre></div>



<p class="wp-block-paragraph">この例は <code>docker compose config -q</code> でエラーが出ないことを確かめています。<code>WP_PORT=8091</code> を付けて実行すると、公開するポートが <code>127.0.0.1</code> の8091番に変わりました。</p>



<h3 class="wp-block-heading">この例のポイント</h3>



<ul class="wp-block-list">
<li>管理画面は <code>127.0.0.1</code> の8090番だけで公開し、外からは直接つながらない</li>

<li>MariaDB の healthcheck が通るまで WordPress を起動しない</li>

<li>記事を書くときだけ起動するので <code>restart: "no"</code>、小さな VPS 向けに <code>mem_limit</code> を付ける</li>

<li><code>wp-content</code>（テーマ・プラグイン・画像）と DB のデータは名前付きボリュームに残す</li>
</ul>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Docker Compose を使うと、複数のコンテナの設定を <code>compose.yaml</code> にまとめ、1つのコマンドで起動・停止できます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>起動は <code>docker compose up -d</code>、コードを変えたら <code>--build</code>、設定を変えたら <code>up -d</code> をもう一度</li>

<li>状態は <code>ps</code>、ログは <code>logs -f</code>、中での作業は <code>exec</code></li>

<li>パスワードは <code>.env</code> に書き、<code>${変数:?}</code> で必須にする</li>

<li>DB には <code>healthcheck</code> を書き、<code>depends_on</code> で <code>service_healthy</code> を待つ</li>

<li>公開するポートは <code>127.0.0.1:</code> に限り、外に出すのは nginx だけにする</li>

<li><code>restart</code> と <code>mem_limit</code> は、常時動かすかどうかとサーバーのメモリで決める</li>
</ul>
</div></div>



<p class="wp-block-paragraph">書き換えたら <code>docker compose config -q</code> で確かめる習慣をつけておくと、起動してから慌てることが減ります。</p>

]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Homebrew】macOSでのインストール方法と使い方を徹底解説</title>
		<link>https://cfxlog.com/homebrew-install/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 08 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[パッケージ管理]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5265</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/homebrew-install-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>このような疑問にお答えします。 macOSでgitやpyenvなどのプログラミング関連のツールをインストールをするとき、以下のコマンドをよく見ると思います。 これはHomebrewというパッケージ管理ソフトのコマンドです [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/homebrew-install-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Homebrewのインストール方法が知りたい</li>



<li>インストール以外の使い方も教えて</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">macOSで<code>git</code>や<code>pyenv</code>などのプログラミング関連のツールをインストールをするとき、以下のコマンドをよく見ると思います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew install</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span></span></code></pre></div>



<p class="wp-block-paragraph">これはHomebrewというパッケージ管理ソフトのコマンドです。</p>



<h2 class="wp-block-heading">Homebrewでできること</h2>



<p class="wp-block-paragraph">Homebrewはターミナルコマンド一つで、次のような操作ができます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>インストール</li>



<li>アンインストール</li>



<li>アップグレード</li>



<li>ダウングレード</li>
</ul>
</div></div>



<p class="wp-block-paragraph">普通のインストールではWebから手動でダウンロードする必要がありますが、それに比べると手軽にパッケージ操作ができてしまうわけです。</p>



<p class="wp-block-paragraph">便利なHomebrewですが、インストールにあたって「<strong>パスを通す</strong>」必要があるのでハードルが高く感じてしまっている方も多いはず。</p>



<p class="wp-block-paragraph">そこで本記事ではHomebrewが初めての方でも迷わず導入できるようにガイドします。</p>



<h2 class="wp-block-heading">Homebrewのインストール方法</h2>



<p class="wp-block-paragraph">Homebrewは、次の2ステップで導入できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Homebrewのインストール</li>



<li>パスを通す</li>
</ul>
</div></div>



<p class="wp-block-paragraph">特に2番目の操作を厚めに解説します。</p>



<p class="wp-block-paragraph">ターミナルで、以下のHomebrewのインストールコマンドを実行しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">/bin/bash</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">curl</span><span style="color: #CE9178"> </span><span style="color: #569CD6">-fsSL</span><span style="color: #CE9178"> https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">コマンドを実行するとHomebrewのインストールが進むので、完了までしばらく待ちましょう。</p>



<div class="wp-block-group is-style-bg_stripe"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<p class="wp-block-paragraph">▼ なお、このコマンドは<a href="https://brew.sh/ja/"><strong>Homebrewの公式ページ</strong></a>からも確認できます。</p>
</div></div>



<p class="wp-block-paragraph">Homebrewはインストールしただけでは<code>brew</code>コマンドが使えません。</p>



<p class="wp-block-paragraph">これはOSがHomebrewをインストールしたフォルダを探しに行っていないためです。</p>



<p class="wp-block-paragraph">そこでOSに対して「Homebrewをインストールしたパスも探しに行ってね！」と指示を出す必要があり、これが「<strong>パスを通す</strong>」と呼ばれる作業になります。</p>



<p class="wp-block-paragraph">パスを通す方法は、インストール完了時のメッセージに記載があります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH:
    (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/karo/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
- Run brew help to get started
- Further documentation:
    https://docs.brew.sh/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">==&gt; </span><span style="color: #CE9178">Next</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">steps:</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">these</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">two</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">commands</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">in</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">your</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">terminal</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Homebrew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">your</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">PATH:</span></span>
<span class="line"><span style="color: #D4D4D4">    (</span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4">; </span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&apos;</span><span style="color: #D4D4D4">) &gt;&gt; </span><span style="color: #DCDCAA">/Users/karo/.zprofile</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">eval</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">/opt/homebrew/bin/brew</span><span style="color: #CE9178"> shellenv)&quot;</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">help</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">get</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">started</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Further</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">documentation:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">https://docs.brew.sh/</span></span></code></pre></div>



<p class="wp-block-paragraph">Run these two commands（2つのコマンドを実行してください）と書いてあるので、ハイライトした部分のコマンドを実行しましょう。</p>


<div class="swell-block-balloon"><div class="c-balloon -bln-left" data-col="gray"><div class="c-balloon__body -speaking -border-none"><div class="c-balloon__text">
<p>必ず<strong>ご自身のターミナルで表示されたもの</strong>を実行してください！<br>ここで示したコマンドは僕のPC画面に表示されたもののため。</p>
<span class="c-balloon__shapes"><span class="c-balloon__before"></span><span class="c-balloon__after"></span></span></div></div></div></div>


<p class="wp-block-paragraph">つまり今回の場合は、次の2行分を実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/karo/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4">; </span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&apos;</span><span style="color: #D4D4D4">) &gt;&gt; /Users/karo/.zprofile</span></span>
<span class="line"><span style="color: #DCDCAA">eval</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">/opt/homebrew/bin/brew</span><span style="color: #CE9178"> shellenv)&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">最後にHomebrewが正常にインストールされたか確認するため、以下のコマンドを実行しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew --version
# Homebrew 4.4.0</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span>
<span class="line"><span style="color: #6A9955"># Homebrew 4.4.0</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のように、バージョンが返ってくればインストールは完了です。</p>



<p class="is-style-icon_announce wp-block-paragraph">バージョンが返ってこない場合には、パスが通っているかを確認します。</p>



<p class="wp-block-paragraph">バージョンが返ってこない時は、パスが通っていないことを疑いましょう。</p>



<p class="wp-block-paragraph">以下のコマンドを実行してみてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>which brew
# /opt/homebrew/bin</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">which</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">brew</span></span>
<span class="line"><span style="color: #6A9955"># /opt/homebrew/bin</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>/opt/homebrew/bin</code>が返ってきたら、もうパスは通っています。</p>



<p class="wp-block-paragraph">そうでなければパスを通すための処理が必要になるので、まずは現在有効になっているシェルを以下のコマンドで調べてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>echo $SHELL </textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">$SHELL</span><span style="color: #D4D4D4"> </span></span></code></pre></div>



<h3 class="wp-block-heading">/bin/zshだった場合</h3>



<p class="wp-block-paragraph">この場合はZshが使われているので、次のコマンドでパスが通ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># Zshの場合
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># Zshの場合</span></span>
<span class="line"><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&apos;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">~/.zprofile</span></span>
<span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.zprofile</span></span></code></pre></div>



<h3 class="wp-block-heading">/bin/bashだった場合</h3>



<p class="wp-block-paragraph">こちらの場合には、Bashが使われているので、以下のコマンドを実行しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># Bashの場合
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile  # Bashの場合
source ~/.bash_profile</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># Bashの場合</span></span>
<span class="line"><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&apos;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">~/.bash_profile</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># Bashの場合</span></span>
<span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.bash_profile</span></span></code></pre></div>



<h3 class="wp-block-heading">最後にパスが通ったか確認</h3>



<p class="wp-block-paragraph">無事にパスが通ったかを、以下のコマンドで確かめましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>which brew</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">which</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">brew</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>/opt/homebrew/bin</code>が返ってくれば無事にインストールは完了です。</p>



<h2 class="wp-block-heading">Homebrewの基本コマンド</h2>



<p class="wp-block-paragraph">ここからはHomebrewで使えるコマンドを解説します。</p>



<p class="wp-block-paragraph">日常的に使うのはインストールコマンドですが、その他にも便利なコマンドが用意されています。</p>



<p class="wp-block-paragraph">新しいパッケージのインストールには、<code>install</code>コマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew install &lt;パッケージ名></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> &lt;</span><span style="color: #CE9178">パッケージ</span><span style="color: #D4D4D4">名&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph">例えばGitをインストールする場合、<code>brew install git</code>となります。</p>



<p class="wp-block-paragraph">過去にHomebrewでインストールしたパッケージを表示するコマンドです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew list</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">list</span></span></code></pre></div>



<p class="wp-block-paragraph">パッケージをアンインストールする場合などは、このコマンドでインストール済みのパッケージを確認してから実行することになります。</p>



<p class="wp-block-paragraph">アンインストールは<code>uninstall</code>コマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew uninstall &lt;パッケージ名></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">uninstall</span><span style="color: #D4D4D4"> &lt;</span><span style="color: #CE9178">パッケージ</span><span style="color: #D4D4D4">名&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph">例えばGitのアンインストールをする場合は<code>brew uninstall git</code>となります。</p>



<p class="wp-block-paragraph">パッケージのバージョンアップをする場合は、<code>upgrade</code>コマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew upgrade</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">upgrade</span></span></code></pre></div>



<p class="wp-block-paragraph">単に<code>brew upgrade</code>とすると、アップグレード可能な全パッケージがアップデートされます。</p>



<p class="wp-block-paragraph">特定のパッケージのみアップデートしたい場合は、<code>brew upgrade git</code>などとします。</p>



<p class="wp-block-paragraph">Homebrew自体をアップデートする場合は、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew update</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">update</span></span></code></pre></div>



<p class="wp-block-paragraph">普段はHomebrew自体のアップデートを意識することはないと思いますので、例えば以下のタイミングで実行すると良いです。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>新しいパッケージをインストールするとき</li>



<li>既存のパッケージをアップデートするとき</li>
</ul>
</div></div>



<p class="wp-block-paragraph">もちろん最新であることに越したことはありませんが、そこまで神経質にならなくても大丈夫だと思います。</p>



<h2 class="wp-block-heading">複数パッケージを一括インストールする方法</h2>



<p class="wp-block-paragraph">macOSを初期化したときなどは、パッケージのインストールが面倒ですよね。</p>



<p class="wp-block-paragraph">必要なパッケージをリスト化しておき、一気にインストールする方法をご紹介します。</p>


<div class="swell-block-balloon"><div class="c-balloon -bln-left" data-col="green"><div class="c-balloon__icon -square"><img decoding="async" src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" data-src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="lazyload c-balloon__iconImg" width="80px" height="80px"><noscript><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="c-balloon__iconImg" width="80px" height="80px"></noscript><span class="c-balloon__iconName">CFXLOG</span></div><div class="c-balloon__body -speaking -border-none"><div class="c-balloon__text">
<p>シェルスクリプトを使います！</p>
<span class="c-balloon__shapes"><span class="c-balloon__before"></span><span class="c-balloon__after"></span></span></div></div></div></div>


<p class="wp-block-paragraph">シェルスクリプトの作成から実行までの流れを解説します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<div class="swell-block-step" data-num-style="circle">
<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><div class="swell-block-step__title u-fz-l">シェルスクリプトを作成する</div><div class="swell-block-step__body">
<p class="wp-block-paragraph">以下のコマンドを実行して、スクリプトファイルを作成します。</p>



<p class="wp-block-paragraph"><code>touch</code>コマンドは、空のファイルを生成するコマンドです。</p>
</div></div>



<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><div class="swell-block-step__title u-fz-l">ファイルに実行権限を付与する</div><div class="swell-block-step__body">
<p class="wp-block-paragraph">スクリプトとして実行できるよう、権限を付与します。</p>



<p class="wp-block-paragraph">ちなみに<code>+x</code>の部分が実行権限の付与を意味しています。</p>
</div></div>



<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><div class="swell-block-step__title u-fz-l">スクリプトの中身を記述する</div><div class="swell-block-step__body">
<p class="wp-block-paragraph"><code>install_packages.sh</code>を開いて、以下のコードを書き込みます。</p>



<p class="wp-block-paragraph">ハイライトした部分からもわかるように、上記のスクリプトではgit, python, node, wgetをインストールしました。</p>



<p class="wp-block-paragraph">このリストをいじることで、インストールするパッケージを変更できます。</p>
</div></div>



<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><div class="swell-block-step__title u-fz-l">シェルスクリプトを実行する</div><div class="swell-block-step__body">
<p class="wp-block-paragraph">最後に以下のコマンドでスクリプトを実行します。</p>



<p class="wp-block-paragraph">これでbrew installした場合と同様の挙動になります。</p>



<p class="wp-block-paragraph">複数パッケージをまとめてインストールできて、とても便利です。</p>
</div></div>
</div>
</div></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Homebrewはパッケージをインストールしたり、アップデートしたりできる管理ツールでした。</p>



<p class="wp-block-paragraph">導入にあたってはインストールコマンドの実行のほかに、<strong>パスを通す必要があります</strong>。</p>



<p class="wp-block-paragraph">手順は本記事のこちらのセクションを見ながらセットアップを進めてみてください。</p>



<p class="wp-block-paragraph">余談ですがHomebrewを使ってVisual Studio Codeのインストールもできますので、これからVSCodeをインストールする方はぜひお試しください。</p>



<p class="wp-block-paragraph">手順は以下の記事で解説しました。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1-300x158.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/mac-vscode-setup/">Mac版VSCodeのインストール方法｜brew・公式サイト対応</a>
						<span class="p-blogCard__excerpt">Visual Studio Code（以下「VSCode」）のインストール方法を知りたい人向けの記事です。 本記事ではVSCodeをインストールする２つの方法をご紹介します。 基本的には一&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Mac版VSCodeのインストール方法｜brew・公式サイト対応</title>
		<link>https://cfxlog.com/mac-vscode-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 11 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Mac]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5002</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1.png" class="webfeedsFeaturedVisual" /></p>Visual Studio Code（以下「VSCode」）のインストール方法を知りたい人向けの記事です。 本記事ではVSCodeをインストールする２つの方法をご紹介します。 基本的には一つ目の「公式サイトからダウンロー [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1.png" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Visual Studio Code（以下「VSCode」）のインストール方法を知りたい人向けの記事です。</p>



<p class="wp-block-paragraph">本記事ではVSCodeをインストールする２つの方法をご紹介します。</p>



<p class="wp-block-paragraph">基本的には一つ目の「公式サイトからダウンロードする方法」が推奨です。</p>



<p class="wp-block-paragraph">一方で、普段からターミナルよく使う方は「Homebrew を使った方法」をおすすめします。（慣れてる方からしたら、こちらの方が簡単なため）</p>



<p class="wp-block-paragraph">以下が目次になっているので、お好きな方をクリックして進んでください。</p>


<div class="swell-block-balloon"><div class="c-balloon -bln-left" data-col="green"><div class="c-balloon__icon -square"><img decoding="async" src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" data-src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="lazyload c-balloon__iconImg" width="80px" height="80px"><noscript><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="c-balloon__iconImg" width="80px" height="80px"></noscript><span class="c-balloon__iconName">CFXLOG</span></div><div class="c-balloon__body -speaking -border-none"><div class="c-balloon__text">
<p>最後におすすめの拡張機能も紹介します。</p>
<span class="c-balloon__shapes"><span class="c-balloon__before"></span><span class="c-balloon__after"></span></span></div></div></div></div>


<h2 class="wp-block-heading">方法1: 公式サイトからダウンロードする方法</h2>



<p class="wp-block-paragraph">アプリを公式サイトからダウンロードしてきて、インストールする方法です。</p>



<p class="wp-block-paragraph">ターミナル操作に不安がある方は、この方法をお試しください。</p>



<h3 class="wp-block-heading">VSCodeのダウンロード</h3>



<p class="wp-block-paragraph">以下の公式ページにアクセスします。</p>



<p class="wp-block-paragraph"><a href="https://code.visualstudio.com/">» 参考：Visual Studio Code &#8211; Code Editing. Redefined</a></p>



<p class="wp-block-paragraph">時期によって多少は画面が違うかもしれませんが、下のような画面が表示されるはずです。</p>



<figure class="wp-block-image size-full"><img decoding="async" width="1024" height="516" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1-1.jpg" alt="" class="wp-image-5015" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1-1.jpg 1024w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1-1-300x151.jpg 300w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-1-1-768x387.jpg 768w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">「Download for macOS」という青いボタンをクリックしましょう。</p>



<p class="wp-block-paragraph">しばらくするとDownloadフォルダにzipファイルが表示されるので、ダブルクリックして解凍します。</p>



<p class="wp-block-paragraph">アイコン付きのものが、VSCode本体です。</p>



<p class="wp-block-paragraph">これを<strong>アプリケーションフォルダにドラッグ&amp;ドロップで移動</strong>させましょう。</p>



<figure class="wp-block-image size-full"><img decoding="async" width="942" height="451" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-2-1.png" alt="" class="wp-image-5016" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-2-1.png 942w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-2-1-300x144.png 300w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-2-1-768x368.png 768w" sizes="(max-width: 942px) 100vw, 942px" /></figure>



<p class="wp-block-paragraph">これでインストールは完了です。</p>



<h3 class="wp-block-heading" id="spotlight">VSCodeの起動方法</h3>



<p class="wp-block-paragraph">「コマンド（⌘） + スペース」を同時押しして、Spotlight を起動しましょう。</p>



<p class="wp-block-paragraph">そこに<code>visual</code>と入力すると、Visual Studio Codeが表示されます。</p>



<figure class="wp-block-image size-full is-resized"><img decoding="async" width="625" height="272" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-3-1.png" alt="" class="wp-image-5017" style="width:750px;height:auto" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-3-1.png 625w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-3-1-300x131.png 300w" sizes="(max-width: 625px) 100vw, 625px" /></figure>



<p class="wp-block-paragraph">これを選んでEnterキーを押せば、VSCodeが立ち上がります。</p>



<h2 class="wp-block-heading">方法2: Homebrew を使った方法</h2>



<p class="wp-block-paragraph">コマンド実行でVSCodeをインストールすることも可能です。</p>



<p class="wp-block-paragraph">ダウンロードする方法に比べて楽に導入できるので、ターミナル操作に抵抗がない方はこちらがおすすめ。</p>



<h3 class="wp-block-heading">Homebrewをインストールする</h3>



<p class="wp-block-paragraph">最初にHomebrewがインストールされているか確認するため、次のコマンドを実行してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>~ % brew -v
zsh: command not found: brew</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">~ % brew -v</span></span>
<span class="line"><span style="color: #DCDCAA">zsh:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">command</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">not</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">found:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">brew</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>command not found: brew</code>と表示された場合は、Homebrewがまだ入っていません。</p>



<p class="is-style-bg_stripe wp-block-paragraph">※ バージョンが返ってきた方はインストールの必要がないため、<a href="#install-homebrew"><strong>こちら</strong></a>にお進みください。</p>



<p class="wp-block-paragraph">以下のコマンドでHomebrewをインストールしましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">/bin/bash</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">curl</span><span style="color: #CE9178"> </span><span style="color: #569CD6">-fsSL</span><span style="color: #CE9178"> https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">しばらくすると、次のようなメッセージが表示されるはずです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>==&gt; Next steps:
- Run these commands in your terminal to add Homebrew to your PATH:
    echo &gt;&gt; /Users/****/.zprofile
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' &gt;&gt; /Users/****/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
- Run brew help to get started
- Further documentation:
    https://docs.brew.sh/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">==&gt; </span><span style="color: #CE9178">Next</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">steps:</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">these</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">commands</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">in</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">your</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">terminal</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Homebrew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">your</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">PATH:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">/Users/</span><span style="color: #569CD6">****</span><span style="color: #CE9178">/.zprofile</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&#039;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&#039;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">/Users/</span><span style="color: #569CD6">****</span><span style="color: #CE9178">/.zprofile</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">eval</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">/opt/homebrew/bin/brew</span><span style="color: #CE9178"> shellenv)&quot;</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">help</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">to</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">get</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">started</span></span>
<span class="line"><span style="color: #DCDCAA">-</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Further</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">documentation:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">https://docs.brew.sh/</span></span></code></pre></div>



<p class="wp-block-paragraph">つまり、Homebrewを正しく動作させるためにコマンドの実行を求めています。</p>



<p class="wp-block-paragraph">指示にある通り、ターミナルで次のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>echo &gt;&gt; /Users/****/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' &gt;&gt; /Users/****/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">/Users/</span><span style="color: #569CD6">****</span><span style="color: #CE9178">/.zprofile</span></span>
<span class="line"><span style="color: #DCDCAA">echo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&#039;eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;&#039;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">/Users/</span><span style="color: #569CD6">****</span><span style="color: #CE9178">/.zprofile</span></span>
<span class="line"><span style="color: #DCDCAA">eval</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$(</span><span style="color: #DCDCAA">/opt/homebrew/bin/brew</span><span style="color: #CE9178"> shellenv)&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">※ 上記はユーザー名を差し替えているので、必ずターミナル上に表示されたコマンドをコピペして実行してください。</p>



<p class="wp-block-paragraph">最後に次のコマンドを実行して、バージョンが戻ってくれば成功です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>~ % brew -v      
# Homebrew 4.4.0</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">~ % brew -v      </span></span>
<span class="line"><span style="color: #6A9955"># Homebrew 4.4.0</span></span></code></pre></div>



<h3 class="wp-block-heading" id="install-homebrew">VSCodeのインストール</h3>



<p class="wp-block-paragraph">あとは次のコマンドを実行するだけです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>brew install --cask visual-studio-code</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">brew</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--cask</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">visual-studio-code</span></span></code></pre></div>



<p class="wp-block-paragraph">コマンド実行後、successfully installed! と表示されるまで待ちましょう。</p>



<figure class="wp-block-image size-full"><img decoding="async" width="1024" height="538" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-4-1.jpg" alt="" class="wp-image-5018" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-4-1.jpg 1024w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-4-1-300x158.jpg 300w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-4-1-768x404.jpg 768w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">公式サイトからのダウンロードに比べて、格段にラクです。</p>



<h3 class="wp-block-heading">VSCodeの起動方法</h3>



<p class="wp-block-paragraph">起動方法は、ターミナルで以下のコマンドを実行するだけです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>code</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">code</span></span></code></pre></div>



<p class="wp-block-paragraph">特定のフォルダを開きたい場合は、引数として開きたい階層のパスを指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>code .</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">code</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.</span></span></code></pre></div>



<p class="wp-block-paragraph">上記の場合は引数を<code>.</code>にしたので、カレントディレクトリを開きます。</p>


<div class="swell-block-balloon"><div class="c-balloon -bln-left" data-col="green"><div class="c-balloon__icon -square"><img decoding="async" src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" data-src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="lazyload c-balloon__iconImg" width="80px" height="80px"><noscript><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/01-150x150-2.jpg" alt="" class="c-balloon__iconImg" width="80px" height="80px"></noscript><span class="c-balloon__iconName">CFXLOG</span></div><div class="c-balloon__body -speaking -border-none"><div class="c-balloon__text">
<p>もちろん上で紹介したような<a href="#spotlight"><strong>通常の起動方法</strong></a>でも可能です！</p>
<span class="c-balloon__shapes"><span class="c-balloon__before"></span><span class="c-balloon__after"></span></span></div></div></div></div>


<h2 class="wp-block-heading">最初に入れるべき拡張機能２選</h2>



<p class="wp-block-paragraph">最近のVSCodeはデフォルト機能がかなり充実しているので、必要な拡張機能はそう多くありません。</p>



<p class="wp-block-paragraph">ここではVSCodeインストールと同時に導入したい拡張機能をご紹介します。</p>



<p class="is-style-icon_announce wp-block-paragraph">インストールには、各拡張機能の最後に設置したリンクをクリックしてください。<br>ページ内の緑色のInstallボタンを押すとVSCodeで拡張機能が開くので、そこでInstallボタンを押します。</p>



<h3 class="wp-block-heading">Japanese Language Pack for Visual Studio Code</h3>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="936" height="263" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-5-2.png" alt="" class="wp-image-5019" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-5-2.png 936w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-5-2-300x84.png 300w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-5-2-768x216.png 768w" sizes="(max-width: 936px) 100vw, 936px" /></figure>



<p class="wp-block-paragraph">VSCodeはデフォルトで英語です。</p>



<p class="wp-block-paragraph">日本語化したい場合には、この拡張機能を入れましょう。</p>



<p class="wp-block-paragraph">microsoftが公式に提供しているので安心して使えます。</p>



<p class="is-style-bg_stripe wp-block-paragraph"><a href="https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-ja"><strong>» インストールはこちら：Japanese Language Pack for Visual Studio Code</strong></a></p>



<h3 class="wp-block-heading">Rainbow CSV</h3>



<figure class="wp-block-image size-full is-style-border"><img decoding="async" width="925" height="263" src="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-6-1.png" alt="" class="wp-image-5020" srcset="https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-6-1.png 925w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-6-1-300x85.png 300w, https://cfxlog.com/wp-content/uploads/2026/03/mac-vscode-setup-6-1-768x218.png 768w" sizes="(max-width: 925px) 100vw, 925px" /></figure>



<p class="wp-block-paragraph">CSVを列ごとに色分けしてくれます。</p>



<p class="wp-block-paragraph">VSCodeではCSVを表示するときに、Excelのように表形式になりません。</p>



<p class="wp-block-paragraph">生のCSVを編集するときなど、どの列を編集しているか分かりやすくなるので便利です。</p>



<p class="is-style-bg_stripe wp-block-paragraph"><a href="https://marketplace.visualstudio.com/items?itemName=mechatroner.rainbow-csv"><strong>» インストールはこちら：Rainbow CSV</strong></a></p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">VSCodeのインストール方法をご紹介しました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>公式サイトからダウンロードする方法</li>



<li>Homebrewを使ってインストールする方法</li>
</ul>
</div></div>



<p class="wp-block-paragraph">どちらを選んでも結果は同じなので、お好みの方を選んでください。</p>



<p class="wp-block-paragraph"></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【uv使い方から仮想環境の削除まで】Pythonパッケージ管理の完全ガイド</title>
		<link>https://cfxlog.com/python-uv-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 05 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[パッケージ管理]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4757</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-uv-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>最近では、pip の代わりに uv を導入する Python プロジェクトが急増しています。 たしかに pip は役割がシンプルで使い方も単純明快です。 でも仮想環境の構築には他のツールが必要だったり、依存関係の解決は開 [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-uv-guide-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>uv ってどんなもの？</li>



<li>インストール方法が知りたい</li>



<li>使い方を詳しく教えて欲しい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">最近では、pip の代わりに <strong>uv</strong> を導入する Python プロジェクトが急増しています。</p>



<p class="wp-block-paragraph">たしかに pip は役割がシンプルで使い方も単純明快です。</p>



<p class="wp-block-paragraph">でも仮想環境の構築には他のツールが必要だったり、依存関係の解決は開発者自身で行う必要がありました。</p>



<p class="wp-block-paragraph">一方の uv、誤解を恐れずに表現するなら以下のような感じです。</p>



<p class="is-style-bg_stripe wp-block-paragraph"><strong>pip + virtualenv + requirements.txt</strong></p>



<p class="wp-block-paragraph">これだけではなく「依存関係の自動調整」「超高速なパッケージ解決」まで担ってくれます。</p>



<p class="wp-block-paragraph">Rust 製ということもあり、pip に比べて <strong>10〜100倍以上高速</strong> なのが最大の強みです。</p>



<p class="wp-block-paragraph">使い始めると超便利なものの、まだ日本語情報が少ないのも事実です。</p>



<p class="wp-block-paragraph">そこで、本記事は以下の内容をお伝えします。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>uv ってどんなもの？</li>



<li>インストール方法と使い方</li>



<li>pyproject.toml ファイルの書き方</li>
</ul>
</div></div>



<p class="wp-block-paragraph">最初こそ pip との違いに戸惑いますが、いざ使ってみると pip には戻れないほどに便利なツールです。</p>



<p class="wp-block-paragraph">本記事で uv の基本的な使い方をマスターしていきましょう！</p>



<p class="wp-block-paragraph">この記事では、僕が手元で実際に動かしたコマンドと出力も載せています。後半では、requirements.txt や Poetry からの移行方法と、<code>uvx</code> でツールを動かす方法も紹介します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>この記事で動かした環境（2026年11月18日）</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>macOS 27.2（Apple シリコン）</li>

<li>uv 0.13.6</li>

<li>Python 3.12.16（uv が管理しているもの）</li>

<li>例で追加したパッケージ：openpyxl 3.1.5、ruff 0.17.5</li>

<li>実行例は <code>uv init --no-package hello</code> で作った <code>hello</code> プロジェクトで動かしています（作り方は「プロジェクトのセットアップ」で紹介）</li>
</ul>
</div></div>



<p class="wp-block-paragraph">出力の中のフォルダの場所は <code>/path/to/</code> に置き換えています。uv はバージョンによって出力や既定の動きが変わることがあるので、手元の <code>uv --version</code> とあわせて読んでください。</p>



<h2 class="wp-block-heading">uv ってどんなもの？</h2>



<p class="wp-block-paragraph">まずは、uv の概要を解説します。</p>



<p class="wp-block-paragraph">多機能なのでどんな役割があるのかを理解するのが先決です。</p>



<p class="wp-block-paragraph">また、この段階で uv が管理する２つのファイルを知っておきましょう。</p>



<h3 class="wp-block-heading">そもそも、uv って何？</h3>



<p class="wp-block-paragraph">uv は以下の機能を提供します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>パッケージの管理</li>



<li>仮想環境の管理</li>



<li>Python バージョンの管理（pyenv 相当）</li>



<li>依存関係・互換性の調整（高速版）</li>
</ol>
</div></div>



<p class="wp-block-paragraph">一方で、pip は「パッケージのインストール」に特化したツールです。</p>



<p class="wp-block-paragraph">通常は pip 単体で使うことはまれで、仮想環境を構築するためには別コマンドを使ったり、依存関係の管理を行うために requirements.txt を併用する必要があります。</p>



<p class="wp-block-paragraph"><strong>uv は pyenv + pip + virtualenv + requirements.txt を一本化したツール</strong> とも言えます。<br>しかも Rust 製なので動作が圧倒的に速い。</p>



<p class="wp-block-paragraph">これまでのやり方と uv のコマンドを対応させると、次のようになります。</p>



<figure class="wp-block-table"><table><thead><tr><th>やりたいこと</th><th>これまで</th><th>uv</th></tr></thead><tbody><tr><td>仮想環境を作る</td><td><code>python -m venv .venv</code></td><td><code>uv venv</code>（プロジェクトでは自動）</td></tr><tr><td>パッケージを入れる</td><td><code>pip install openpyxl</code></td><td><code>uv add openpyxl</code></td></tr><tr><td>依存を書き出す</td><td><code>pip freeze &gt; requirements.txt</code></td><td>uv.lock に自動で記録</td></tr><tr><td>環境をそろえる</td><td><code>pip install -r requirements.txt</code></td><td><code>uv sync</code></td></tr><tr><td>Python のバージョンを切り替える</td><td>pyenv など</td><td><code>uv python pin</code></td></tr><tr><td>ツールを一時的に動かす</td><td>pipx など</td><td><code>uvx</code></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Poetry と同じく <code>pyproject.toml</code> に依存を書き、ロックファイル（<code>uv.lock</code>）で版をそろえる考え方です。Poetry の使い方は<a href="https://cfxlog.com/python-poetry-guide/">こちらの記事</a>にまとめています。</p>



<p class="wp-block-paragraph">ここからは uv のメリットを少し掘り下げて解説します。</p>



<h4 class="wp-block-heading">パッケージの管理</h4>



<p class="wp-block-paragraph">pip と同様にパッケージ管理が行えます。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>処理内容</th><th>pip</th><th>uv</th></tr></thead><tbody><tr><td>追加</td><td><code>pip install</code></td><td><code>uv add</code></td></tr><tr><td>削除</td><td><code>pip uninstall</code></td><td><code>uv remove</code></td></tr><tr><td>更新</td><td><code>pip install --upgrade</code></td><td><code>uv lock --upgrade</code></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">これだけ見ると pip との差はないようにも思えます。</p>



<p class="wp-block-paragraph">ところが、次から説明する「仮想環境の管理」と「依存関係・互換性の調整」という機能を知ると、uv を使うメリットが分かっていただけると思います。</p>



<h4 class="wp-block-heading">仮想環境の管理</h4>



<p class="wp-block-paragraph">uv を使うと、そのプロジェクト固有の仮想環境が自動的に構築されます。</p>



<p class="wp-block-paragraph"><code>uv sync</code> や <code>uv add</code> を実行するだけで、プロジェクトルートに <code>.venv</code> が自動生成されます。</p>



<p class="wp-block-paragraph">これにより異なるプロジェクト間でライブラリのバージョンの衝突をさけ、環境を隔離して安全に作業できるようになります。</p>



<h4 class="wp-block-heading">Python バージョンの管理</h4>



<p class="wp-block-paragraph">uv は <strong>Python のインストールと切り替えも内蔵</strong> しています。</p>



<p class="wp-block-paragraph">従来は pyenv を別途インストールする必要がありましたが、uv だけで完結します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python install 3.11
uv python pin 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pin</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<h4 class="wp-block-heading">依存関係・互換性の調整</h4>



<p class="wp-block-paragraph">一般的なプロジェクトでは、複数のパッケージを利用することがほとんどだと思います。</p>



<p class="wp-block-paragraph">そこで問題になるのが、<strong>依存関係・互換性の問題</strong>です。</p>



<p class="wp-block-paragraph">異なるパッケージが、ある特定のパッケージの別バージョンを求めることがあります。</p>



<p class="wp-block-paragraph">例えば pandas と scikit-learn はともに NumPy が必要です。<br>pandas が NumPy の 1.19 以降を要求している一方で、scikit-learn は NumPy の 1.18 以降を要求しているとします。</p>



<p class="wp-block-paragraph">この場合には NumPy の 1.19 以降をインストールしないといけません。</p>



<p class="wp-block-paragraph">pip の場合は開発者が requirements.txt の中身を目視で確認して、各パッケージのインストールすべきバージョンを決めていくという作業が必要でした。</p>



<p class="wp-block-paragraph">uv を導入するだけで、これまで人間が目視で行っていた依存関係の調整を自動化できます。<br>しかも従来のツールより大幅に高速です。</p>



<h3 class="wp-block-heading">uv が管理する２つのファイル</h3>



<p class="wp-block-paragraph">uv では、以下の２つのファイルが生成されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>pyproject.toml</strong></li>



<li><strong>uv.lock</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">この２つの組み合わせで、requirements.txt の役割を果たします。</p>



<h4 class="wp-block-heading">pyproject.toml</h4>



<p class="wp-block-paragraph"><code>uv add</code> コマンドでパッケージを追加すると、pyproject.toml ファイルが更新されます。</p>



<p class="wp-block-paragraph">このファイルでは、プロジェクトの依存パッケージとそのバージョンの「範囲」を定義します。</p>



<p class="wp-block-paragraph">pyproject.toml はパッケージを「インストール」するわけではなく、あくまで依存関係を「宣言」するだけです。</p>



<h4 class="wp-block-heading">uv.lock</h4>



<p class="wp-block-paragraph">パッケージの依存関係を解決し、具体的なバージョンを固定するために、uv.lock ファイルが使用されます。</p>



<p class="wp-block-paragraph">pyproject.toml に基づいて依存関係の解決が行われた後（例えば <code>uv sync</code> コマンド実行時に）、uv はこの解決結果を uv.lock に記録します。</p>



<p class="wp-block-paragraph">これにより、インストールされるパッケージのバージョンが確定されます。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph"><strong>Poetry との違い</strong><br>Poetry の <code>poetry.lock</code> に相当するのが <code>uv.lock</code> です。<br>形式は異なりますが役割は同じです。</p>
</blockquote>



<p class="wp-block-paragraph"><code>uv add</code> すると、<code>uv.lock</code> に実際に入れたバージョンと、ダウンロード元・ハッシュが記録されます。僕の環境では、先頭はこのようになっていました（長い行は省略しています）。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>version = 1
revision = 5
requires-python = ">=3.12"

[[package]]
name = "et-xmlfile"
version = "2.0.0"
source = { registry = "https://pypi.org/simple" }

[[package]]
name = "hello"
version = "0.1.0"
source = { virtual = "." }
dependencies = [
    { name = "openpyxl" },
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">1</span></span>
<span class="line"><span style="color: #9CDCFE">revision</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">5</span></span>
<span class="line"><span style="color: #9CDCFE">requires-python</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&gt;=3.12&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[[package]]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;et-xmlfile&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;2.0.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">source</span><span style="color: #D4D4D4"> = { </span><span style="color: #9CDCFE">registry</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;https://pypi.org/simple&quot;</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[[package]]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;hello&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;0.1.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">source</span><span style="color: #D4D4D4"> = { </span><span style="color: #9CDCFE">virtual</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;.&quot;</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    { </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;openpyxl&quot;</span><span style="color: #D4D4D4"> },</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>uv.lock</code> は手で編集せず、Git に入れて共有します。</p>



<h2 class="wp-block-heading">uv のインストール方法</h2>



<p class="wp-block-paragraph">uv の大きなメリットのひとつが、<strong>pyenv が不要</strong>な点です。uv 自体が Python バージョン管理機能を内蔵しているため、インストール手順がシンプルになります。</p>



<h3 class="wp-block-heading">uv のインストール</h3>



<p class="wp-block-paragraph">以下のコマンドを実行するだけでインストールできます。</p>



<p class="wp-block-paragraph"><strong>macOS / Linux の場合</strong></p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>curl -LsSf https://astral.sh/uv/install.sh | sh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">curl</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-LsSf</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">https://astral.sh/uv/install.sh</span><span style="color: #D4D4D4"> | </span><span style="color: #DCDCAA">sh</span></span></code></pre></div>



<p class="wp-block-paragraph"><strong>Windows の場合</strong></p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">powershell</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-ExecutionPolicy</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ByPass</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;irm https://astral.sh/uv/install.ps1 | iex&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">インストール後、シェルを再起動するか以下を実行してパスを反映します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>source ~/.zshrc  # zsh の場合
source ~/.bashrc  # bash の場合</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.zshrc</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># zsh の場合</span></span>
<span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~/.bashrc</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># bash の場合</span></span></code></pre></div>



<p class="wp-block-paragraph">インストールの確認は以下のコマンドで行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>uv 0.x.x</code> のようなバージョンが返ってくれば完了です。</p>



<p class="wp-block-paragraph">僕の環境では、次のように表示されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv 0.13.6 (329bf9448 2026-10-26 aarch64-apple-darwin)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">uv 0.13.6 (329bf9448 2026-10-26 aarch64-apple-darwin)</span></span></code></pre></div>



<p class="wp-block-paragraph">インストール後に新しいターミナルを開くと、<code>uv</code> と <code>uvx</code> の2つのコマンドが使えるようになります。</p>



<h3 class="wp-block-heading">Python のインストール（uv で完結）</h3>



<p class="wp-block-paragraph">uv を使って Python をインストールします。pyenv は不要です。</p>



<p class="wp-block-paragraph">インストールできる Python のバージョン一覧を確認します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python list</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">list</span></span></code></pre></div>



<p class="wp-block-paragraph">手元にある Python だけを見るときは、<code>--only-installed</code> を付けます。僕の Mac では次のように表示されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python list --only-installed</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">list</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--only-installed</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cpython-3.15.2-macos-aarch64-none     /opt/homebrew/bin/python3.15 -> ../Cellar/python@3.15/3.15.2/bin/python3.15
cpython-3.12.16-macos-aarch64-none    /opt/homebrew/bin/python3.12 -> ../Cellar/python@3.12/3.12.16/bin/python3.12
cpython-3.12.16-macos-aarch64-none    ~/.local/share/uv/python/cpython-3.12-macos-aarch64-none/bin/python3.12
cpython-3.9.6-macos-aarch64-none      /usr/bin/python3
（一部省略）</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">cpython-3.15.2-macos-aarch64-none     /opt/homebrew/bin/python3.15 -&gt; ../Cellar/python@3.15/3.15.2/bin/python3.15</span></span>
<span class="line"><span style="color: #D4D4D4">cpython-3.12.16-macos-aarch64-none    /opt/homebrew/bin/python3.12 -&gt; ../Cellar/python@3.12/3.12.16/bin/python3.12</span></span>
<span class="line"><span style="color: #D4D4D4">cpython-3.12.16-macos-aarch64-none    ~/.local/share/uv/python/cpython-3.12-macos-aarch64-none/bin/python3.12</span></span>
<span class="line"><span style="color: #D4D4D4">cpython-3.9.6-macos-aarch64-none      /usr/bin/python3</span></span>
<span class="line"><span style="color: #D4D4D4">（一部省略）</span></span></code></pre></div>



<p class="wp-block-paragraph">uv が入れた Python だけでなく、Homebrew や macOS に元から入っている Python も見つけて表示されます。</p>



<p class="wp-block-paragraph">インストールしたいバージョンが決まったら以下を実行します。<br>ここでは <code>3.11</code> をインストールしてみます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python install 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<p class="wp-block-paragraph">プロジェクトで使う Python のバージョンを固定する場合は、以下のコマンドを実行します（全体に効かせるなら <code>--global</code> を付けます）。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python pin 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pin</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<h2 class="wp-block-heading">uv の使い方：パッケージ管理編</h2>



<h3 class="wp-block-heading">ライブラリのインストール</h3>



<p class="wp-block-paragraph">ライブラリのインストールは、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add パッケージ名</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">パッケージ名</span></span></code></pre></div>



<p class="wp-block-paragraph">上記を実行すると、pyproject.toml にインストールしたライブラリ名とバージョンが追記され、uv.lock も自動更新されます。</p>



<p class="wp-block-paragraph">たとえば openpyxl を追加すると、次のように表示されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add openpyxl</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">openpyxl</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 3 packages in 5ms
Installed 2 packages in 4ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 3 packages in 5ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 2 packages in 4ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph">openpyxl が必要とする et-xmlfile も一緒に入りました。<code>pyproject.toml</code> の <code>dependencies</code> には、入れたバージョン以上という条件で追記されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>dependencies = [
    "openpyxl>=3.1.5",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;openpyxl&gt;=3.1.5&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">pip だと <code>pip freeze</code> が必要でした。<br>uv ならパッケージ追加時に pyproject.toml への追記を自動で行なってくれるので、管理がとても楽です。</p>



<h3 class="wp-block-heading">開発中だけ使うライブラリのインストール</h3>



<p class="wp-block-paragraph">本番環境では使わないパッケージは、<code>--dev</code> オプションをつけると便利です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add パッケージ名 --dev</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">パッケージ名</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--dev</span></span></code></pre></div>



<p class="wp-block-paragraph">こうしておくと、pyproject.toml の <code>[dependency-groups]</code> セクションに開発中のみ使うパッケージとして記録されます。</p>



<p class="wp-block-paragraph">フォーマッターの ruff を開発用として追加してみます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add --dev ruff</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--dev</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 4 packages in 2ms
Installed 1 package in 4ms
 + ruff==0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 2ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 1 package in 4ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + ruff==0.17.5</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[dependency-groups]
dev = [
    "ruff>=0.17.5",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[dependency-groups]</span></span>
<span class="line"><span style="color: #9CDCFE">dev</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;ruff&gt;=0.17.5&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">本番環境のインストール時には、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync --no-dev</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-dev</span></span></code></pre></div>



<p class="wp-block-paragraph">これで <code>--dev</code> オプションをつけたパッケージはインストールされません。</p>



<p class="wp-block-paragraph">ruff が入っている環境で <code>uv sync --no-dev</code> を実行すると、入っていた ruff が外されました。もう一度 <code>uv sync</code> すると ruff が戻ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 4 packages in 0.97ms
Uninstalled 1 package in 2ms
 - ruff==0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 0.97ms</span></span>
<span class="line"><span style="color: #D4D4D4">Uninstalled 1 package in 2ms</span></span>
<span class="line"><span style="color: #D4D4D4"> - ruff==0.17.5</span></span></code></pre></div>



<h3 class="wp-block-heading">バージョンの範囲を指定する</h3>



<p class="wp-block-paragraph">範囲を指定したいときは、引用符で囲んで書きます。囲まないと、シェルが <code>&lt;</code> をリダイレクトと解釈してしまいます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add "openpyxl>=3.1,&lt;4"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;openpyxl&gt;=3.1,&lt;4&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">すでに入っているパッケージなら、<code>pyproject.toml</code> の条件だけが書き換わります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>dependencies = [
    "openpyxl>=3.1,&lt;4",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;openpyxl&gt;=3.1,&lt;4&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<h3 class="wp-block-heading">入っているパッケージを木の形で見る（uv tree）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv tree</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">tree</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 4 packages in 0.95ms
hello v0.1.0
├── openpyxl v3.1.5
│   └── et-xmlfile v2.0.0
└── ruff v0.17.5 (group: dev)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 0.95ms</span></span>
<span class="line"><span style="color: #D4D4D4">hello v0.1.0</span></span>
<span class="line"><span style="color: #D4D4D4">├── openpyxl v3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4">│   └── et-xmlfile v2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4">└── ruff v0.17.5 (group: dev)</span></span></code></pre></div>



<p class="wp-block-paragraph">どのパッケージが何のために入っているかが一目で分かります。</p>



<h3 class="wp-block-heading">プロジェクトをクローンした場合のライブラリインストール</h3>



<p class="wp-block-paragraph">プロジェクトをクローンした直後にはパッケージが何も入っていないので、以下のコマンドでパッケージを一括インストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span></span></code></pre></div>



<p class="wp-block-paragraph">本番環境で、開発時のみに利用するパッケージをインストール対象から除外したい場合は、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync --no-dev</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-dev</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>pip install -r requirements.txt</code> と同じような挙動になります。</p>



<p class="wp-block-paragraph">試しに <code>.venv</code> を消してから <code>uv sync</code> を実行しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>rm -rf .venv
uv sync</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">rm</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-rf</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
Resolved 4 packages in 1ms
Installed 3 packages in 5ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5
 + ruff==0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 1ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 3 packages in 5ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4"> + ruff==0.17.5</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>uv.lock</code> どおりのバージョンで、開発用の ruff も含めて入り直しました。もう一度実行すると、確認だけで終わります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 4 packages in 0.90ms
Checked 3 packages in 0.63ms</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 0.90ms</span></span>
<span class="line"><span style="color: #D4D4D4">Checked 3 packages in 0.63ms</span></span></code></pre></div>



<h3 class="wp-block-heading">uv.lock とずれていないか確かめる（&#8211;locked・&#8211;frozen）</h3>



<p class="wp-block-paragraph"><code>pyproject.toml</code> を手で書き換えて、<code>uv.lock</code> とずれた状態を作って試しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv lock --check
uv sync --locked</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">lock</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--check</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--locked</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>error: The lockfile at `uv.lock` needs to be updated, but `--check` was provided.

hint: To update the lockfile, run `uv lock`.
error: The lockfile at `uv.lock` needs to be updated, but `--locked` was provided.

hint: To update the lockfile, run `uv lock`.</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">error: The lockfile at `uv.lock` needs to be updated, but `--check` was provided.</span></span>
<span class="line"><span style="color: #D4D4D4"></span></span>
<span class="line"><span style="color: #D4D4D4">hint: To update the lockfile, run `uv lock`.</span></span>
<span class="line"><span style="color: #D4D4D4">error: The lockfile at `uv.lock` needs to be updated, but `--locked` was provided.</span></span>
<span class="line"><span style="color: #D4D4D4"></span></span>
<span class="line"><span style="color: #D4D4D4">hint: To update the lockfile, run `uv lock`.</span></span></code></pre></div>



<p class="wp-block-paragraph">一方、オプションなしの <code>uv sync</code> は、ずれを見つけると <code>uv.lock</code> を自動で更新してから環境をそろえました。そのあとの <code>uv lock --check</code> はエラーになりませんでした。</p>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>uv.lock がずれているとき</th></tr></thead><tbody><tr><td><code>uv sync</code></td><td>uv.lock を更新してからそろえる</td></tr><tr><td><code>uv sync --locked</code></td><td>エラーで止まる（CI などで、ずれに気づきたいとき）</td></tr><tr><td><code>uv sync --frozen</code></td><td>uv.lock を見直さず、そのまま使う（公式の説明による仕様。ずれた状態では試していない）</td></tr><tr><td><code>uv lock --check</code></td><td>ずれていればエラー。環境は変えない</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">パッケージの削除</h3>



<p class="wp-block-paragraph">パッケージの削除は、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv remove パッケージ名</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">remove</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">パッケージ名</span></span></code></pre></div>



<p class="wp-block-paragraph">openpyxl を削除すると、次のように表示されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 2 packages in 2ms
Uninstalled 2 packages in 74ms
 - et-xmlfile==2.0.0
 - openpyxl==3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 2 packages in 2ms</span></span>
<span class="line"><span style="color: #D4D4D4">Uninstalled 2 packages in 74ms</span></span>
<span class="line"><span style="color: #D4D4D4"> - et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> - openpyxl==3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph">一緒に入った et-xmlfile も消えました。<code>pyproject.toml</code> の <code>dependencies</code> も空に戻ります。この状態で openpyxl を使うスクリプトを動かすと、当然エラーになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ModuleNotFoundError: No module named 'openpyxl'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ModuleNotFoundError: No module named &apos;openpyxl&apos;</span></span></code></pre></div>



<h3 class="wp-block-heading">パッケージのアップデート</h3>



<p class="wp-block-paragraph">すべてのパッケージをアップデートするには、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv lock --upgrade</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">lock</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--upgrade</span></span></code></pre></div>



<p class="wp-block-paragraph">特定のパッケージだけをアップデートする場合は以下のコマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv lock --upgrade-package パッケージ名</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">lock</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--upgrade-package</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">パッケージ名</span></span></code></pre></div>



<p class="wp-block-paragraph">ロックファイルを更新したあとに <code>uv sync</code> で反映します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span></span></code></pre></div>



<p class="is-style-icon_info wp-block-paragraph"><code>--upgrade</code> はすべての依存パッケージを最新版に更新しようします。<br>メジャーバージョンアップによる破壊的変更が含まれる場合があるので、本番環境で実行する際はアップデート後に動作確認を行いましょう。</p>



<h2 class="wp-block-heading">uv の使い方：仮想環境編</h2>



<h3 class="wp-block-heading">仮想環境の作成</h3>



<p class="wp-block-paragraph">uv では、<code>uv sync</code> や <code>uv add</code> を実行した時点でプロジェクトルートに <code>.venv</code> が自動生成されます。</p>



<p class="wp-block-paragraph">明示的に仮想環境だけを作成したい場合は以下のコマンドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv venv</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">venv</span></span></code></pre></div>



<p class="wp-block-paragraph">特定の Python バージョンで仮想環境を作成する場合は、オプションで指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv venv --python 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">venv</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--python</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph"><strong>Poetry との違い</strong><br>Poetry では <code>poetry config virtualenvs.in-project true</code> で仮想環境をプロジェクトルートに作成する設定が必要でしたが、uv はデフォルトでプロジェクトルートに <code>.venv</code> を作成します。</p>
</blockquote>



<h3 class="wp-block-heading">使用する Python バージョンの選択</h3>



<p class="wp-block-paragraph">プロジェクトで使う Python バージョンを固定するには、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python pin 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pin</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより <code>.python-version</code> ファイルが生成され、そのプロジェクトで使う Python バージョンが固定されます。</p>



<p class="wp-block-paragraph">対象のバージョンの Python がまだインストールされていない場合は先にインストールしてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python install 3.11</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.11</span></span></code></pre></div>



<p class="wp-block-paragraph">手元にある 3.15 に切り替えて試すと、次のようになりました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv python pin 3.15
uv run python --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pin</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.15</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Updated `.python-version` from `3.12` -> `3.15`
Using CPython 3.15.2 interpreter at: /opt/homebrew/opt/python@3.15/bin/python3.15
Removed virtual environment at: .venv
Creating virtual environment at: .venv
Installed 3 packages in 5ms
Python 3.15.2</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Updated `.python-version` from `3.12` -&gt; `3.15`</span></span>
<span class="line"><span style="color: #D4D4D4">Using CPython 3.15.2 interpreter at: /opt/homebrew/opt/python@3.15/bin/python3.15</span></span>
<span class="line"><span style="color: #D4D4D4">Removed virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 3 packages in 5ms</span></span>
<span class="line"><span style="color: #D4D4D4">Python 3.15.2</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.python-version</code> が書き換わり、次の <code>uv run</code> で <code>.venv</code> がその Python で作り直されました。パッケージも自動で入り直します。<code>uv python pin 3.12</code> で戻すと、同じように 3.12 で作り直されました。</p>



<h3 class="wp-block-heading">一度だけ別のバージョンで動かす（&#8211;python）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run --python 3.15 python --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--python</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.15</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.15.2 interpreter at: /opt/homebrew/opt/python@3.15/bin/python3.15
Removed virtual environment at: .venv
Creating virtual environment at: .venv
Installed 3 packages in 5ms
Python 3.15.2</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.15.2 interpreter at: /opt/homebrew/opt/python@3.15/bin/python3.15</span></span>
<span class="line"><span style="color: #D4D4D4">Removed virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 3 packages in 5ms</span></span>
<span class="line"><span style="color: #D4D4D4">Python 3.15.2</span></span></code></pre></div>



<p class="wp-block-paragraph">ただし、試したところ <code>--python</code> を付けると <code>.venv</code> そのものが 3.15 で作り直されました。そのあと何も付けずに <code>uv run</code> すると、<code>.python-version</code> の 3.12 でまた作り直されます。動作の確認は問題なくできますが、毎回作り直しが入る点は覚えておくとよいです。</p>



<p class="wp-block-paragraph">pyenv で Python を管理していた人は、uv に任せるとツールを1つ減らせます。Mac の開発環境づくり全体は<a href="https://cfxlog.com/python-mac-dev-setup/">こちらの記事</a>にまとめています。</p>



<h3 class="wp-block-heading">仮想環境の削除</h3>



<p class="wp-block-paragraph">誤って仮想環境を作成してしまった場合などは、<code>.venv</code> ディレクトリを削除するだけです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>rm -rf .venv</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">rm</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-rf</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv</span></span></code></pre></div>



<p class="wp-block-paragraph">削除後に <code>uv sync</code> を実行すれば、クリーンな状態から再セットアップできます。</p>



<h3 class="wp-block-heading">仮想環境に入る</h3>



<p class="wp-block-paragraph">仮想環境に入るには、次のコマンドを使います。</p>



<p class="wp-block-paragraph"><strong>macOS / Linux</strong></p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>source .venv/bin/activate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv/bin/activate</span></span></code></pre></div>



<p class="wp-block-paragraph"><strong>Windows</strong></p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>.venv\Scripts\activate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">.venv\Scripts\activate</span></span></code></pre></div>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph"><strong>Poetry との違い</strong>：Poetry では <code>poetry shell</code> という専用コマンドがありましたが、uv では標準的な <code>source .venv/bin/activate</code> を使います。</p>
</blockquote>



<h3 class="wp-block-heading">仮想環境から抜ける</h3>



<p class="wp-block-paragraph">仮想環境から抜けるには、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>deactivate</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">deactivate</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより仮想環境が非アクティブになり、システムのグローバルな Python 環境に戻ります。</p>



<h3 class="wp-block-heading">プロジェクトのセットアップ</h3>



<p class="wp-block-paragraph">これからプロジェクトを立ち上げる場合は <code>uv init</code> を実行します。</p>



<p class="wp-block-paragraph">新しいディレクトリを作ってプロジェクトを始める場合：</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv init プロジェクト名</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">init</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">プロジェクト名</span></span></code></pre></div>



<p class="wp-block-paragraph">すでに存在するディレクトリを uv 管理下に置く場合：</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>cd プロジェクトのディレクトリ
uv init</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">cd</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">プロジェクトのディレクトリ</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">init</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>uv init</code> を実行すると、以下のファイルが自動生成されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>pyproject.toml</code><br>プロジェクトの設定ファイル</li>

<li><code>.python-version</code><br>Python バージョンの固定ファイル</li>

<li><code>README.md</code><br>プロジェクトの説明を書くファイル</li>

<li><code>src/プロジェクト名/__init__.py</code><br>パッケージの本体（<code>--no-package</code> を付けたときは <code>main.py</code>）</li>
</ul>
</div></div>



<p class="wp-block-paragraph">上の一覧は、uv 0.13.6 で何も付けずに <code>uv init</code> したときの結果です。Git リポジトリの中で実行したときはこの4つで、Git の管理下ではないフォルダで実行したときは、これに加えて <code>.git</code> と <code>.gitignore</code> も作られました。</p>



<p class="wp-block-paragraph"><code>myapp</code> という名前で作ると、次のように表示されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv init myapp
cd myapp</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">init</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span></span>
<span class="line"><span style="color: #DCDCAA">cd</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Initialized project `myapp` at `/path/to/myapp`</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Initialized project `myapp` at `/path/to/myapp`</span></span></code></pre></div>



<p class="wp-block-paragraph">確認では、ほかのプロジェクトの中で試したため <code>uv init --no-workspace myapp</code> として実行しています。親のフォルダに <code>pyproject.toml</code> があると、新しいプロジェクトがそのワークスペースのメンバーとして加わることがあるので、独立したプロジェクトにしたいときは <code>--no-workspace</code> を付けてください。普通の作業フォルダで実行するなら付けなくてかまいません。</p>



<p class="wp-block-paragraph">できた <code>pyproject.toml</code> の中身は次のとおりです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[project]
name = "myapp"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
authors = [
    { name = "Your Name", email = "you@example.com" }
]
requires-python = ">=3.12"
dependencies = []

[project.scripts]
myapp = "myapp:main"

[build-system]
requires = ["uv_build>=0.13.6,&lt;0.14.0"]
build-backend = "uv_build"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[project]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;myapp&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;0.1.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">description</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Add your description here&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">readme</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;README.md&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">authors</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    { </span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Your Name&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;you@example.com&quot;</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #9CDCFE">requires-python</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&gt;=3.12&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = []</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[project.scripts]</span></span>
<span class="line"><span style="color: #9CDCFE">myapp</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;myapp:main&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[build-system]</span></span>
<span class="line"><span style="color: #9CDCFE">requires</span><span style="color: #D4D4D4"> = [</span><span style="color: #CE9178">&quot;uv_build&gt;=0.13.6,&lt;0.14.0&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #9CDCFE">build-backend</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;uv_build&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>authors</code> には Git に設定している名前とメールアドレスが自動で入ります（上の例では伏せています）。入れたくないときは <code>uv init --author-from none</code> とします。</p>



<p class="wp-block-paragraph"><code>[project.scripts]</code> に書かれた <code>myapp</code> コマンドは、<code>uv run</code> でそのまま実行できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run myapp</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">myapp</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
   Building myapp @ file:///path/to/myapp
      Built myapp @ file:///path/to/myapp
Installed 1 package in 3ms
Hello from myapp!</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">   Building myapp @ file:///path/to/myapp</span></span>
<span class="line"><span style="color: #D4D4D4">      Built myapp @ file:///path/to/myapp</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 1 package in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4">Hello from myapp!</span></span></code></pre></div>



<p class="wp-block-paragraph">初めての <code>uv run</code> で、<code>.venv</code>（仮想環境）と <code>uv.lock</code> が自動で作られます。自分で <code>python -m venv</code> を実行する必要はありません。</p>



<h3 class="wp-block-heading">スクリプト中心なら &#8211;no-package を付ける</h3>



<p class="wp-block-paragraph">配布するパッケージではなく、スクリプトを動かすだけのプロジェクトなら、<code>--no-package</code> を付けると構成が簡単になります。この記事の実行例は、この形で作った <code>hello</code> プロジェクトで動かしています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv init --no-package hello
cd hello</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">init</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-package</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">hello</span></span>
<span class="line"><span style="color: #DCDCAA">cd</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">hello</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pyproject.toml
README.md
.python-version
main.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">pyproject.toml</span></span>
<span class="line"><span style="color: #D4D4D4">README.md</span></span>
<span class="line"><span style="color: #D4D4D4">.python-version</span></span>
<span class="line"><span style="color: #D4D4D4">main.py</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>src/</code> の代わりに <code>main.py</code> が1つでき、<code>pyproject.toml</code> から <code>[project.scripts]</code> と <code>[build-system]</code> がなくなります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run main.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">main.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
Hello from hello!</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Hello from hello!</span></span></code></pre></div>



<h3 class="wp-block-heading">できるファイルを Git に入れるか</h3>



<figure class="wp-block-table"><table><thead><tr><th>ファイル</th><th>役割</th><th>Git に入れるか</th></tr></thead><tbody><tr><td><code>pyproject.toml</code></td><td>プロジェクトの情報と、使うパッケージの一覧</td><td>入れる</td></tr><tr><td><code>.python-version</code></td><td>このプロジェクトで使う Python のバージョン</td><td>入れる</td></tr><tr><td><code>uv.lock</code></td><td>実際に入れたパッケージの正確なバージョン</td><td>入れる</td></tr><tr><td><code>.venv/</code></td><td>仮想環境。uv が自動で作り直せる</td><td>入れない</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">uv run でコマンドを実行する</h2>



<h3 class="wp-block-heading">仮想環境を有効化しなくてよい</h3>



<p class="wp-block-paragraph"><code>source .venv/bin/activate</code> で仮想環境に入らなくても、<code>uv run</code> を付ければプロジェクトの <code>.venv</code> で実行されます。次の <code>main.py</code> で試します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import openpyxl


def main():
    print("openpyxl", openpyxl.__version__)


if __name__ == "__main__":
    main()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> openpyxl</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">main</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;openpyxl&quot;</span><span style="color: #D4D4D4">, openpyxl.</span><span style="color: #9CDCFE">__version__</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">__name__</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;__main__&quot;</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    main()</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run main.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">main.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>openpyxl 3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">openpyxl 3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph">どの Python で動いているかも確認しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run python -c "import sys; print(sys.executable); print(sys.version)"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">python</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-c</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;import sys; print(sys.executable); print(sys.version)&quot;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>/path/to/hello/.venv/bin/python
3.12.16 (main, Oct 26 2026, 13:59:40) [Clang 23.1.3 ]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">/path/to/hello/.venv/bin/python</span></span>
<span class="line"><span style="color: #D4D4D4">3.12.16 (main, Oct 26 2026, 13:59:40) [Clang 23.1.3 ]</span></span></code></pre></div>



<p class="wp-block-paragraph">プロジェクトの中の <code>.venv</code> の Python が使われていました。</p>



<h3 class="wp-block-heading">開発ツールも uv run で動かす</h3>



<p class="wp-block-paragraph"><code>--dev</code> で入れた ruff も <code>uv run</code> で動かせます。わざと書き方の崩れたファイル（<code>bad.py</code>）を用意しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os,sys
def add( x,y ):
    return x+y</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> os,sys</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add</span><span style="color: #D4D4D4">( </span><span style="color: #9CDCFE">x</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE">y</span><span style="color: #D4D4D4"> ):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> x+y</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run ruff check bad.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">check</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">bad.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>I001 [*] Import block is un-sorted or un-formatted
 --> bad.py:1:1
（中略）
F401 [*] `os` imported but unused
 --> bad.py:1:8
（中略）
F401 [*] `sys` imported but unused
 --> bad.py:1:11
（中略）
Found 3 errors.
[*] 3 fixable with `--fix`.</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">I001 [*] Import block is un-sorted or un-formatted</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:1</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">F401 [*] `os` imported but unused</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:8</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">F401 [*] `sys` imported but unused</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:11</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">Found 3 errors.</span></span>
<span class="line"><span style="color: #D4D4D4">[*] 3 fixable with `--fix`.</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>--fix</code> で直せるものを直し、<code>ruff format</code> で整形します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run ruff check --fix bad.py
uv run ruff format bad.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">check</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--fix</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">bad.py</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">bad.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Found 2 errors (2 fixed, 0 remaining).
1 file reformatted</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Found 2 errors (2 fixed, 0 remaining).</span></span>
<span class="line"><span style="color: #D4D4D4">1 file reformatted</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def add(x, y):
    return x + y</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">x</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">y</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> x + y</span></span></code></pre></div>



<p class="wp-block-paragraph">使わない import が消え、空白も整いました。フォーマッターの考え方は<a href="https://cfxlog.com/python-black-formatter/">Black の記事</a>でも紹介しています。</p>



<h2 class="wp-block-heading">pyproject.toml ファイルの書き方</h2>



<p class="wp-block-paragraph">uv では pyproject.toml の <code>[project]</code> というセクションにプロジェクトの詳細を書き込みます。</p>



<p class="wp-block-paragraph">これは <code>uv init</code> コマンドを実行した時に生成される項目です。</p>



<p class="wp-block-paragraph">本セクションでは、<code>[project]</code> セクションに書く内容を解説します。</p>



<h3 class="wp-block-heading">name</h3>



<p class="wp-block-paragraph">プロジェクトをあらわすような、わかりやすい名前をつけます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
name = "my_blog"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;my_blog&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">仮に PyPI などのパッケージリポジトリに公開する時はこの name が識別子になるので、他のパッケージと重複しないように名前をつける必要があります。</p>



<p class="wp-block-paragraph">とはいえ、個人開発で PyPI などに公開しないのであればわかりやすい名前をつけるで大丈夫です。</p>



<blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow">
<p class="wp-block-paragraph"><strong>PyPI に公開する場合は注意</strong>：PyPI ではこの name が識別子になっているので、他のパッケージと重複を避ける必要があります。</p>
</blockquote>



<h3 class="wp-block-heading">version</h3>



<p class="wp-block-paragraph">プロジェクトのバージョンを記載します。</p>



<p class="wp-block-paragraph">プロジェクトの更新のたびにバージョンを上げていく必要があり、一般的にはセマンティックバージョニングと呼ばれる管理を行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
version = "1.2.3"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">version</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;1.2.3&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">それぞれの桁ごとの意味合いは以下の通りです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>1桁目：MAJOR。互換性のない API の変更がある場合に上げる。</li>



<li>2桁目：MINOR。互換性のある新機能が追加された場合に上げる。</li>



<li>3桁目：PATCH。互換性のあるバグ修正が行われた場合に上げる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">なおプレリリースやビルドメタデータを含めることもできるので、<code>1.2.3-a1</code> といった書き方でも大丈夫です。</p>



<h3 class="wp-block-heading">description</h3>



<p class="wp-block-paragraph">プロジェクトの説明を簡潔に書きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
description = "A robust and user-friendly blog system designed for both individual bloggers and enterprise-level content management."</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">description</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;A robust and user-friendly blog system designed for both individual bloggers and enterprise-level content management.&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">書き方のポイントは以下の通りです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>簡潔：ポイントを絞って短く書く</li>



<li>明瞭：何をするプログラムなのか</li>



<li>対象者：どのような用途でどんな人が使うのか</li>
</ul>
</div></div>



<h3 class="wp-block-heading">license</h3>



<p class="wp-block-paragraph">ライセンスを記述します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
license = { text = "MIT" }</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">license</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">{</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">text</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;MIT&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">}</span></span></code></pre></div>



<p class="wp-block-paragraph">例えば次のようなライセンスを設定します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Apache-2.0</li>



<li>BSD-2-Clause</li>



<li>BSD-3-Clause</li>



<li>GPL-2.0-only</li>



<li>GPL-3.0-only</li>



<li>LGPL-2.1-only</li>



<li>MIT</li>
</ul>
</div></div>



<h3 class="wp-block-heading">authors</h3>



<p class="wp-block-paragraph">プロジェクトの作成者を記述します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
authors = &#91;
    { name = "Steive", email = "sample@gmail.com" },
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">authors</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    { </span><span style="color: #DCDCAA">name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;Steive&quot;,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">email</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;sample@gmail.com&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">},</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">形式は <code>{ name = "名前", email = "メール" }</code> の形式で指定してください。</p>



<h3 class="wp-block-heading">maintainers</h3>



<p class="wp-block-paragraph">保守を行う人がいれば、記述します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
maintainers = &#91;
    { name = "Emily", email = "sample@gmail.com" },
    { name = "Bob", email = "sample@gmail.com" },
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">maintainers</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    { </span><span style="color: #DCDCAA">name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;Emily&quot;,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">email</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;sample@gmail.com&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">},</span></span>
<span class="line"><span style="color: #D4D4D4">    { </span><span style="color: #DCDCAA">name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;Bob&quot;,</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">email</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;sample@gmail.com&quot;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">},</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">プロジェクトのオーナー以外にメンテナンスを行う人を分けて書いておけるのは便利です。</p>



<h3 class="wp-block-heading">readme</h3>



<p class="wp-block-paragraph">README ファイルへのパスを記載する場所です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project&#93;
readme = "README.md"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">readme</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;README.md&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">一般的に README ファイルには以下のような事項が書かれます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>プロジェクトの概要と目的</li>



<li>インストール手順</li>



<li>使用方法やサンプルコード</li>



<li>コントリビューションガイドライン</li>



<li>ライセンス情報</li>



<li>連絡先や貢献者の情報</li>
</ul>
</div></div>



<h3 class="wp-block-heading">urls [ オプション ]</h3>



<p class="wp-block-paragraph">ホームページ・リポジトリ・ドキュメントの URL は <code>[project.urls]</code> セクションにまとめて記述します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&#91;project.urls&#93;
Homepage = "https://www.sample.com/"
Repository = "https://github.com/~~~"
Documentation = "https://sample.com/docs"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">&#91;project.urls&#93;</span></span>
<span class="line"><span style="color: #DCDCAA">Homepage</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;https://www.sample.com&quot;/</span></span>
<span class="line"><span style="color: #DCDCAA">Repository</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;https://github.com/~~~&quot;</span></span>
<span class="line"><span style="color: #DCDCAA">Documentation</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;https://sample.com/docs&quot;</span></span></code></pre></div>



<h2 class="wp-block-heading">requirements.txt や pip から移行する</h2>



<h3 class="wp-block-heading">requirements.txt を uv add -r で取り込む</h3>



<p class="wp-block-paragraph">次の2つのファイルがあるプロジェクトを uv に移してみます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># requirements.txt
openpyxl>=3.1

# requirements-dev.txt
ruff</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4"># requirements.txt</span></span>
<span class="line"><span style="color: #D4D4D4">openpyxl&gt;=3.1</span></span>
<span class="line"><span style="color: #D4D4D4"></span></span>
<span class="line"><span style="color: #D4D4D4"># requirements-dev.txt</span></span>
<span class="line"><span style="color: #D4D4D4">ruff</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>pyproject.toml</code> がまだないので、<code>--bare</code> を付けて <code>pyproject.toml</code> だけを作り、<code>-r</code> でファイルを読み込みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv init --bare
uv add -r requirements.txt
uv add --dev -r requirements-dev.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">init</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--bare</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--dev</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements-dev.txt</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Initialized project `fromreq`
Using CPython 3.12.16
Creating virtual environment at: .venv
Resolved 3 packages in 1ms
Installed 2 packages in 3ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5
Resolved 4 packages in 2ms
Installed 1 package in 3ms
 + ruff==0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Initialized project `fromreq`</span></span>
<span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved 3 packages in 1ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 2 packages in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 2ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 1 package in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + ruff==0.17.5</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[project]
name = "fromreq"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "openpyxl>=3.1",
]

[dependency-groups]
dev = [
    "ruff>=0.17.5",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[project]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;fromreq&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;0.1.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">requires-python</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&gt;=3.12&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;openpyxl&gt;=3.1&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[dependency-groups]</span></span>
<span class="line"><span style="color: #9CDCFE">dev</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;ruff&gt;=0.17.5&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>openpyxl&gt;=3.1</code> のように条件が書いてあった行はそのまま、条件のなかった ruff は入ったバージョン以上という条件で記録されました。requirements.txt の書き方は<a href="https://cfxlog.com/python-requirements-txt-guide/">requirements.txt の記事</a>で詳しく説明しています。</p>



<h3 class="wp-block-heading">uv pip で pip と同じように使う</h3>



<p class="wp-block-paragraph">すぐに <code>pyproject.toml</code> へ移れないときは、<code>uv pip</code> を pip の代わりに使えます。コマンドの形は pip とほとんど同じです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv venv .venv
uv pip install -r requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">venv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate
Resolved 2 packages in 0.69ms
Installed 2 packages in 3ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Activate with: source .venv/bin/activate</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved 2 packages in 0.69ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 2 packages in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph">入っているものの確認や削除も、pip と同じ名前のサブコマンドです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv pip list
uv pip freeze
uv pip uninstall openpyxl</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">list</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">freeze</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">uninstall</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">openpyxl</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Package    Version
---------- -------
et-xmlfile 2.0.0
openpyxl   3.1.5
et-xmlfile==2.0.0
openpyxl==3.1.5
Uninstalled 1 package in 34ms
 - openpyxl==3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Package    Version</span></span>
<span class="line"><span style="color: #D4D4D4">---------- -------</span></span>
<span class="line"><span style="color: #D4D4D4">et-xmlfile 2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4">openpyxl   3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4">et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4">openpyxl==3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4">Uninstalled 1 package in 34ms</span></span>
<span class="line"><span style="color: #D4D4D4"> - openpyxl==3.1.5</span></span></code></pre></div>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：uv venv の仮想環境には pip が入っていない</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>uv venv</code> で作った仮想環境で <code>python -m pip</code> を実行すると、<code>No module named pip</code> になりました。この環境では <code>pip</code> ではなく <code>uv pip</code> を使います。</p>
</div></div>



<h3 class="wp-block-heading">uv.lock から requirements.txt を書き出す</h3>



<p class="wp-block-paragraph">サーバーやほかのツールが requirements.txt を必要とするときは、<code>uv export</code> で書き出せます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv export --format requirements-txt --no-hashes --no-dev</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements-txt</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-hashes</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-dev</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Resolved 4 packages in 0.98ms
# This file was autogenerated by uv via the following command:
#    uv export --format requirements-txt --no-hashes --no-dev
et-xmlfile==2.0.0
    # via openpyxl
openpyxl==3.1.5
    # via hello</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 0.98ms</span></span>
<span class="line"><span style="color: #D4D4D4"># This file was autogenerated by uv via the following command:</span></span>
<span class="line"><span style="color: #D4D4D4">#    uv export --format requirements-txt --no-hashes --no-dev</span></span>
<span class="line"><span style="color: #D4D4D4">et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4">    # via openpyxl</span></span>
<span class="line"><span style="color: #D4D4D4">openpyxl==3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4">    # via hello</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>--no-hashes</code> を外すと、各パッケージにハッシュ（<code>--hash=sha256:...</code>）が付きます。ファイルに保存するときは <code>-o requirements.txt</code> を付けます。</p>



<h2 class="wp-block-heading">Poetry から移行する</h2>



<h3 class="wp-block-heading">[tool.poetry] のままでは依存を読まない</h3>



<p class="wp-block-paragraph">Poetry のプロジェクトは、依存を <code>[tool.poetry.dependencies]</code> に書いています。次の <code>pyproject.toml</code> で <code>uv sync</code> を試しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[tool.poetry]
name = "oldapp"
version = "0.1.0"
description = ""
authors = ["Your Name &lt;you@example.com>"]
package-mode = false

[tool.poetry.dependencies]
python = "^3.12"
openpyxl = "^3.1"

[tool.poetry.group.dev.dependencies]
ruff = "*"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[tool.poetry]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;oldapp&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;0.1.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">description</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">authors</span><span style="color: #D4D4D4"> = [</span><span style="color: #CE9178">&quot;Your Name &lt;you@example.com&gt;&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #9CDCFE">package-mode</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">false</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[tool.poetry.dependencies]</span></span>
<span class="line"><span style="color: #9CDCFE">python</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;^3.12&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">openpyxl</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;^3.1&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[tool.poetry.group.dev.dependencies]</span></span>
<span class="line"><span style="color: #9CDCFE">ruff</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;*&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[build-system]</span></span>
<span class="line"><span style="color: #9CDCFE">requires</span><span style="color: #D4D4D4"> = [</span><span style="color: #CE9178">&quot;poetry-core&quot;</span><span style="color: #D4D4D4">]</span></span>
<span class="line"><span style="color: #9CDCFE">build-backend</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;poetry.core.masonry.api&quot;</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
warning: No `requires-python` value found in the workspace. Defaulting to `>=3.12`.
Resolved in 1ms
Checked in 0.00ms</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">warning: No `requires-python` value found in the workspace. Defaulting to `&gt;=3.12`.</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved in 1ms</span></span>
<span class="line"><span style="color: #D4D4D4">Checked in 0.00ms</span></span></code></pre></div>



<p class="wp-block-paragraph">エラーにはなりませんが、何もインストールされませんでした（<code>uv pip list</code> も空でした）。uv は <code>[tool.poetry]</code> の中を読まないので、<code>[project]</code> の形に書き換える必要があります。</p>



<h3 class="wp-block-heading">[project] と [dependency-groups] に書き換える</h3>



<p class="wp-block-paragraph">Poetry の書き方は、次のように置き換えます。</p>



<figure class="wp-block-table"><table><thead><tr><th>Poetry</th><th>uv（pyproject.toml の標準の書き方）</th></tr></thead><tbody><tr><td><code>python = "^3.12"</code></td><td><code>requires-python = "&gt;=3.12"</code></td></tr><tr><td><code>openpyxl = "^3.1"</code></td><td><code>"openpyxl&gt;=3.1,&lt;4"</code>（<code>^</code> は、1.0 以上の版では次のメジャー版の手前まで）</td></tr><tr><td><code>[tool.poetry.group.dev.dependencies]</code></td><td><code>[dependency-groups]</code> の <code>dev</code></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">書き換えた <code>pyproject.toml</code> です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[project]
name = "oldapp"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "openpyxl>=3.1,&lt;4",
]

[dependency-groups]
dev = [
    "ruff",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">[project]</span></span>
<span class="line"><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;oldapp&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">version</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;0.1.0&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">requires-python</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&gt;=3.12&quot;</span></span>
<span class="line"><span style="color: #9CDCFE">dependencies</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;openpyxl&gt;=3.1,&lt;4&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[dependency-groups]</span></span>
<span class="line"><span style="color: #9CDCFE">dev</span><span style="color: #D4D4D4"> = [</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;ruff&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">]</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv sync</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sync</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Using CPython 3.12.16
Creating virtual environment at: .venv
Resolved 4 packages in 1ms
Installed 3 packages in 5ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5
 + ruff==0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Using CPython 3.12.16</span></span>
<span class="line"><span style="color: #D4D4D4">Creating virtual environment at: .venv</span></span>
<span class="line"><span style="color: #D4D4D4">Resolved 4 packages in 1ms</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 3 packages in 5ms</span></span>
<span class="line"><span style="color: #D4D4D4"> + et-xmlfile==2.0.0</span></span>
<span class="line"><span style="color: #D4D4D4"> + openpyxl==3.1.5</span></span>
<span class="line"><span style="color: #D4D4D4"> + ruff==0.17.5</span></span></code></pre></div>



<p class="wp-block-paragraph">これで uv のプロジェクトとして動きました。<code>poetry.lock</code> は uv では使わないので、<code>uv.lock</code> ができて動作を確かめたら片付けてかまいません。</p>



<h2 class="wp-block-heading">uvx でツールを一時的に動かす</h2>



<h3 class="wp-block-heading">プロジェクトに入れずに動かす</h3>



<p class="wp-block-paragraph"><code>uvx</code> は <code>uv tool run</code> の短い書き方で、パッケージが提供するコマンドを、プロジェクトの外の一時的な環境で動かします。たとえば ruff をプロジェクトに追加せずに使うときは、次のように書きます。</p>



<p class="wp-block-paragraph">最初の1回は ruff をダウンロードするので、<code>Downloading ruff</code> と表示されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uvx ruff --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uvx</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Downloading ruff (9.1MiB)
 Downloaded ruff
Installed 1 package in 3ms
ruff 0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Downloading ruff (9.1MiB)</span></span>
<span class="line"><span style="color: #D4D4D4"> Downloaded ruff</span></span>
<span class="line"><span style="color: #D4D4D4">Installed 1 package in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4">ruff 0.17.5</span></span></code></pre></div>



<p class="wp-block-paragraph">先ほどの <code>bad.py</code> にも、プロジェクトに ruff を追加しないまま使えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uvx ruff check bad.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uvx</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">check</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">bad.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>I001 [*] Import block is un-sorted or un-formatted
 --> bad.py:1:1
（中略）
F401 [*] `os` imported but unused
 --> bad.py:1:8
（中略）
F401 [*] `sys` imported but unused
 --> bad.py:1:11
（中略）
Found 3 errors.
[*] 3 fixable with `--fix`.</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">I001 [*] Import block is un-sorted or un-formatted</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:1</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">F401 [*] `os` imported but unused</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:8</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">F401 [*] `sys` imported but unused</span></span>
<span class="line"><span style="color: #D4D4D4"> --&gt; bad.py:1:11</span></span>
<span class="line"><span style="color: #D4D4D4">（中略）</span></span>
<span class="line"><span style="color: #D4D4D4">Found 3 errors.</span></span>
<span class="line"><span style="color: #D4D4D4">[*] 3 fixable with `--fix`.</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uvx ruff format bad.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uvx</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">bad.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>1 file reformatted</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">1 file reformatted</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os, sys


def add(x, y):
    return x + y</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> os, sys</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">x</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">y</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> x + y</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>ruff format</code> は整形だけなので、使っていない import は残ります。消すには <code>uvx ruff check --fix bad.py</code> を使います。</p>



<p class="wp-block-paragraph">バージョンを決めて動かしたいときは <code>@</code> で指定します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uvx ruff@0.17.5 --version</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uvx</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ruff@0.17.5</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--version</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ruff 0.17.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ruff 0.17.5</span></span></code></pre></div>



<h3 class="wp-block-heading">uvx と uv add &#8211;dev の使い分け</h3>



<figure class="wp-block-table"><table><thead><tr><th>やり方</th><th>向いている場面</th></tr></thead><tbody><tr><td><code>uv add --dev ruff</code> ＋ <code>uv run ruff</code></td><td>チームで同じバージョンを使いたい。uv.lock に記録される</td></tr><tr><td><code>uvx ruff</code></td><td>ちょっと試したい・プロジェクトの外のファイルに使いたい</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">おすすめは、プロジェクトで継続して使うツールは <code>uv add --dev</code> で入れてバージョンをそろえ、ちょっと試すだけのものは <code>uvx</code> で動かす、という使い分けです。</p>



<h2 class="wp-block-heading">1ファイルのスクリプトに依存を書く（&#8211;script）</h2>



<h3 class="wp-block-heading">スクリプトの先頭に依存を書き込む</h3>



<p class="wp-block-paragraph">プロジェクトを作るほどでもない1ファイルのスクリプトには、<code>uv add --script</code> で依存を書き込めます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import openpyxl

print("openpyxl", openpyxl.__version__)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> openpyxl</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;openpyxl&quot;</span><span style="color: #D4D4D4">, openpyxl.</span><span style="color: #9CDCFE">__version__</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add --script report.py openpyxl</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--script</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">report.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">openpyxl</span></span></code></pre></div>



<p class="wp-block-paragraph">実行すると、ファイルの先頭に次のコメントが追加されました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># /// script
# requires-python = ">=3.12"
# dependencies = [
#     "openpyxl>=3.1.5",
# ]
# ///
import openpyxl

print("openpyxl", openpyxl.__version__)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># /// script</span></span>
<span class="line"><span style="color: #6A9955"># requires-python = &quot;&gt;=3.12&quot;</span></span>
<span class="line"><span style="color: #6A9955"># dependencies = [</span></span>
<span class="line"><span style="color: #6A9955">#     &quot;openpyxl&gt;=3.1.5&quot;,</span></span>
<span class="line"><span style="color: #6A9955"># ]</span></span>
<span class="line"><span style="color: #6A9955"># ///</span></span>
<span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> openpyxl</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;openpyxl&quot;</span><span style="color: #D4D4D4">, openpyxl.</span><span style="color: #9CDCFE">__version__</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv run report.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">run</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">report.py</span></span></code></pre></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="コピー" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Installed 2 packages in 3ms
openpyxl 3.1.5</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Installed 2 packages in 3ms</span></span>
<span class="line"><span style="color: #D4D4D4">openpyxl 3.1.5</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>uv run</code> がこのコメントを読んで、必要なパッケージを入れた環境で実行してくれます。ファイルを1つ渡すだけで、相手も同じように動かせます。</p>



<h2 class="wp-block-heading">よく使う uv コマンドの早見表</h2>



<h3 class="wp-block-heading">プロジェクトとパッケージ</h3>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>やること</th></tr></thead><tbody><tr><td><code>uv init &lt;名前&gt;</code></td><td>プロジェクトを作る（<code>--no-package</code> で main.py だけの形）</td></tr><tr><td><code>uv add &lt;パッケージ&gt;</code></td><td>パッケージを追加する（<code>--dev</code> で開発用）</td></tr><tr><td><code>uv remove &lt;パッケージ&gt;</code></td><td>パッケージを削除する</td></tr><tr><td><code>uv run &lt;コマンド&gt;</code></td><td>プロジェクトの環境で実行する</td></tr><tr><td><code>uv sync</code></td><td>uv.lock どおりに環境をそろえる</td></tr><tr><td><code>uv lock --check</code></td><td>uv.lock がずれていないか確かめる</td></tr><tr><td><code>uv tree</code></td><td>依存を木の形で表示する</td></tr><tr><td><code>uv export --format requirements-txt</code></td><td>requirements.txt 形式で書き出す</td></tr></tbody></table></figure>



<h3 class="wp-block-heading">Python とツール</h3>



<figure class="wp-block-table"><table><thead><tr><th>コマンド</th><th>やること</th></tr></thead><tbody><tr><td><code>uv python list</code></td><td>使える Python を一覧で見る</td></tr><tr><td><code>uv python pin 3.12</code></td><td>プロジェクトの Python を決める</td></tr><tr><td><code>uv python install 3.13</code></td><td>Python を入れる</td></tr><tr><td><code>uv pip install &lt;パッケージ&gt;</code></td><td>pip の代わりに使う</td></tr><tr><td><code>uvx &lt;ツール&gt;</code></td><td>ツールを一時的な環境で動かす</td></tr></tbody></table></figure>



<h2 class="wp-block-heading">参考サイト</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><a href="https://docs.astral.sh/uv/">uv 公式ドキュメント</a></li>



<li><a href="https://github.com/astral-sh/uv">uv GitHub リポジトリ</a></li>



<li><a href="https://astral.sh/">Astral（uv 開発元）公式サイト</a></li>
</ul>
</div></div>

]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【VSCode対応】PythonのBlackフォーマッタを使う方法</title>
		<link>https://cfxlog.com/python-black-formatter/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 15 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4629</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>BlackはPythonのコードを整形してくれるツールです。 例えば次のような汚いコードがあったとします。 Blackを適用すると、この通り。 Visual Studio Code（VSCode）でBlackを設定してお [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">BlackはPythonのコードを整形してくれるツールです。</p>



<p class="wp-block-paragraph">例えば次のような汚いコードがあったとします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def calculate_sum(a,b): return a+b
def multiply(x,y):return x*y
def main():
 x = 10
 y = 20
 sum_result=calculate_sum(x,y)
 product =multiply(x,y)
 print(f"Sum: {sum_result}, Product: {product}")
main()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">calculate_sum</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">a</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE">b</span><span style="color: #D4D4D4">): </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> a+b</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">multiply</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">x</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE">y</span><span style="color: #D4D4D4">):</span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> x*y</span></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">main</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4"> x = </span><span style="color: #B5CEA8">10</span></span>
<span class="line"><span style="color: #D4D4D4"> y = </span><span style="color: #B5CEA8">20</span></span>
<span class="line"><span style="color: #D4D4D4"> sum_result=calculate_sum(x,y)</span></span>
<span class="line"><span style="color: #D4D4D4"> product =multiply(x,y)</span></span>
<span class="line"><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;Sum: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">sum_result</span><span style="color: #569CD6">}</span><span style="color: #CE9178">, Product: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">product</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">main()</span></span></code></pre></div>



<p class="wp-block-paragraph">Blackを適用すると、この通り。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def calculate_sum(a, b):
    return a + b


def multiply(x, y):
    return x * y


def main():
    x = 10
    y = 20
    sum_result = calculate_sum(x, y)
    product = multiply(x, y)
    print(f"Sum: {sum_result}, Product: {product}")


main()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">calculate_sum</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">a</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">b</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> a + b</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">multiply</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">x</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">y</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> x * y</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">main</span><span style="color: #D4D4D4">():</span></span>
<span class="line"><span style="color: #D4D4D4">    x = </span><span style="color: #B5CEA8">10</span></span>
<span class="line"><span style="color: #D4D4D4">    y = </span><span style="color: #B5CEA8">20</span></span>
<span class="line"><span style="color: #D4D4D4">    sum_result = calculate_sum(x, y)</span></span>
<span class="line"><span style="color: #D4D4D4">    product = multiply(x, y)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;Sum: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">sum_result</span><span style="color: #569CD6">}</span><span style="color: #CE9178">, Product: </span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">product</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">main()</span></span></code></pre></div>



<p class="wp-block-paragraph">Visual Studio Code（VSCode）でBlackを設定しておけば、保存のたびに整形してます。</p>



<p class="wp-block-paragraph">便利すぎるので、僕は真っ先に導入します。</p>



<p class="wp-block-paragraph">本記事では、Blackの導入方法を解説します。</p>



<div class="swell-block-capbox cap_box"><div class="cap_box_ttl"><span>本記事で説明する環境</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>macOS</li>



<li>Python 3.11.11</li>



<li>VSCode バージョン: 1.96.2 (Universal)</li>
</ul>
</div></div>



<h2 class="wp-block-heading">Visual Studio CodeでBlackを設定する2つの方法</h2>



<p class="wp-block-paragraph">VSCodeでBlackを設定する方法は、以下の2つです。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol start="1" class="wp-block-list is-style-num_circle">
<li><strong>Workspace Settings (</strong><code><strong>settings.json</strong></code><strong>)</strong>
<ul class="wp-block-list">
<li>ワークスペースの設定が最優先されます。</li>
</ul>
</li>



<li><strong>Project Settings (</strong><code><strong>pyproject.toml</strong></code><strong>)</strong>
<ul class="wp-block-list">
<li>ワークスペース設定に書かれていない場合に適用されます。</li>
</ul>
</li>
</ol>
</div></div>



<p class="wp-block-paragraph">2つとも設定した場合には、<code>settings.json</code>で設定した内容が優先されます。</p>



<h3 class="wp-block-heading">0. 事前準備</h3>



<figure class="wp-block-image size-full"><img decoding="async" width="1024" height="256" src="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1.png" alt="" class="wp-image-4633" srcset="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1.png 1024w, https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1-300x75.png 300w, https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-1-768x192.png 768w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">VSCodeでBlackを使うには、プラグインのインストールをしましょう。</p>



<p class="wp-block-paragraph"><strong><a href="https://marketplace.visualstudio.com/items?itemName=ms-python.black-formatter">» 参考：Black Formatter &#8211; Visual Studio Marketplace</a></strong></p>



<p class="wp-block-paragraph">Installボタンをクリックするとポップアップが開くので、Continueをクリックしてインストールを進めて下さい。</p>



<p class="is-style-icon_good wp-block-paragraph">Microsoftが提供するプラグインなので安心です。</p>



<h3 class="wp-block-heading">1. settings.jsonを使う方法</h3>



<p class="wp-block-paragraph">まずは以下のコマンドでコマンドパレットを表示させます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-good_list">
<li>Windows/Linux
<ul class="wp-block-list">
<li><code>Ctrl</code> + <code>Shift</code> + <code>P</code></li>
</ul>
</li>



<li>macOS
<ul class="wp-block-list">
<li><code>Cmd</code> + <code>Shift</code> + <code>P</code></li>
</ul>
</li>
</ul>
</div></div>



<p class="wp-block-paragraph">すると、以下のようなコマンドパレットが表示されます。</p>



<figure class="wp-block-image size-full is-resized"><img decoding="async" width="688" height="147" src="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-2.png" alt="" class="wp-image-4634" style="width:750px;height:auto" srcset="https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-2.png 688w, https://cfxlog.com/wp-content/uploads/2026/03/python-black-formatter-2-300x64.png 300w" sizes="(max-width: 688px) 100vw, 688px" /></figure>



<p class="wp-block-paragraph">そこに、以下を入力してEnterを押しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Preferences: Open User Settings (JSON)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">Preferences:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Open</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">User</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">Settings</span><span style="color: #D4D4D4"> (JSON)</span></span></code></pre></div>



<p class="wp-block-paragraph">以下を<code>settings.json</code>に追加すればOKです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JSON</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
    "&#91;python&#93;": {
        // BlackをPythonのデフォルトフォーマッターに指定
        "editor.defaultFormatter": "ms-python.black-formatter",
        // 保存時にBlackを適用
        "editor.formatOnSave": true
    },
    // 1行の文字数の上限を120文字に設定
    "black-formatter.args": &#91;"--line-length=120"&#93;
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;&#91;python&#93;&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955">// BlackをPythonのデフォルトフォーマッターに指定</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">&quot;editor.defaultFormatter&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;ms-python.black-formatter&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955">// 保存時にBlackを適用</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">&quot;editor.formatOnSave&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">true</span></span>
<span class="line"><span style="color: #D4D4D4">    },</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 1行の文字数の上限を120文字に設定</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;black-formatter.args&quot;</span><span style="color: #D4D4D4">: &#91;</span><span style="color: #CE9178">&quot;--line-length=120&quot;</span><span style="color: #D4D4D4">&#93;</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより、Pythonファイルを保存するたびにBlackが適用されます。</p>



<h3 class="wp-block-heading">2. pyproject.tomlを使う方法</h3>



<p class="wp-block-paragraph"><code>pyproject.toml</code>でBlackの設定を管理したい場合は、以下のようにVSCodeに指示を追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TOML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>"black-formatter.args": &#91;"--config", "pyproject.toml"&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #F44747">&quot;black-formatter.args&quot;: &#91;&quot;--config&quot;, &quot;pyproject.toml&quot;&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">その上で、Blackの設定が適用されているかどうか、下記コマンドを実行して確認してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>black --config pyproject.toml .</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">black</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--config</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pyproject.toml</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.</span></span></code></pre></div>



<h2 class="wp-block-heading">コマンドライン上から実行したい場合は？</h2>



<p class="wp-block-paragraph">コマンドラインから実行したい場合の手順は以下の通り。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>pip install する</li>



<li>blackコマンドを実行する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">順番に解説します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<div class="swell-block-step is-style-default" data-num-style="square">
<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><h3 class="swell-block-step__title u-fz-l">Blackライブラリのインストール</h3><div class="swell-block-step__body">
<p class="wp-block-paragraph">以下のコマンドでインストールしましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install black</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">black</span></span></code></pre></div>
</div></div>



<div class="swell-block-step__item"><div class="swell-block-step__number u-bg-main"><span class="__label">STEP</span></div><h3 class="swell-block-step__title u-fz-l">Blackを実行</h3><div class="swell-block-step__body">
<p class="wp-block-paragraph">以下のコマンドでBlackを実行できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>black .</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">black</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.</span></span></code></pre></div>



<p class="wp-block-paragraph">現在いるディレクトリ配下にあるpyファイルは、すべてBlackフォーマッタによって整形されます。</p>



<p class="wp-block-paragraph">もしフォルダを指定して整形したいなら、以下のコマンドです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>black manage.py</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">black</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span></span></code></pre></div>



<p class="wp-block-paragraph">個人的にはコマンドライン上から実行する場合、<code>black .</code>を使うことのほうが多いです。</p>
</div></div>
</div>
</div></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">BlackはPythonの超強力なフォーマッタです。</p>



<p class="wp-block-paragraph">特に今回ご紹介したようなVisual Studio Codeとの組み合わせで使うと、飛躍的にコーディングの効率が上がります。</p>



<p class="wp-block-paragraph">ぜひ、本記事を参考に導入を進めてみて下さい！</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django の djLint のセットアップ方法と使い方</title>
		<link>https://cfxlog.com/python-django-djlint-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 14 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[UI実装]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5044</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-djlint-setup.jpg" class="webfeedsFeaturedVisual" /></p>djLint は Django でフォーマッター兼リンターとして使える便利なライブラリです。つまり Django HTML テンプレートの問題点の指摘や、コードを自動的に整形してくれる機能があります。 個人開発ではもちろ [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-djlint-setup.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django のリンター djLint を使ってみたい</li>



<li>設定方法をサクッと知りたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">djLint は Django でフォーマッター兼リンターとして使える便利なライブラリです。<br>つまり Django HTML テンプレートの問題点の指摘や、コードを自動的に整形してくれる機能があります。</p>



<p class="wp-block-paragraph">個人開発ではもちろん、チームで開発している場合には細かいコーディングルールを決めなくてよくなるのは大きなメリットかと思います。</p>



<p class="wp-block-paragraph">デフォルト設定ではちょっと使いづらい部分もあるので、その辺のカスタマイズも含めてご紹介します。</p>



<h2 class="wp-block-heading" id="install">djLint のインストール方法</h2>



<p class="wp-block-paragraph">djLint のインストールは、次のコマンドで行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install djlint</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">djlint</span></span></code></pre></div>



<h2 class="wp-block-heading">Visual Studio Code で djLint を使いこなす</h2>



<p class="wp-block-paragraph">Visual Studio Code で設定を行うと、フォーマッター・リンターともに自動実行してくれるので非常に便利です。</p>



<p class="wp-block-paragraph">少し設定が面倒ではあるので、順番に解説していきます。</p>



<p class="is-style-icon_info wp-block-paragraph">先に<a href="#install">ライブラリのインストール</a>を済ませてください。</p>



<h3 class="wp-block-heading">settings.json の設定</h3>



<p class="wp-block-paragraph">まずは、以下の手順で settings.json を開きます。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>左下にある歯車アイコン（設定）をクリック</li>



<li>「設定」を選択</li>



<li>右上の「ファイルアイコン（設定を開く（JSON））」をクリック</li>
</ul>
</div></div>



<p class="wp-block-paragraph">続いて、以下の内容を追記してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JSON</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
    "&#91;html&#93;": {
        "editor.defaultFormatter": "esbenp.prettier-vscode",
        "editor.formatOnSave": true
    },
    "html.format.enable": false,
    "emmet.includeLanguages": {
        "django-html": "html"
    }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;&#91;html&#93;&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">&quot;editor.defaultFormatter&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;esbenp.prettier-vscode&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">&quot;editor.formatOnSave&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">true</span></span>
<span class="line"><span style="color: #D4D4D4">    },</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;html.format.enable&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;emmet.includeLanguages&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">&quot;django-html&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;html&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">続いて、tasks.json として以下を追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">JSON</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>{
  "label": "djlint",
  "type": "shell",
  "command": "djlint",
  "args": &#91;"--reformat", "${file}"&#93;,
  "group": {
    "kind": "build",
    "isDefault": true
  },
  "presentation": {
    "reveal": "always",
    "panel": "shared"
  }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">{</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;label&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;djlint&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;type&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;shell&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;command&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;djlint&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;args&quot;</span><span style="color: #D4D4D4">: &#91;</span><span style="color: #CE9178">&quot;--reformat&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;${file}&quot;</span><span style="color: #D4D4D4">&#93;,</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;group&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;kind&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;build&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;isDefault&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #569CD6">true</span></span>
<span class="line"><span style="color: #D4D4D4">  },</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">&quot;presentation&quot;</span><span style="color: #D4D4D4">: {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;reveal&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;always&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">&quot;panel&quot;</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">&quot;shared&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">これで設定は完了です。</p>



<h2 class="wp-block-heading">コマンドラインから djLint を実行する方法</h2>



<p class="wp-block-paragraph">あまり使うことはないかもしれませんが、コマンドラインから djLint を呼び出して実行する方法をご紹介します。</p>



<h3 class="wp-block-heading">リンターを実行する方法</h3>



<p class="wp-block-paragraph">リンターで品質チェックをするには、以下をコマンドライン上で実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 特定ディレクトリ内に対してリンターを実行
djlint /path/to/templates --lint

# 特定ファイルに対してリンターを実行
djlint /path/to/this.mustache --lint</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 特定ディレクトリ内に対してリンターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/templates</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--lint</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 特定ファイルに対してリンターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/this.mustache</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--lint</span></span></code></pre></div>



<h3 class="wp-block-heading">フォーマッターで整形する方法</h3>



<p class="wp-block-paragraph">フォーマッターで整形をかける場合には、以下をコマンドラインで実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 特定ディレクトリ内に対してフォーマッターを実行
djlint /path/to/templates --reformat

# 特定ファイルに対してフォーマッターを実行
djlint /path/to/this.mustache --reformat</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 特定ディレクトリ内に対してフォーマッターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/templates</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--reformat</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 特定ファイルに対してフォーマッターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/this.mustache</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--reformat</span></span></code></pre></div>



<h3 class="wp-block-heading">リンターとフォーマッターを同時に適用する方法</h3>



<p class="wp-block-paragraph">リンターとフォーマッターを一度にかける場合には、オプションを組み合わせて実行してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 特定ディレクトリ内に対してリンターとフォーマッターを実行
djlint /path/to/templates --lint --reformat

# 特定ファイルに対してリンターとフォーマッターを実行
djlint /path/to/this.mustache --lint --reformat</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 特定ディレクトリ内に対してリンターとフォーマッターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/templates</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--lint</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--reformat</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 特定ファイルに対してリンターとフォーマッターを実行</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">/path/to/this.mustache</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--lint</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--reformat</span></span></code></pre></div>



<p class="wp-block-paragraph">どのようなフォーマットがかかるかを確認するには、次のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># フォーマット内容をチェック
djlint . --check</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># フォーマット内容をチェック</span></span>
<span class="line"><span style="color: #DCDCAA">djlint</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--check</span></span></code></pre></div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>requirements.txtの書き方とpipで一括インストール</title>
		<link>https://cfxlog.com/python-requirements-txt-guide/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 10 Feb 2026 05:54:56 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[環境構築]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4921</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-requirements-txt-guide.jpg" class="webfeedsFeaturedVisual" /></p>Python は他のプログラミング言語に比べて、多種多様なライブラリが存在します。 色々な用途に使えるメリットがある一方で、ライブラリの管理や、プロジェクトの共同作業者が素早く環境構築をするのに面倒な思いをされている方も [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-requirements-txt-guide.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>requirements.txt でライブラリを一括インストールしたい</li>

<li>今の環境のライブラリを requirements.txt に出力したい</li>

<li>requirements.txt の書き方・バージョン指定の意味を知りたい</li>

<li>pip install -r でエラーが出て進めない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Python は他のプログラミング言語に比べて、多種多様なライブラリが存在します。</p>



<p class="wp-block-paragraph">色々な用途に使えるメリットがある一方で、ライブラリの管理や、プロジェクトの共同作業者が素早く環境構築をするのに面倒な思いをされている方も多いと思います。</p>



<p class="wp-block-paragraph"><strong>そこで便利なのが requirements.txt を使ったライブラリ管理方法</strong>です。</p>



<p class="wp-block-paragraph">使い方は簡単。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>requirements.txt の使い方</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>テキストファイルにライブラリ一覧を書く</li>



<li>pip install -r requirements.txt を実行</li>



<li>リストアップされたライブラリが全てインストールされる</li>
</ol>
</div></div>



<p class="wp-block-paragraph">この方法は、複数人プロジェクトのほか一人プロジェクトであってもメリットは大きいです。</p>



<p class="wp-block-paragraph">まだ requirements.txt を使った運用をしたことのない方は、ぜひ本記事を参考に挑戦してみてください。</p>



<h2 class="wp-block-heading">requirements.txt 関連のコマンド</h2>



<p class="wp-block-paragraph">requirements.txt の具体的な書き方の前に、よく使うコマンドをご紹介します。</p>



<p class="wp-block-paragraph">手作業でライブラリ一覧を書くこともできるものの、コマンドを知っておくとスマートなライブラリ管理ができます。</p>



<p class="wp-block-paragraph">ぜひマスターしてみてください。</p>



<h3 class="wp-block-heading">一括インストールするコマンド</h3>



<p class="wp-block-paragraph">requirements.txt に記載されているライブラリを一括でインストールするには、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install -r requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<p class="wp-block-paragraph">このコマンドを実行する前に、現在のディレクトリに requirements.txt が存在することを確認してください。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>補足：-r の意味</span></div><div class="cap_box_content">
<p class="wp-block-paragraph"><code>-r</code>は要件ファイル（requirements files）を指定するためのオプションで、一括インストールする際には必ず指定することになります。</p>
</div></div>



<h3 class="wp-block-heading">仮想環境にインストールする手順</h3>



<p class="wp-block-paragraph">requirements.txt からのインストールは、プロジェクトごとの仮想環境に対して行うのが基本です。PC 全体の Python に入れてしまうと、ほかのプロジェクトとバージョンがぶつかる原因になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 仮想環境を作って有効化（macOS / Linux）
python3 -m venv .venv
source .venv/bin/activate

# requirements.txt のライブラリをまとめてインストール
pip install -r requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 仮想環境を作って有効化（macOS / Linux）</span></span>
<span class="line"><span style="color: #DCDCAA">python3</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-m</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">venv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv</span></span>
<span class="line"><span style="color: #DCDCAA">source</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">.venv/bin/activate</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># requirements.txt のライブラリをまとめてインストール</span></span>
<span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<p class="wp-block-paragraph">Windows では、有効化のコマンドが <code>.venv\Scripts\activate</code> になります。</p>



<p class="wp-block-paragraph"><code>pip</code> コマンドが見つからない、または別の Python に入ってしまう場合は、使いたい Python から pip を呼び出す書き方にすると確実です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python3 -m pip install -r requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">python3</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-m</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<h3 class="wp-block-heading">uv を使っている場合</h3>



<p class="wp-block-paragraph">uv で管理しているプロジェクトでも requirements.txt は使えます。仮想環境に入れるだけなら <code>uv pip install</code>、プロジェクトの依存関係（pyproject.toml）として取り込むなら <code>uv add</code> を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 仮想環境にインストールする
uv pip install -r requirements.txt

# pyproject.toml の依存関係として取り込む
uv add -r requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 仮想環境にインストールする</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># pyproject.toml の依存関係として取り込む</span></span>
<span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<p class="wp-block-paragraph">uv や Poetry の基本的な使い方は、それぞれ次の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-uv-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-uv-guide/">【uv使い方から仮想環境の削除まで】Pythonパッケージ管理の完全ガイド</a>
						<span class="p-blogCard__excerpt">uv ってどんなもの？ インストール方法が知りたい 使い方を詳しく教えて欲しい 最近では、pip の代わりに uv を導入する Python プロジェクトが急増しています。 たしか&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-poetry-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-poetry-guide/">【Poetry使い方から仮想環境の削除まで】Pythonパッケージ管理の完全ガイド</a>
						<span class="p-blogCard__excerpt">Poetry ってどんなもの？ インストール方法が知りたい 使い方を詳しく教えて欲しい 最近では、pip の代わりに Poetry を導入する Python プロジェクトが増えてきました&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">現プロジェクトで使っているライブラリを requirements.txt に出力するコマンド</h3>



<p class="wp-block-paragraph">以下のコマンドを実行すると、現在の環境でインストールしたライブラリの一覧を requirements.txt として出力できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip freeze &gt; requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">freeze</span><span style="color: #D4D4D4"> &gt; </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<p class="wp-block-paragraph">すでにプロジェクトが進行していて、requirements.txt を作っていない場合に有効な方法です。</p>



<p class="wp-block-paragraph"><code>pip freeze</code> は、自分で入れたライブラリだけでなく、それらが依存しているライブラリも含めて <code>ライブラリ名==バージョン</code> の形で書き出します。</p>



<p class="is-style-icon_info wp-block-paragraph">仮想環境を有効にしないまま実行すると、PC 全体に入っているライブラリまで書き出されてしまいます。<strong>出力する前に、対象プロジェクトの仮想環境に入っているか</strong>を確認してください。</p>



<p class="wp-block-paragraph">uv で管理しているプロジェクトなら、ロックファイルの内容を requirements.txt 形式で書き出せます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv export --format requirements-txt &gt; requirements.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--format</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements-txt</span><span style="color: #D4D4D4"> &gt; </span><span style="color: #CE9178">requirements.txt</span></span></code></pre></div>



<h3 class="wp-block-heading">特定のライブラリだけをインストールする</h3>



<p class="wp-block-paragraph">specific-req.txt ファイルを作成して、この中にインストールしたいライブラリのみ記載して以下のコマンドを実行してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install -r specific-req.txt</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">specific-req.txt</span></span></code></pre></div>



<p class="wp-block-paragraph">ファイル名は specific-req.txt としましたが、やっていることは一括インストールの際の pip install -r requirements.txt と同じです。</p>



<h2 class="wp-block-heading">requirements.txt の書き方</h2>



<p class="wp-block-paragraph">前述の通り pip freeze コマンドを実行すれば、requirements.txt は自分で書かずに生成可能です。</p>



<p class="wp-block-paragraph">ここでは、より細かくライブラリ管理をしたい場合に知っておくと便利な requirements.txt の書き方をご紹介します。</p>



<h3 class="wp-block-heading">基本の書き方（1行に1ライブラリ）</h3>



<p class="wp-block-paragraph">requirements.txt は、<strong>1行に1つずつライブラリ名を書くだけのテキストファイル</strong>です。手で作る場合も、プロジェクトの直下に <code>requirements.txt</code> という名前で保存すれば使えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># Webフレームワーク
django == 4.2.*

# データ処理
pandas &gt;= 2.0, &lt; 3.0
requests</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># Webフレームワーク</span></span>
<span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">==</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">4.2</span><span style="color: #CE9178">.</span><span style="color: #569CD6">*</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># データ処理</span></span>
<span class="line"><span style="color: #DCDCAA">pandas</span><span style="color: #D4D4D4"> &gt;</span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">2.0</span><span style="color: #CE9178">,</span><span style="color: #D4D4D4"> &lt; </span><span style="color: #B5CEA8">3.0</span></span>
<span class="line"><span style="color: #DCDCAA">requests</span></span></code></pre></div>



<p class="wp-block-paragraph">行ごとに、ライブラリ名・バージョンの条件・コメントを書けます。それぞれの書き方を順に見ていきます。</p>



<h3 class="wp-block-heading">コメントの書き方</h3>



<p class="wp-block-paragraph">Python と同様、コメントは<code>#</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># コメントが記入できます。</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># コメントが記入できます。</span></span></code></pre></div>



<p class="wp-block-paragraph">つまり、<code>#</code>以降の文字列は無視されることになります。</p>



<h3 class="wp-block-heading">バージョンを指定しないでライブラリを指定</h3>



<p class="wp-block-paragraph">難しいことは考えずに requirements.txt を運用してみたい場合には、バージョン指定せずにライブラリ名を書いていく方法があります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># バージョン指定なしで記載する例
pandas
pywin32
openpyxl</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># バージョン指定なしで記載する例</span></span>
<span class="line"><span style="color: #DCDCAA">pandas</span></span>
<span class="line"><span style="color: #DCDCAA">pywin32</span></span>
<span class="line"><span style="color: #DCDCAA">openpyxl</span></span></code></pre></div>



<p class="wp-block-paragraph">ただしバージョン指定なしの場合には、コマンド実行時の最新バージョンのライブラリがインストールされてしまいます。</p>



<p class="wp-block-paragraph">そうなると、<strong>実際にどのバージョンがインストールされるか分かりません</strong>。</p>



<p class="wp-block-paragraph">つまりプロジェクトの環境が実行のタイミングごとに不安定になって、以下のようなデメリットが生じる可能性が出てきます。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>バージョン指定なしの場合の問題点</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li><strong>非互換性の問題</strong>
<ul class="wp-block-list">
<li>ライブラリのバージョンアップによって、書いたコードとの互換性がなくなる</li>
</ul>
</li>



<li><strong>安定性の問題</strong>
<ul class="wp-block-list">
<li>ライブラリの最新バージョンが不安定な場合、予期せぬバグや問題が発生する</li>
</ul>
</li>



<li><strong>再現性の問題</strong>
<ul class="wp-block-list">
<li>コマンドの実行時期によっては、同じ環境が再現できない</li>
</ul>
</li>
</ul>
</div></div>



<p class="wp-block-paragraph">というわけで、バグや予期せぬ問題を回避するためにはバージョンまで指定するのがおすすめの運用方法になります。</p>



<h3 class="wp-block-heading">バージョン指定してライブラリを指定</h3>



<p class="wp-block-paragraph">前項でご説明したとおり、requirements.txt にはバージョンまで指定しておくほうが良いです。</p>



<p class="wp-block-paragraph">バージョン指定方法はいくつかバリエーションがありますので、一つずつ解説していきます。</p>



<h4 class="wp-block-heading">厳密にバージョンを指定する方法</h4>



<p class="wp-block-paragraph">特定のバージョンを厳密に指定する場合は、<code>==</code>を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># パッチバージョンまで指定する方法
django == 3.2.1</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># パッチバージョンまで指定する方法</span></span>
<span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">==</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span><span style="color: #CE9178">.1</span></span></code></pre></div>



<p class="wp-block-paragraph">上記では 3.2.1 だけがインストール対象になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 3.2 系の最新パッチを入れたい場合
django == 3.2.*</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 3.2 系の最新パッチを入れたい場合</span></span>
<span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">==</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span><span style="color: #CE9178">.</span><span style="color: #569CD6">*</span></span></code></pre></div>



<p class="wp-block-paragraph">末尾に <code>.*</code> を付けると、3.2.1 や 3.2.25 のような 3.2 系のパッチ版のうち、最も新しいものがインストールされます。</p>



<p class="wp-block-paragraph"><code>.*</code> を付けずに <code>django == 3.2</code> と書くと、3.2（3.2.0）だけに一致し、パッチ版は対象外になる点に注意してください。パッチはバグやセキュリティ修正がされたものなので、マイナーバージョンで固定したい場合は <code>.*</code> を付ける書き方がおすすめです。</p>



<h4 class="wp-block-heading">特定のバージョン「以上」を指定する</h4>



<p class="wp-block-paragraph">特定のバージョン以上を指定する場合は、<code>&gt;=</code>とします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django &gt;= 3.2</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> &gt;</span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合は、django の 3.2 以上のバージョンがインストールされることになります。</p>



<p class="wp-block-paragraph">例えば django の最新バージョンが 3.2 以上なら、現在取得できる最新のバージョンがインストールされます。</p>



<p class="is-style-icon_announce wp-block-paragraph">つまり、バージョン指定しなかった場合と同じ挙動になります。</p>



<h4 class="wp-block-heading">特定のバージョン「以下」を指定する</h4>



<p class="wp-block-paragraph">特定のバージョン以下を指定する場合、<code>&lt;=</code>とします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django &lt;= 3.2</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> &lt;</span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合は、以下の挙動になります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>3.2 以下のバージョンのうち、最も新しいものがインストールされる</li>

<li>3.2.1 などのパッチ版は 3.2 より大きいので対象外になる</li>
</ul>
</div></div>



<h4 class="wp-block-heading">特定のバージョンだけはインストールしたくない</h4>



<p class="wp-block-paragraph">特定のバージョンを除外する場合は、<code>!=</code>とします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django != 3.2.1</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">!=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span><span style="color: #CE9178">.1</span></span></code></pre></div>



<p class="wp-block-paragraph">特定のバージョンにバグなどがある場合に有効です。</p>



<p class="wp-block-paragraph">ただし、このような指定はあまり一般的ではないかと思います。基本的には他の方法でバージョン指定することを推奨します。</p>



<h4 class="wp-block-heading">互換性のある範囲を指定する（~=）</h4>



<p class="wp-block-paragraph"><code>~=</code> は「互換性のあるリリース」を表す指定です。<code>django ~= 3.2.0</code> と書くと、3.2.0 以上で 3.2 系に収まるバージョンが対象になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django ~= 3.2.0</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">~=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span><span style="color: #CE9178">.0</span></span></code></pre></div>



<h4 class="wp-block-heading">上限と下限をまとめて指定する</h4>



<p class="wp-block-paragraph">カンマで区切ると、複数の条件を同時に満たすバージョンだけが対象になります。メジャーバージョンが上がると互換性が崩れやすいので、上限を付けておくと安心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>django &gt;= 3.2, &lt; 4.0</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">django</span><span style="color: #D4D4D4"> &gt;</span><span style="color: #CE9178">=</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">3.2</span><span style="color: #CE9178">,</span><span style="color: #D4D4D4"> &lt; </span><span style="color: #B5CEA8">4.0</span></span></code></pre></div>



<h4 class="wp-block-heading">指定ごとの違いを比べる</h4>



<p class="wp-block-paragraph">それぞれの書き方で、どのバージョンが対象になるかを比べた結果です。pip に同梱されている packaging で判定しました。</p>



<figure class="wp-block-table"><table><thead><tr><th>指定</th><th>3.1.14</th><th>3.2</th><th>3.2.1</th><th>3.2.25</th><th>4.0</th></tr></thead><tbody><tr><td><code>== 3.2</code></td><td>×</td><td>○</td><td>×</td><td>×</td><td>×</td></tr><tr><td><code>== 3.2.*</code></td><td>×</td><td>○</td><td>○</td><td>○</td><td>×</td></tr><tr><td><code>~= 3.2.0</code></td><td>×</td><td>○</td><td>○</td><td>○</td><td>×</td></tr><tr><td><code>&gt;= 3.2</code></td><td>×</td><td>○</td><td>○</td><td>○</td><td>○</td></tr><tr><td><code>&lt;= 3.2</code></td><td>○</td><td>○</td><td>×</td><td>×</td><td>×</td></tr><tr><td><code>!= 3.2.1</code></td><td>○</td><td>○</td><td>×</td><td>○</td><td>○</td></tr><tr><td><code>&gt;= 3.2, &lt; 4.0</code></td><td>×</td><td>○</td><td>○</td><td>○</td><td>×</td></tr></tbody></table><figcaption class="wp-element-caption">○ が対象になるバージョン</figcaption></figure>



<p class="wp-block-paragraph">実際にインストールされるのは、○ のうち PyPI で公開されている最も新しいバージョンです。</p>



<h3 class="wp-block-heading">別の requirements ファイルを読み込む</h3>



<p class="wp-block-paragraph">開発時だけ使うライブラリ（テストツールなど）を分けたいときは、requirements ファイルの中に <code>-r ファイル名</code> を書くと、別のファイルを読み込めます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># requirements-dev.txt
-r requirements.txt
pytest</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># requirements-dev.txt</span></span>
<span class="line"><span style="color: #DCDCAA">-r</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">requirements.txt</span></span>
<span class="line"><span style="color: #DCDCAA">pytest</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合、<code>pip install -r requirements-dev.txt</code> を実行すると、requirements.txt の内容と pytest がまとめてインストールされます。本番環境では requirements.txt だけを使う、という使い分けができます。</p>



<h2 class="wp-block-heading">pip install -r でよくあるエラー</h2>



<p class="wp-block-paragraph">requirements.txt からのインストールでつまずきやすいエラーと、その対処方法です。表示は pip 25.0.1 で確認したもので、バージョンによって細かい文言が変わることがあります。</p>



<h3 class="wp-block-heading">Could not open requirements file</h3>



<p class="wp-block-paragraph">指定した requirements.txt が見つからないときのエラーです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ERROR: Could not open requirements file: &#91;Errno 2&#93; No such file or directory: 'requirements.txt'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ERROR: Could not open requirements file: [Errno 2] No such file or directory: &#039;requirements.txt&#039;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>pip install -r requirements.txt</code> は、<strong>今いるディレクトリにある requirements.txt</strong> を探します。<code>cd</code> でプロジェクトの直下に移動してから実行するか、<code>pip install -r path/to/requirements.txt</code> のようにパスを指定してください。</p>



<h3 class="wp-block-heading">Invalid requirement（書式の誤り）</h3>



<p class="wp-block-paragraph">バージョン指定の書き方が間違っていると、インストールが始まる前に止まります。よくあるのは、<code>==</code> のつもりで <code>=</code> を1つだけ書いてしまうケースです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ERROR: Invalid requirement: 'django = 3.2': Expected end or semicolon (after name and no valid version specifier)
    django = 3.2
           ^ (from line 1 of requirements.txt)
Hint: = is not a valid operator. Did you mean == ?</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ERROR: Invalid requirement: &#039;django = 3.2&#039;: Expected end or semicolon (after name and no valid version specifier)</span></span>
<span class="line"><span style="color: #D4D4D4">    django = 3.2</span></span>
<span class="line"><span style="color: #D4D4D4">           ^ (from line 1 of requirements.txt)</span></span>
<span class="line"><span style="color: #D4D4D4">Hint: = is not a valid operator. Did you mean == ?</span></span></code></pre></div>



<p class="wp-block-paragraph">エラーには何行目で失敗したかが表示されるので、その行の演算子（<code>==</code>・<code>&gt;=</code> など）を見直してください。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">requirements.txt を使えば、<code>pip install -r requirements.txt</code> の1行で同じライブラリ構成を再現できます。仮想環境の中で <code>pip freeze</code> で書き出し、必要に応じて <code>== 3.2.*</code> のようにバージョンを固定しておくと、環境の差によるトラブルを減らせます。</p>



<p class="wp-block-paragraph">pip そのものの使い方は、こちらの記事でまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-pip/">【Python】パッケージ管理ツール pip の使い方</a>
						<span class="p-blogCard__excerpt">外部ライブラリやフレームワークを使いたい！ Python の魅力の一つが豊富な外部ライブラリやフレームワークの存在です。 これらの外部ライブラリなどをインストールする&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">参考サイト</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><a href="https://pip.pypa.io/en/latest/">pip documentation</a></li>

<li><a href="https://pip.pypa.io/en/stable/reference/requirements-file-format/">Requirements File Format（pip documentation）</a></li>

<li><a href="https://packaging.python.org/en/latest/specifications/version-specifiers/">Version specifiers（Python Packaging User Guide）</a></li>
</ul>
</div></div>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
