編輯 Power BI 桌面外的 PBIP 檔案

當你將作品儲存為 Power BI Desktop 專案時，Power BI Desktop 會將報告和語意模型定義儲存為獨立的文字檔。 你可以在專案在 Power BI Desktop 中開啟時，使用 Visual Studio Code（VS Code）或其他外部工具編輯支援的檔案。 Power BI Desktop 會偵測儲存的檔案變更並提示你套用，這樣你就不用關閉再重新開啟專案。

在本文中，您將學到：

• 如何直接從 Power BI Desktop 開啟 Visual Studio Code，作為編輯專案檔案的方便入口。
• 如何在開放的 Power BI Desktop 會話中套用支援的報告與語意模型檔案變更。
• Power BI Desktop 如何處理 Power BI Desktop 未儲存變更與專案檔案變更之間的衝突。

外部編輯 PBIP 檔案的前提條件

• 在您的 Windows 機器上安裝 2026 年 8 月或更新版本的 Power BI Desktop。
• 在 Power BI Desktop 中，選擇檔案>選項與設定>選項>預覽功能，啟用偵測並重新載入外部 PBIP 變更，然後重新啟動 Power BI Desktop。
• 安裝 Visual Studio Code 或其他程式碼編輯器或外部工具。
• 將一個 Power BI 桌面專案存成 PBIP 格式。 欲了解更多資訊，請參閱 Power BI Desktop 專案。
• 將 PBIP 根目錄存放在一個讓每個專案檔案路徑都維持在 Windows 260 字元限制以下的位置。

在 VS Code 中開啟 PBIP 資料夾

Power BI Desktop 提供專案資料夾的內建入口。 在標題欄選擇專案名稱，然後選擇 Visual Studio Code。 VS Code 會將專案資料夾作為活動工作空間開啟，您可以存取報告和語意模型定義檔案。

編輯專案檔案並套用變更

請使用以下工作流程來保持專案檔案與開啟的 Power BI 桌面會話同步：

1. 在 Power BI Desktop 裡，在開始外部編輯專案檔案前，先選擇儲存。 Power BI Desktop 在你儲存之前，不會寫入專案檔案的最新變更。
2. 在 VS Code 或其他外部工具中編輯支援的報告或語意模型檔案。
3. 把檔案存到外部工具裡。
4. 在 Power BI Desktop 中，選擇出現的橫幅中的「套用外部變更」。
5. 在 Power BI Desktop 中檢閱更新後的報表或語意模型，然後在您準備好保留之後於 Power BI Desktop 中所做的任何變更時，儲存專案。

Power BI Desktop 會從專案檔案中重新載入受影響的報告、語意模型或兩者。 它不會重新載入單一檔案或畫面。

解決 Power BI Desktop 中未儲存的變更

如果 Power BI Desktop 包含未儲存的變更，選擇「套用外部變更」會顯示警告，表示這些變更將被覆寫。

• 選擇「套用外部變更」以丟棄桌面中未儲存的變更Power BI並重新載入最新的專案檔案。
• 選擇取消以保留未儲存的變更在 Power BI 桌面版中。 外部檔案的變更會保留在磁碟上，但不會套用到開啟的會話中。

透過使用 Power BI 桌面橋接器套用外部變更

你也可以透過 Power BI 桌面橋接器，程式化地套用外部變更。

考慮事項與限制條件

• 偵測並重新載入外部 PBIP 變更，以及 Power BI 桌面橋接器目前都處於預覽階段。 功能與行為可能會在正式上市前改變。
• 外部編輯與重新載入應用於 PBIP 專案，而非 .pbix 檔案。
• Power BI Desktop 不會重新載入cache.abf。
• 重新載入會重置過濾器和一些使用者介面元素。
• 並非所有專案檔案都支援外部編輯。 在外部變更重載預覽期間，你無法編輯 definition.pbir、 report.json、 mobileState.json，或semanticModelDiagramLayout.json在 Power BI 桌面之外。
• 如果專案包含 unappliedChanges.json，請在外部編輯語意模型表達式前套用這些變更。 否則，Power BI Desktop 在套用待處理的變更時會捨棄外部表達式的變更。

相關內容

• Power BI 桌面專案總覽。
• Power BI Desktop 專案語意模型資料夾。
• Power BI 桌面專案報告資料夾。
• 什麼是 Power BI 桌面橋接器？
• Power BI 桌面橋接 CLI 在 npm 上。