Python sys.platformでOSを判定する方法|win32・darwin・linuxの値一覧とos.name・platformとの違い
Pythonで実行中のOSを判定するには、import sysしてからsys.platformを見ます。Windowsなら'win32'、macOSなら'darwin'、Linuxなら'linux'が返ります(64ビットのWindowsでも'win32'です)。
この記事では、sys.platformが返す値の一覧(Android・iOSなど新しい値を含む)、OSごとに処理を分ける書き方、os.nameやplatform.system()との違い、requirements.txtで使うsys_platformまでを、実際に動かした結果つきでまとめます。値の一覧と変更履歴はPython公式ドキュメントのsys.platform(2026年10月18日確認、Python 3.15のドキュメント)にもとづいています。
sys.platformの基本的な使い方
sys.platformは関数ではなく文字列の変数です。カッコは付けません。sysは標準ライブラリなのでインストール不要ですが、import sysは必要です。
import sys
print(sys.platform)
macOS(Apple Silicon、Python 3.12)での実行結果です。
darwin
sys.platformが返す値の一覧
公式ドキュメントに載っている値は次のとおりです(2026年10月18日確認)。
| OS | sys.platformの値 |
|---|---|
| Windows | 'win32' |
| Windows上のCygwin | 'cygwin' |
| macOS | 'darwin' |
| Linux | 'linux' |
| FreeBSD | 'freebsd' |
| AIX | 'aix' |
| Android | 'android' |
| iOS | 'ios' |
| Emscripten(ブラウザ上のPython) | 'emscripten' |
| WASI(WebAssembly) | 'wasi' |
この表にないUNIX系OSでは、uname -sの小文字のOS名にuname -rのバージョン番号の先頭を付けた値(例:'sunos5')になります。この値はPythonをビルドしたときのものです。
macOSが'darwin'なのは、macOSの土台になっているOSの名前がDarwinだからです。'mac'や'macos'では判定できないので注意してください。
バージョンによって値が変わった点
古い記事のコードをそのまま使うと判定がずれることがあります。公式ドキュメントの変更履歴は次のとおりです。
| Pythonのバージョン | 変更内容 |
|---|---|
| 3.3 | Linuxは常に'linux'になった(以前は'linux2'・'linux3') |
| 3.8 | AIXは常に'aix'になった(以前は'aix5'・'aix7') |
| 3.13 | Androidでは'linux'ではなく'android'を返すようになった |
| 3.14 | FreeBSDは常に'freebsd'になった(以前は'freebsd13'・'freebsd14') |
Python 3.13以降、Android上のPythonはsys.platform.startswith("linux")に当てはまらなくなりました。「Linuxならこう」という分岐をAndroidでも通したい場合は、'android'も条件に入れる必要があります。
OSごとに処理を分ける書き方
import sys
if sys.platform == "win32":
print("Windows用の処理")
elif sys.platform == "darwin":
print("macOS用の処理")
elif sys.platform.startswith("linux"):
print("Linux用の処理")
else:
print("その他のOS:", sys.platform)
macOSでの実行結果です。
macOS用の処理
Linuxをstartswith("linux")で判定しているのは、Python 3.2以前の'linux2'のような値にも対応するためです。公式ドキュメントも、特定のバージョンを判定したいとき以外はstartswith()を使う書き方を勧めています。最後にelseを置いて、想定していないOSでも黙って間違った処理に進まないようにしておくと安全です。
win32とwin64の違い|64ビットWindowsでもwin32になる
「win64」という値はありません。sys.platformは「Windows系のAPI(Win32 API)で動いているか」を表すもので、32ビットか64ビットかは表しません。64ビットかどうかを知りたいときは、次のように調べます。
import sys, platform
print("64bit Python:", sys.maxsize > 0xFFFFFFFF)
print("machine :", platform.machine())
macOS(Apple Silicon)での実行結果です。
64bit Python: True
machine : arm64
sys.maxsize > 0xFFFFFFFFは「動いているPython自体が64ビット版か」、platform.machine()は「CPUの種類」を表します。platform.machine()の値はOSによって表記が違い、公式ドキュメントでは例として'AMD64'が挙がっています(platform.machine()、2026年10月18日確認)。
sys.platform・os.name・platform.system()の違い
OSを調べる方法は3つあります。同じmacOSで並べて表示してみます。
import sys, os, platform
print("sys.platform :", sys.platform)
print("os.name :", os.name)
print("platform.system():", platform.system())
macOSでの実行結果です。
sys.platform : darwin
os.name : posix
platform.system(): Darwin
| 取得方法 | Windows | macOS | Linux | 細かさ |
|---|---|---|---|---|
sys.platform |
win32 |
darwin |
linux |
OSごと |
os.name |
nt |
posix |
posix |
大まかな系統 |
platform.system() |
Windows |
Darwin |
Linux |
OSごと(表示向け) |
os.nameに登録されている値は'posix'・'nt'・'java'の3つです(2026年10月18日確認)。ntはWindows NT系のことで、今のWindowsはすべてntになります。macOSとLinuxはどちらもposixなので、os.nameでは区別できません。
platform.system()は'Linux'・'Darwin'・'Windows'のように頭文字が大文字の名前を返し、判定できないときは空文字を返します。iOSとAndroidでは'iOS'・'iPadOS'・'Android'のように利用者向けの名前を返します(2026年10月18日確認)。
使い分けの目安は次のとおりです。
sys.platform:OSごとに処理を分けるとき(判定用の標準的な方法)os.name:「Windowsか、それ以外か」だけ分かればよいときplatform.system():ログや画面に人が読む形で出したいとき
requirements.txtのsys_platform(環境マーカー)
パッケージの依存関係を書くとき、「Windowsのときだけ入れる」という指定ができます。これを環境マーカーといい、sys_platformはsys.platformの値と同じです。Python Packaging User Guideの仕様では、sys_platformはOS別の依存関係を書くときに最も定義がはっきりした項目だと説明されています(Dependency specifiers、2026年10月18日確認)。
colorama; sys_platform == "win32"
pyobjc; sys_platform == "darwin"
マーカーがどう評価されるかは、pipに同梱されているpackagingライブラリで確かめられます。
from pip._vendor.packaging.markers import Marker
m = Marker('sys_platform == "win32"')
print(m.evaluate())
print(Marker('sys_platform == "darwin"').evaluate())
print(m.evaluate({"sys_platform": "win32"}))
macOSでの実行結果です。3行目は「Windowsだったら」という仮定で評価しています。
False
True
True
pip._vendorはpipの内部用なので、確認以外の用途では使わないでください。本番のコードで使うならpip install packagingで入れたものを使います。
実践例|設定ファイルの保存先をOSで変える
import sys, os
from pathlib import Path
def config_dir(app):
if sys.platform == "win32":
base = os.environ.get("APPDATA", Path.home())
elif sys.platform == "darwin":
base = Path.home() / "Library" / "Application Support"
else:
base = os.environ.get("XDG_CONFIG_HOME", Path.home() / ".config")
return Path(base) / app
print(config_dir("myapp"))
macOSでの実行結果です。
/Users/user/Library/Application Support/myapp
設定ファイルを置く場所の慣習がOSごとに違うため、ここは分岐が必要になる典型的な場面です。画面を消すコマンド(Windowsはcls、それ以外はclear)のように、OSでコマンド名が違うときも同じ形で書けます。
OS判定を書かなくて済む場面
OSで分けたくなる処理の多くは、標準ライブラリがすでに吸収しています。分岐を書くほど、自分が試していないOSで壊れる箇所が増えるので、まず次の方法で書けないか確認してください。
| やりたいこと | OS判定のかわりに使うもの |
|---|---|
パスの区切り文字(\と/) |
pathlib・os.path.join() |
| 一時ファイルの置き場所 | tempfile |
| ホームディレクトリ | Path.home() |
| 環境変数 | os.environ |
パスの扱いは「Python os.path.join()とは?パスを安全に連結する方法」、osモジュール全体は「Pythonのosモジュールの使い方」で解説しています。
よくある質問
Q. sys.platformはimportなしで使えますか?
使えません。sysは標準ライブラリなのでインストールは不要ですが、使う前にimport sysが必要です。importせずに書くとNameErrorになります。
Q. 64ビットのWindowsでwin64にならないのはなぜですか?
sys.platformはWindows系のAPIで動いているかを表す値で、ビット数は表さないためです。公式ドキュメントでもWindowsの値はwin32だけです。64ビットかどうかはsys.maxsize > 0xFFFFFFFFやplatform.machine()で調べます。
Q. os.nameがntになるのはどのOSですか?
Windowsです。ntはWindows NT系を指し、現在のWindowsはすべてntになります。macOSとLinuxはどちらもposixです。
Q. AndroidでLinux用の分岐に入らなくなったのはなぜですか?
Python 3.13から、Androidではsys.platformがlinuxではなくandroidを返すようになったためです。Androidでも同じ処理を通したいなら、条件にandroidを加えてください。




