os 模組是 Python 與作業系統交互的核心接口,提供跨平台的文件系統、環境變數、進程管理等功能。掌握其核心 API,能讓你的程式在 Linux、Windows、macOS 上零修改運行。本文整理最高頻函數,按功能分類附帶代碼片段。
路徑與文件系統
| 函數 | 說明 | 範例 |
os.sep | 平台路徑分隔符 (Win: \, Unix: /) | os.path.join('a', 'b') |
os.path.join() | 智能拼接路徑,自動處理分隔符 | join('/home', 'user') |
os.path.split() | 分離目錄與文件名 | ('/home/user', 'file.txt') |
os.path.splitext() | 分離文件名與擴展名 | ('file', '.txt') |
os.path.basename() | 取得文件名 | 'file.txt' |
os.path.dirname() | 取得目錄路徑 | '/home/user' |
os.path.abspath() | 轉換為絕對路徑 | os.path.abspath('.') |
os.path.normpath() | 規範化路徑 (解析 .., .) | normpath('a/../b') |
os.getcwd() | 取得當前工作目錄 | '/home/user' |
os.chdir() | 改變工作目錄 | chdir('/tmp') |
os.listdir() | 列出目錄內容 | ['file.txt', 'dir'] |
os.makedirs() | 遞歸建立目錄 | makedirs('a/b/c', exist_ok=True) |
os.remove() | 刪除文件 | remove('file.txt') |
os.rmdir() | 刪除空目錄 | rmdir('empty_dir') |
os.rename() | 重命名/移動 | rename('old', 'new') |
文件屬性檢測
| 函數 | 說明 |
os.path.exists() | 路徑是否存在 |
os.path.isfile() | 是否為文件 |
os.path.isdir() | 是否為目錄 |
os.path.islink() | 是否為符號連結 |
os.path.getsize() | 文件大小 (位元組),目錄返回 0 |
os.path.getmtime() | 最後修改時間 (時間戳) |
os.path.samefile() | 兩路徑是否指向同一 inode |
環境變數與平台資訊
| 函數/屬性 | 說明 |
os.name | 平台標識: 'posix', 'nt', 'java' |
os.environ | 環境變數字典 (可讀寫) |
os.getenv(key, default) | 安全獲取環境變數 |
os.putenv(key, value) | 設定環境變數 (影響子進程) |
os.linesep | 行結束符: '\r\n' (Win), '\n' (Linux), '\r' (Mac 經典) |
os.curdir | 當前目錄符號 '.' |
os.pardir | 父目錄符號 '..' |
進程與命令執行
| 函數 | 說明 | 備註 |
os.system(cmd) | 執行 Shell 命令,返回退出碼 | 阻塞,不捕獲輸出 |
os.popen(cmd) | 開啟管道讀取命令輸出 | 類文件對象,建議用 subprocess |
os.execv(path, args) | 替換當前進程映像 | 不返回,類 Unix exec |
os.fork() | 建立子進程 (Unix) | 返回 PID,父進程>0,子進程=0 |
os.getpid() | 取得當前進程 ID | |
os.kill(pid, sig) | 發送信號給進程 | Unix 信號常數 |
實用組合範例
# 安全讀取配置文件
config_path = os.path.join(os.path.dirname(__file__), 'config.yaml')
if os.path.isfile(config_path) and os.access(config_path, os.R_OK):
with open(config_path) as f:
config = yaml.safe_load(f)
# 跨平台臨時文件
import tempfile
with tempfile.NamedTemporaryFile(mode='w+', delete=False) as tmp:
tmp.write(data)
tmp_path = tmp.name
# 使用後手動清理 os.unlink(tmp_path)
# 遍歷目錄樹 (推薦 os.walk)
for root, dirs, files in os.walk('/data'):
for f in files:
if f.endswith('.log'):
full = os.path.join(root, f)
print(full, os.path.getsize(full))
現代替代建議
- pathlib (Py3.4+): 物件導向路徑操作,
Path('/home').joinpath('user')
- subprocess: 替代
os.system/popen,功能更強、更安全
shutil:高級文件操作 (複製、移動、壓縮、磁碟使用量)
將此表加入書籤,下次處理文件路徑、環境變數或進程控制時,能秒級找到正確 API,寫出真正跨平台的 Python 代碼。