PHPStorm 作為 PHP 開發首選 IDE，其強大的配置系統分為「專案配置」與「IDE 配置」兩大層級。掌握配置存放位置、遷移方法、團隊分享策略，能大幅提升開發效率與團隊協作一致性。
| 層級 | 範圍 | 存放位置 | 典型內容 |
|---|---|---|---|
| 專案配置 | 單一專案 | 專案根目錄 .idea/ (XML 格式) |
執行/除錯配置、程式碼風格、檔案類型關聯、資料庫連線、VCS 設定、部署映射 |
| IDE 配置全域 (所有專案) | 各平台專用目錄 (見下表) | 鍵盤快捷鍵、編輯器顏色主題、外觀、插件、檢查規範、Live Templates、HTTP Client 環境 |
| 作業系統 | 配置目錄 | 系統/快取/日誌/插件目錄 |
|---|---|---|
| Windows | %USERPROFILE%\AppData\Roaming\JetBrains\PhpStorm<version> |
System: %USERPROFILE%\AppData\Local\JetBrains\PhpStorm<version> |
| Linux | ~/.config/JetBrains/PhpStorm<version> |
System: ~/.cache/JetBrains/PhpStorm<version> |
| macOS | ~/Library/Application Support/JetBrains/PhpStorm<version> |
Caches: ~/Library/Caches/JetBrains/PhpStorm<version>Logs: ~/Library/Logs/JetBrains/PhpStorm<version>Plugins: ~/Library/Application Support/JetBrains/PhpStorm<version>/plugins |
<version> 如 2023.3、2024.1。主要版本升級會建立新目錄，舊版配置不會自動遷移。
| 目錄/檔案 | 用途 | 適合團隊分享 |
|---|---|---|
codestyles/ | 程式碼風格 (代碼格式化規則) | ✅ 強烈建議 |
colors/ | 編輯器配色方案 | ✅ 建議 |
inspection/ | 代碼檢查設定 | ✅ 建議 |
keymaps/ | 鍵盤快捷鍵映射 | ⚠️ 個人習慣差異大 |
templates/ | Live Templates / File Templates | ✅ 建議 |
options/ | 各類功能開關、統計、UI 狀態 | ❌ 含機器特定路徑 |
filetypes/ | 自定義檔案類型關聯 | ✅ 可分享 |
shelf/ | Shelved 變更集 | ❌ 個人臨時狀態 |
.idea/ 加入 Git (需排除 workspace.xml、tasks.xml、usage.statistics.xml 等個人狀態檔)。.gitignore 範例：
# PHPStorm
.idea/workspace.xml
.idea/tasks.xml
.idea/usage.statistics.xml
.idea/dictionaries/
.idea/shelf/
settings.jar。編輯安裝目錄 bin/idea.properties (Windows/Linux) 或 PhpStorm.app/Contents/bin/idea.properties (macOS)：
# 自定義配置/系統/插件目錄 (需絕對路徑)
idea.config.path=${user.home}/MyPhpStormConfig
idea.system.path=${user.home}/MyPhpStormSystem
idea.plugins.path=${user.home}/MyPhpStormPlugins
idea.log.path=${user.home}/MyPhpStormLogs
修改後需重啟 PHPStorm 生效。適用於：多版本隔離、攜帶式安裝、CI 環境預設配置。
codestyles/、colors/ 等子目錄。.idea/php.xml，團隊成員 PHP 版本/路徑不同會衝突。建議用 Docker 或 PHP_VERSION 環境變數統一，或不提交此檔。Help → Edit Custom VM Options 調整 JVM 參數 (視記憶體而定)：
-Xms512m
-Xmx2048m
-XX:ReservedCodeCacheSize=512m
-XX:+UseG1GC
-Dfile.encoding=UTF-8Power Save Mode (File → Power Save Mode) 降低索引頻率。妥善管理 PHPStorm 配置，不僅能保持團隊代碼風格一致、減少「在我機器上正常」的爭執，更能在換機、升級、CI/CD 整合時無縫銜接。建立「配置即代碼」習慣，讓 IDE 成為團隊生產力的乘數器。
