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を加えてください。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

この記事のようなコードを、講師に聞きながら動かしてみる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です