3つ目の言語に触ると、言語の性質と一般的な考え方の区別がはっきりします。OSのPythonを直接触らない理由も、ここで押さえます。
前回: gRPCはcurlで叩けない — 関数を呼ぶようにAPIを呼ぶ 作業場所はVMの中(Ubuntu)です。Node.jsでHTTPサーバーを書く|サーバーが待ち続ける仕組みの
~/server/と、Goで同じAPIを書く|Node.jsとの違いと単一実行ファイルの~/go-server/を、隣に置いて見比べます。
Goの回で、こう書きました。
1つしか知らないと、「言語の性質」と「プログラミング一般」の区別が付かない。
あれは正しかったのですが、半分でした。
2つ触ると、確かに線は引けます。 JavaScript と Go で違っていたところが「言語の性質」、同じだったところが「サーバーというものの性質」でした。
ただ、2つでは「地図」になりません。 なぜなら、こう思い込むからです。
世界には「Node.js みたいな言語」と「Go みたいな言語」があるのだな。 つまり、コンパイルしないで型を書かない側か、コンパイルして型を書く側か、2つに分かれているのだな。
分かれていません。 これは、たまたま2点を結んだだけの直線です。
点が2つなら、必ず直線が引けてしまいます。 それが本当に線なのか、実は面なのかは、3点目を置くまで分かりません。
そして Python は、その3点目として、かなり意地の悪い場所に立っています。
| コンパイルするか | 型を書くか | |
|---|---|---|
| Node.js | しない | 書かない |
| Go | する | 書く |
| Python | しない | 書かない。ただし、書ける |
Node.js 寄りに見えて、Go 側の性質も持っています。 つまり 「2つに分かれている」という思い込みが、ここで壊れます。
この記事は Python の入門ではありません。 やることはGoの回とまったく同じです。
すでに動いているものと、まったく同じものを、3つ目の言語でもう一度書く。
そして今回は、もう1つだけ足します。
3つの言語で同じ計算を回して、実行時間を測る。
「Python は遅い」は、たぶん聞いたことがあると思います。 それを人から聞いた話ではなく、自分のVMで出た秒数として持つのが、この記事の山場です。
そのうえで、「遅い=駄目」ではない理由まで書きます。そこまで行かないと、ただの悪口になります。
対象レベル: 初級〜中級 / 区分: 必修
この記事でわかること
- 言語は2種類ではないこと。2つ目までは直線、3つ目で面になる。Python は Node.js と Go のどちらの側にも綺麗に入らない
- Ubuntu 自身が Python で動いていること。だから
sudo pip installはOSを壊す。Ubuntu 24.04 はそれをエラーで止めてくれる(止めてくれることが正常) - インデントが飾りではなく文法であること。ズレると動作が変わる、ではなくエラーになる
- 型は書かなくていいが、書けること。ただし Python の型ヒントは実行時に何も検査しない(TypeScriptと同じ立場)
- 同じループが Go の数十倍遅いこと。そして
sum(range(...))にすると急に速くなること。遅いのは Python のループであって、Python の全部ではない - 「遅い」が問題になるかどうかは、何に時間を使っているかで決まること。動く時間より、書く時間のほうが高くつく場面がある
- 9つの言語を4象限に置いた地図。そして 「次に何を学ぶか」は、作りたいもので決まること
この記事でやること
- Ubuntu に最初から入っている
python3を確認し、sudo pip installをわざと踏んで、止められる venvを作る(ここから先は全部その中でやります)- サーバーとは何かの回と同じサーバーを、標準ライブラリだけで書く。Node.js版・Go版と3列で並べる
- 同じ計算ループを3つの言語で書いて、実行時間を測る
- FastAPI で
/api/tasksを返し、3つのポートから同じJSONが返ることを確かめる - 9つの言語を4象限に置いて、地図を作る
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| インタプリタ | ソースコードを上から1行ずつ読んで、その場で実行していくプログラム。python3 も node もこれです。Goの回のコンパイルとは逆の考え方です。 |
pip | Python のライブラリを入れる道具。npm の回の npm にあたる位置です。 |
venv(仮想環境) | そのプロジェクト専用の、Python とライブラリの置き場をフォルダとして作る仕組み。中で pip install しても、OS側には1ファイルも入りません。 |
| 型ヒント | Python で def f(x: int) -> str: のように型を書いておける注釈。書いても書かなくても動きます。 |
| PEP 8 | Python の書き方の公式な取り決め(インデントは半角スペース4つ、など)。ESLintとPrettierの回で決めていたことが、最初から文書になっています。 |
| FastAPI | Python でAPIを書くためのライブラリ。型ヒントを実際に使うのが特徴で、APIの回の Express にあたる位置です。 |
ASGI / uvicorn | FastAPI が書いたアプリを、実際にポートを掴んで動かす担当。FastAPI 単体ではポートを掴みません。 |
① Ubuntu の Python は、OSの部品です
まず、入っていることを確認します。入れません。
Python 3.12.3
/usr/bin/python3
Goの回では、公式サイトから tar.gz を落として自分で入れました。Python は、その作業がありません。 最初から入っています。
そして、ここが今日いちばん危険なところです。
その
python3は、あなたのためのものではありません。Ubuntu のためのものです。
確かめられます。
#!/usr/bin/python3
apt の回で使った add-apt-repository は、Python のスクリプトです。 Linuxの基本コマンドの回で見た #! の行が、/usr/bin/python3 を指しています。
つまり、こうです。
/usr/bin/python3とそのライブラリを壊すと、Ubuntu の管理ツールが動かなくなります。
node を壊しても、Ubuntu は何も困りません。 npm の回で nvm を使ってホームディレクトリの下に入れたので、OSとは完全に分かれています。Python は違います。
sudo pip install をわざと踏む
多くの入門記事に、こう書いてあります。
sudo pip install なにか
打たないでください。 ただし、Ubuntu 24.04 なら打っても止まるので、何が起きるかだけ見ます。
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you want to install.
If you wish to install a non-Debian-packaged Python package,
create a virtual environment using python3 -m venv path/to/venv.
エラーです。そして、これは正常な動作です。
| 言っていること | 意味 |
|---|---|
externally managed | この Python は外部(apt)が管理している。 pip が勝手に触る場所ではない |
try apt install python3-xyz | OSに必要なものなら、apt で入れなさい |
create a virtual environment | 自分のプログラムのためなら、venv を作りなさい |
[スクリーンショット: 01_pip_externally_managed.png] VMのターミナルで pip install requests を実行し、error: externally-managed-environment が出ている画面を撮ってください。
このエラーには
--break-system-packagesという回避策があります。使わないでください。 オプションの名前が、そのまま「システムのパッケージを壊す」と言っています。 冗談ではなく、壊れたときの症状は「aptが動かない」です。OSの入れ直しになります。昔の Ubuntu には、この停止装置がありませんでした。 だから「
sudo pip installで入れた」という古い記事が大量に残っています。そのとおりに打って壊した人がいたから、この装置が付きました。
venv を作る
エラーが指示したとおりにします。
bin include lib lib64 pyvenv.cfg
~/py-server/.venv/ の下に、このプロジェクト専用の Python 一式ができました。
「入る」のはここからです。
プロンプトの先頭が変わります。
(.venv) user@ubuntu:~/py-server$
(.venv) が付いていたら、中にいます。 確かめます。
/home/user/py-server/.venv/bin/python
/home/user/py-server/.venv/bin/pip
/usr/bin/python3 ではなくなりました。 この状態で pip install しても、入るのは ~/py-server/.venv/ の中だけです。
| コマンド | 何をしているか |
|---|---|
python3 -m venv .venv | .venv という名前でフォルダを作る(-m は「このモジュールを実行して」) |
source .venv/bin/activate | いま開いているシェルの PATH の先頭に .venv/bin を差し込む。 Goの回で ~/.profile に足したのと、やっていることは同じです |
deactivate | 出る。 PATH が元に戻ります |
.venvはnode_modulesと同じ扱いでいいと考えてください。npm の回で「node_modulesは消してよい」と書いたのと同じで、.venvも消して作り直せます。 Git に上げるものでもありません。違うのは、
.venvの中には Python 本体(へのリンク)ごと入っていることです。node_modulesはライブラリだけでした。Python はライブラリだけを分離できないので、実行環境ごと複製します。
ターミナルを開き直したら、毎回これを打ちます。
忘れると、そのまま /usr/bin/python3 を触ります。 この記事の残りは、全部 (.venv) が付いた状態で打ってください。
② 同じサーバーを、Python で書く
比較対象を2つ、先に出します。
サーバーとは何かの回の Node.js:
const http = require("node:http");
const server = http.createServer((req, res) => {
console.log(`${req.method} ${req.url}`);
res.writeHead(200, { "Content-Type": "text/html; charset=UTF-8" });
res.end("<h1>Node.js が返しています</h1>");
});
server.listen(3000, "0.0.0.0", () => {
console.log("http://0.0.0.0:3000/ で待っています");
});
Goの回の Go:
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
log.Printf("%s %s", r.Method, r.URL.Path)
w.Header().Set("Content-Type", "text/html; charset=UTF-8")
fmt.Fprint(w, "<h1>Go が返しています</h1>")
})
log.Println("http://0.0.0.0:8080/ で待っています")
log.Fatal(http.ListenAndServe("0.0.0.0:8080", nil))
}
Python で書きます。
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
print(f"{self.command} {self.path}")
self.send_response(200)
self.send_header("Content-Type", "text/html; charset=UTF-8")
self.end_headers()
self.wfile.write("<h1>Python が返しています</h1>".encode("utf-8"))
server = HTTPServer(("0.0.0.0", 8000), Handler)
print("http://0.0.0.0:8000/ で待っています")
server.serve_forever()
Python は未習の前提なので、1行ずつ説明します。
| 行 | 何をしているか |
|---|---|
from http.server import ... | 標準ライブラリから2つ取り込む。 require / import にあたります。pip install は不要(最初から入っています) |
class Handler(BaseHTTPRequestHandler): | 「リクエストが来たときの担当」を、既存の部品を土台にして作る。 (...) の中が土台です |
def do_GET(self): | GET が来たときに呼ばれるメソッド。 名前が do_GET であること自体が仕様で、土台がこの名前を探しに来ます |
self | その担当自身。 JavaScript の this にあたりますが、Python は引数として自分で書きます |
print(f"...") | console.log にあたります。f"..." は文字列の中に {} で値を埋められる書き方(テンプレートリテラルと同じ) |
self.send_response(200) | ステータス行を書く |
self.send_header(...) / self.end_headers() | ヘッダーを1つずつ書いて、最後に「終わり」を書く。 res.writeHead が1回でやっていたことを、2段階に分けています |
self.wfile.write(...) | 本文を書き込む。 res.end / fmt.Fprint(w, ...) にあたります |
.encode("utf-8") | 文字列をバイト列に変換する。 ここは省略できません(後述) |
HTTPServer(("0.0.0.0", 8000), Handler) | ポートを掴む担当を作る。 ("0.0.0.0", 8000) の二重カッコはタプル(2つ組)です |
server.serve_forever() | 待つ。 listen / ListenAndServe にあたります |
動かします。
http://0.0.0.0:8000/ で待っています
8000番を開けます。別のターミナルで:
ホストのブラウザで http://192.168.226.50:8000/ を開いてください(IPは自分のVMの値に。VMの中で ip a)。
「Python が返しています」と出ます。
3列に並べる
ここが、この記事の中心です。
| やること | Node.js | Go | Python |
|---|---|---|---|
| ① ポートを掴む | server.listen(3000, "0.0.0.0") | http.ListenAndServe("0.0.0.0:8080", nil) | HTTPServer(("0.0.0.0", 8000), Handler) |
| ② 待つ | listen 後、終了しない | ListenAndServe から戻らない | server.serve_forever() |
| ③ 受ける | createServer((req, res) => ...) | http.HandleFunc("/", func(w, r) ...) | class Handler の do_GET |
| ④ 返す | res.writeHead / res.end | w.Header().Set / fmt.Fprint | send_response / send_header / wfile.write |
| ライブラリの追加 | 不要(node:http) | 不要(net/http) | 不要(http.server) |
| 同時に来た要求 | 1本の流れで回す | リクエストごとに goroutine | 1本ずつ、順番に(標準の HTTPServer は同時に1つ) |
書き方は3つとも全部違います。そして、左端の列は1つも変わっていません。
Goの回で「掴む・待つ・受ける・返す は言語が変わっても同じ」と書きました。 3つ目でも同じでした。 2点なら偶然かもしれませんが、3点そろうと、これは偶然ではないと言えます。 これが「3つ目を触る」の一番の収穫です。
[スクリーンショット: 02_3つのサーバーが同時に動く.png] VMのターミナルを3つ並べ、3000番(Node.js)・8080番(Go)・8000番(Python)が同時に待っている画面を撮ってください。
Goの回を後片づけして Go を消した人は、Go の列を飛ばして構いません。 Node.js と Python の2つでも、この記事は成立します。
③ 驚いた順に、違いを並べる
1. インデントが、文法です
これが一番驚きます。 さっきの server.py の def do_GET(self): の中身を、わざと1段戻します。
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
print(f"{self.command} {self.path}")
File "/home/user/py-server/server.py", line 6
print(f"{self.command} {self.path}")
^
IndentationError: expected an indented block after function definition on line 5
動きません。 IndentationError という名前のエラーが、言語そのものから返ってきます。
JavaScript や Go では、こう書けます。
function f() {
console.log("これでも動く");
}
動きます。 { と } が範囲を決めていて、インデントは人間のための飾りだからです。だからESLintとPrettierの回で、「見た目を後から機械に揃えさせる」という作業が必要でした。
Python には { } がありません。 段の深さが、そのまま範囲です。
| 範囲を決めているもの | インデントを間違えたら | |
|---|---|---|
| JavaScript | { } | 動く。 読みにくいだけ |
| Go | { } | 動く。 ただし gofmt が勝手に直す |
| Python | インデントそのもの | 動かない。 または別の意味になる |
「別の意味になる」のほうが怖いです。
for t in tasks: print(t) print("ループが終わりました")この
print("ループが終わりました")は、ループの中です。1段戻せば外になります。どちらも文法として正しいので、エラーは出ません。 出力の回数だけが変わります。タブと半角スペースを混ぜると、見た目が同じでも別の深さとして扱われ、Python 3 では多くの場合 TabError で止まります。PEP 8 は「半角スペース4つ」と決めています。エディタの設定をそれに合わせてください。
戻して、動くことを確認してください。
2. 型は、書かなくていい。でも書ける
server.py のどこにも型は出てきません。 Goの回の func(w http.ResponseWriter, r *http.Request) とは対照的です。
でも、書けます。
def add(a: int, b: int) -> str:
return a + b
あい
int と書いてあるのに文字列を渡して、str を返すと書いてあるのに文字列を足しています。 何のエラーも出ません。
Python の型ヒントは、実行時に一切検査されません。 ただのメモです。
これは、どこかで見た形です。
| 型を書くと、いつ守られるか | |
|---|---|
| TypeScript | tsc が検査する。 実行時には型が消える(TypeScriptの回) |
| Python の型ヒント | 標準では、誰も検査しない。 mypy などの別の道具を入れて初めて検査される |
| Go | コンパイラが検査する。 通らなければ実行ファイルができない |
TypeScriptの回で「型は実行時には消える」と書きました。 Python の型ヒントは、そもそも最初から効いていません。
では無意味かというと、そうではありません。 エディタが読みます。 VS Code は型ヒントを見て補完を出し、間違いに下線を引きます(VS Code Remote の回の環境でそのまま効きます)。 そして、後で出てくる FastAPI は、この型ヒントを実際に使います。 「ただのメモ」を道具側が読んで意味を持たせる、という作りです。
3. 動くのが遅い
ここは節を分けます。次の章です。
4. ライブラリの層が、異様に厚い
server.py は標準ライブラリだけで書けました。それ自体は Go も同じです。
違うのは、その先です。
全部、最初から入っています
| 何をしたいか | Node.js | Python |
|---|---|---|
| JSONを読む | 標準 | 標準(json) |
| CSVを読む | ライブラリを入れる | 標準(csv) |
| SQLiteを触る | ライブラリを入れる(Node.js 22.13 以降は標準の node:sqlite もある。まだ安定版ではない) | 標準(sqlite3)。データベースの選び方の回で触ったものが最初から使えます |
| ZIPを展開する | ライブラリを入れる | 標準(zipfile) |
| 平均・中央値を出す | 自分で書く | 標準(statistics) |
Python には「電池付き(batteries included)」という言い方があります。 標準ライブラリだけで、かなりの仕事が終わるという意味です。
これは思想の違いです。 npm の回で
node_modulesが数百MBになったのを見ました。 JavaScript は小さい部品を大量に積む文化です。入れ替えやすい代わりに、依存が増えます。 Python は、逆側に寄っています。 標準に厚く入れて、外部ライブラリの数を減らす方向です。どちらが良いという話ではありません。 ただし、パッケージ管理の回で見た「依存が深いほど壊れやすい」は、Python では起きにくいとは言えます。
④ 3つの言語で、同じ計算を測る
ここまで見た違いは「書き方」でした。ここからは「動いた結果」です。
5000万回の足し算を、3つの言語でやらせます。
Python
import time
start = time.perf_counter()
total = 0
for i in range(50_000_000):
total += i
elapsed = time.perf_counter() - start
print(total, f"{elapsed:.3f} 秒")
| 部分 | 意味 |
|---|---|
time.perf_counter() | 計測用の時計を読む。 差を取ると経過秒数になります |
50_000_000 | _ は桁区切り。 読みやすくするためだけのもので、値は 5000万 です(JavaScript も同じ書き方ができます) |
range(n) | 0 から n-1 までを順に出すもの |
f"{elapsed:.3f}" | 小数点以下3桁にして埋め込む |
Node.js
const start = process.hrtime.bigint();
let total = 0;
for (let i = 0; i < 50_000_000; i++) {
total += i;
}
const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
console.log(total, elapsed.toFixed(3) + " 秒");
Go
package main
import (
"fmt"
"time"
)
func main() {
start := time.Now()
total := 0
for i := 0; i < 50000000; i++ {
total += i
}
fmt.Println(total, time.Since(start))
}
Go を消した人は、ここは飛ばして構いません。 Node.js と Python の2つだけでも、差は十分に見えます。
走らせる
この記事の実機(VMに2コア割り当て)ではこうなりました。
1249999975000000 3.412 秒
1249999975000000 0.052 秒
1249999975000000 22.9075ms
数字は環境で変わります。比べるのは「桁」です。
| 言語 | 経過時間 | Go を 1 としたとき |
|---|---|---|
| Go | 約 0.023 秒 | 1 |
| Node.js | 約 0.052 秒 | 約 2 |
| Python | 約 3.4 秒 | 約 150 |
[スクリーンショット: 03_3言語の実行時間.png] VMのターミナルで python3 bench.py / node bench.js / ./bench-go を続けて実行し、3つの秒数が縦に並んでいる画面を撮ってください。
まず、答えの 1249999975000000 が3つとも同じであることを見てください。やっている計算は、完全に同じです。
なぜこの差が出るのか
| 何が起きているか | |
|---|---|
| Go | 先に機械語にしてある。 ループは、CPUがそのまま回している |
| Node.js | 最初は1行ずつ読むが、同じ場所を何度も通ると、その部分を機械語に変換して差し替える(JIT と呼びます)。だからループは途中から速くなります |
| Python | 標準の python3 は、それをしません。 5000万回とも、1回ずつ「次は何をする命令か」を読み直しています |
さらに、Python では total += i の i も total も、ただの数字ではありません。 型や参照数などを持った箱です。足し算1回ごとに、その箱を開けて、中身を足して、新しい箱を作っています。
「Python が遅い」の正体は、だいたいこれです。
ただし、これは Python の全部ではない
同じ答えを、書き方を変えて出します。
1249999975000000 0.941 秒
3.4秒が 0.9秒になりました。 書いた行は短くなっています。
なぜか。
sum()とrange()の中身は、Python ではありません。C言語で書かれて、コンパイル済みです。 ループを Python で回すのをやめて、「5000万回足して」と一言で C に投げたからです。
これが、Python という言語の設計そのものです。
| 層 | 何語で書かれているか | 速さ |
|---|---|---|
| あなたが書く部分 | Python | 遅い |
| 標準ライブラリ・数値計算ライブラリの中身 | C | 速い |
「Python は遅い」は正しく、「Python で書いた処理は必ず遅い」は間違いです。 重い部分を、いかに自分で書かないかが Python の書き方になります。
「遅い=駄目」ではない理由
ここが、この記事で一番言いたいところです。
さっきの表を、別の軸で書き直します。
| 書くのにかかった時間 | 動くのにかかった時間 | |
|---|---|---|
| Python | 6行 | 3.4 秒 |
| Node.js | 8行 | 0.05 秒 |
| Go | 15行(package / import / func main が要る) | 0.02 秒 |
このプログラムを1回しか動かさないなら、どれが一番安いでしょうか。
書く時間が9行ぶん少ないほうです。 3.4秒は、そのぶんを取り返せません。
極端な例に見えるかもしれませんが、実務ではこちらのほうが多いです。
| 場面 | 効いてくるのは |
|---|---|
| 1日1回動く集計スクリプト | 書く時間。 実行が3秒でも30秒でも、誰も困らない |
| 1回きりのデータ整形 | 書く時間。 動くのは一度だけ |
| 秒間1000リクエストを捌くAPI | 動く時間。 1リクエスト1msの差が、そのままサーバー台数になる |
| 常駐して、CPUを回し続ける処理 | 動く時間 |
そして、もう1つ大事なことがあります。
APIサーバーの時間は、ほとんど「待ち」です。
パフォーマンス改善の回で見たとおり、遅いAPIの原因はたいていデータベースです。 MySQLの回のクエリが 50ms かかっているとき、言語側の処理が 0.05ms か 3ms かは、ほとんど見えません。
測る前に言語を変えるのは、パフォーマンス改善の回で「速くする前に必ず測る」と書いたことに、真正面から違反しています。
⑤ FastAPI で /api/tasks を返す
最後に、APIの回と同じものを返します。
ここで初めて、外部ライブラリを入れます。 必ず venv の中で打ってください。
入った場所を確認します。
Name: fastapi
Version: 0.115.6
Location: /home/user/py-server/.venv/lib/python3.12/site-packages
20M
Location: がホームディレクトリの下です。OS側には1ファイルも入っていません。
from fastapi import FastAPI
app = FastAPI()
tasks = [
{"id": 1, "title": "Linuxのコマンドを覚える", "done": True},
{"id": 2, "title": "サーバーを立てる", "done": True},
{"id": 3, "title": "APIを作る", "done": False},
]
@app.get("/api/tasks")
def get_tasks():
return tasks
これで全部です。
| 行 | 意味 |
|---|---|
app = FastAPI() | アプリを1つ作る。Express の const app = express() にあたります |
tasks = [ {...}, ... ] | 辞書({})の配列。 JavaScript のオブジェクトとほぼ同じ書き方です。True / False が大文字始まりなのが Python の決まり |
@app.get("/api/tasks") | 次の関数を、GET のこのパス担当として登録する。 @ で始まる行はデコレータと呼びます |
def get_tasks(): | 中身。return tasks と書くだけで、FastAPI が JSON に変換してヘッダーまで付けます |
動かします。
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
| 部分 | 意味 |
|---|---|
api:app | api.py の中の app という変数を動かせ、という指定 |
--host 0.0.0.0 | サーバーとは何かの回と同じで、外から届くようにする |
api.pyの中に、ポート番号もアドレスも書いていません。 FastAPI はポートを掴みません。 掴むのはuvicornです。「どう返すか」と「どう待つか」が、別の担当に分かれています。 Goの回のListenAndServeや、APIの回のapp.listen(3000)は、同じプログラムの中にありました。 ここも「言語の性質ではなく、そのライブラリの流儀」です。
別のターミナルで叩きます。
[
{
"id": 1,
"title": "Linuxのコマンドを覚える",
"done": true
},
{
"id": 2,
"title": "サーバーを立てる",
"done": true
},
{
"id": 3,
"title": "APIを作る",
"done": false
}
]
3つ並べます。 3000番(Node.js)と 8080番(Go)も動かした状態で:
3つとも完全に同じです
[スクリーンショット: 04_3つとも同じJSON.png] diff が何も出さず「3つとも完全に同じです」と表示されている画面を撮ってください。
diffが何も出さない、というのがこの記事の結論です。 gRPCの回で「呼ばれる側が何語で書かれているかは、呼ぶ側には関係ない」と書きました。 ここで実物になりました。 REST APIの設計の回で決めた形さえ守られていれば、中身の言語は入れ替えられます。
おまけ: 型ヒントが仕事をするところ
さっき「型ヒントは誰も検査しない」と書きました。FastAPI は例外です。
api.py に1つ足します。
@app.get("/api/tasks/{task_id}")
def get_task(task_id: int):
for t in tasks:
if t["id"] == task_id:
return t
return {"error": "not found"}
{
"id": 2,
"title": "サーバーを立てる",
"done": true
}
{
"detail": [
{
"type": "int_parsing",
"loc": ["path", "task_id"],
"msg": "Input should be a valid integer, unable to parse string as an integer"
}
]
}
abc を渡すと 422 で断られました。 task_id: int と書いただけです。検査するコードは1行も書いていません。
REST APIの回のつまずき表に「
req.params.idが文字列で困る」と書きました。 TypeScriptの回でも、同じ話をしました。URLから来る値は必ず文字列です。 FastAPI は、型ヒントを読んで、実際に変換と検査をします。 「言語が検査しないメモ」を、ライブラリが拾って使っているわけです。Python らしいやり方です。
自動でドキュメントも出ます。 ブラウザで http://192.168.226.50:8000/docs を開いてください。
[スクリーンショット: 05_fastapi_docs.png] ホストのブラウザで /docs を開き、/api/tasks が一覧に出ている画面を撮ってください。
⑥ Python が強い場所
「言語は目的で選ぶ道具」というのがGoの回の結論でした。では Python の目的は何か。
| 分野 | なぜ Python なのか |
|---|---|
| データ処理・集計 | 標準の csv / sqlite3 / statistics だけで大半が終わる。 重い部分は C で書かれたライブラリが持つ |
| 機械学習・LLM | 主要なライブラリが、事実上ここにしか無い。 RAGの回で扱った埋め込みの計算も、本来の主戦場はこちらです |
| 自動化スクリプト | python3 が最初から入っている。 相手のサーバーに何も入れずに置いて動かせる |
| 科学計算 | 研究分野で長く使われてきた蓄積がある |
共通しているのは、こうです。
「重い計算は C で書かれた部品にやらせて、Python はその指示書を書く」という形が成立する分野。
さっき sum(range(...)) で 3.4秒 が 0.9秒 になったのと、まったく同じ構造です。
では、なぜこのサイトの scripts/ は Node.js なのか
このサイトの記事は、scripts/post-draft.mjs という Node.js のプログラムで WordPress に投稿しています。
Python でも、まったく同じものが書けます。 それでも Node.js にしている理由は、1つだけです。
フロントエンドを JavaScript で書いているから。
| もし Python にしたら | |
|---|---|
| 覚えること | 1つ増える。 書き方も、ライブラリの入れ方も、venv も |
| 得られるもの | ほぼ無い。 やっているのは Markdown を HTML にして HTTP で送るだけで、重い計算は1つも無い |
逆に、もしこのサイトが「記事のアクセスログを集計してグラフを出す」ことを始めるなら、そこは Python で書きます。 その部分だけ、Python が明確に得意だからです。
言語は、プロジェクト単位で1つに決めるものではありません。 仕事単位で選べます。 Goの回で見たとおり、HTTPで繋がっていれば、中身の言語は揃っていなくていいからです。
⑦ 言語の地図
3点そろったので、面を描きます。
縦軸を「コンパイルするか」、横軸を「型を書くか」にします。
| 型を書かない | 型を書く | |
|---|---|---|
| 先にコンパイルする | (ほぼ無い) | Go / Rust / C / Java / TypeScript |
| その場で実行する | JavaScript(Node.js) / Python / PHP / Ruby | (Python の型ヒントはここに片足) |
それぞれ1行で書きます。
| 言語 | どんな言語か |
|---|---|
| JavaScript(Node.js) | ブラウザで動く唯一の言語。そのままサーバー側でも書けるのが最大の強み。このサイトの本線 |
| TypeScript | JavaScript に型を足しただけ。コンパイルはするが、型を消しているだけ(TypeScriptの回) |
| Go | 実行ファイル1つで動く。 書き方が1つに決まっている。インフラの道具がほぼこれ(Docker も Kubernetes も)(Goの回) |
| Python | 書くのが速く、動くのが遅い。 重い部分は C の部品に投げる設計。データ処理と機械学習は、ほぼ一択 |
| Java | 型が厳格で、大きな組織・長く動くシステムに多い。Android アプリの土台でもある |
| PHP | Webサーバーの中で動くことに特化して生まれた。WordPress がこれ(このサイト自身が動いているのも PHP です) |
| Ruby | 「書いていて気持ちがいいこと」を優先した設計。Rails でWebアプリを速く作る用途が中心 |
| Rust | メモリの安全性をコンパイル時に保証する。 速さは C 並み。そのぶん、覚えることが多い |
| C | OSやドライバを書くための言語。 Python も Node.js も、中身は C で書かれています |
この地図は、あくまで入口です。 Python は型ヒントを書けますし、JavaScript もTypeScriptを足せます。Java も型推論を持っています。 綺麗に4つに割れないこと自体が、この記事の結論です。「2種類に分かれている」という思い込みを壊すために置いています。
⑧ 次に、どれを学ぶか
「次はどの言語を学ぶべきですか」という質問には、答えがありません。 問いの立て方が逆だからです。
言語から選ばない。作りたいものから選ぶ。
| 作りたいもの | 選ぶ言語 |
|---|---|
| Webサイト・Webアプリ | JavaScript(+TypeScript)。ブラウザで動くのがこれしかない |
| データを集計する・分析する | Python |
| 機械学習・LLMを使う | Python |
| CLIツール・常駐プロセス・コンテナ | Go |
| WordPress のテーマやプラグインを触る | PHP |
| スマホアプリ | 各プラットフォームの言語(この段階では急がなくて構いません) |
| OSやドライバ、組み込み | C / Rust |
そして、このサイトの方針をもう一度はっきり書きます。
このサイトは、引き続き Node.js で進めます。
Go の回でも同じことを書きました。理由も同じです。 フロントエンドを JavaScript で書いてきたので、同じ言語のままのほうが、覚えることが1つ減るからです。それだけです。
Go と Python の記事は、ここで役目を終えます。
持ち帰ってほしいのは、Python の文法ではありません。
1つ目の言語では、何が言語の性質か分からない。 2つ目で、線が引ける。 3つ目で、その線が実は面だったと分かる。
これから4つ目、5つ目を触るとき、あなたはもう「入門」から始めません。 「すでに知っているものと、どこが違うか」から始められます。 それが、この2本の記事で作りたかった状態です。
つまずいたところ
| 症状 | 原因 |
|---|---|
error: externally-managed-environment | venv の外で pip install している。 エラーではなく、正常な保護動作です |
--break-system-packages を勧める記事を見た | 使わないでください。 名前のとおり、システムのパッケージを壊します |
python3 -m venv が ensurepip is not available で失敗 | python3-venv パッケージが入っていない。 sudo apt install -y python3-venv |
pip install したのに ModuleNotFoundError | source .venv/bin/activate を忘れている。 which python で確認する |
| ターミナルを開き直したら動かなくなった | venv は開いているシェルにしか効きません。 毎回 activate します |
IndentationError | 段の深さが揃っていない。 タブと半角スペースが混ざっていないか確認 |
| ループの外に書いたつもりが、中で動いている | インデントが1段深い。 エラーは出ないので、出力の回数で気づくしかありません |
TypeError: a bytes-like object is required | self.wfile.write に文字列をそのまま渡した。 .encode("utf-8") が必要です |
| 日本語が文字化けする | Content-Type に charset=UTF-8 を付けていない、または .encode("utf-8") をしていない |
NameError: name 'true' is not defined | Python の真偽値は True / False。 先頭が大文字です |
Address already in use | 8000番を別のプロセスが掴んでいる。 sudo ss -tlnp で犯人を探す(サーバーとは何かの回と同じ) |
ブラウザから見えないが curl localhost は通る | ufw で 8000 を開けていない、または uvicorn に --host 0.0.0.0 を付けていない |
| ベンチマークの秒数が記事と全然違う | VMに割り当てたCPUで変わります。 見るのは絶対値ではなく桁の差です |
後片づけ
venv はフォルダごと消せます。
プロジェクトごと消す場合。
開けたポートを閉じます。
python3本体は絶対に消さないでください。 apt の回の道具が動かなくなります。sudo apt remove python3は、Ubuntu では実質「壊す」コマンドです。入っていて正常な状態です。
~/server/は残してください。 このサイトの本編は、引き続きそちらで進みます。
まとめ
- 2つでは地図にならない。 2点なら必ず直線が引けてしまう。3つ目で、それが面だったと分かる
- サーバーがやっているのは、掴む・待つ・受ける・返す。 3つ目の言語でも同じ場所に出てきた。偶然ではないと言い切れる
- Ubuntu の
python3はOSの部品。add-apt-repositoryがそれで動いている sudo pip installはしない。 Ubuntu 24.04 はexternally-managed-environmentで止めてくれる。--break-system-packagesで押し通さないvenvを作って、その中でpip installする。 消したければフォルダごと消せる- インデントが文法。 ズレると動かないか、エラーも出さずに意味が変わる
- 型は書かなくていいが、書ける。 ただし標準では誰も検査しない。TypeScript よりさらに弱い立場
- 標準ライブラリが厚い。 CSV も SQLite も ZIP も統計も、最初から入っている
- 同じループが Go の約150倍遅かった。 数字で見た
sum(range(...))にすると 3.4秒 が 0.9秒。 遅いのは Python のループであって、Python の全部ではない- 「遅い=駄目」ではない。 1日1回動くスクリプトなら、動く時間より書く時間のほうが高い
- APIの時間はほとんど待ち時間。 測る前に言語を変えるのは、順番が逆
- FastAPI は型ヒントを実際に使う。
task_id: intと書くだけで、abcを 422 で断る - Python が強いのは、データ処理・機械学習・自動化。 「重い部分を C の部品に投げられる」分野
- このサイトの
scripts/が Node.js なのは、フロントが JavaScript だから。 それだけの理由 - 言語は作りたいもので選ぶ。 そしてこのサイトは、引き続き Node.js で進めます
参考リンク
- roadmap.sh — Backend
- roadmap.sh — Python
- Python 公式サイト
- Python — 標準ライブラリ一覧(日本語)
- Python — venv(仮想環境)
- Python — http.server
- Python — typing(型ヒント)
- PEP 8 — Python コードのスタイルガイド
- PEP 668 — 外部管理された環境
- FastAPI 公式ドキュメント
- Uvicorn(GitHub)
次に読む
この記事は 【第5段階】バックエンドとデータベース の 25 / 29 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Python(3つ目の言語として触る)
- 言語の地図 — Java / PHP / Ruby / Rust / C はどこにいるか
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント