将工作另存为Power BI桌面项目时，Power BI Desktop 会将报表和语义模型定义存储为单个文本文件。 可以使用 Visual Studio Code（VS Code）或其他外部工具编辑支持的文件，同时项目在Power BI桌面中保持打开状态。 Power BI桌面会检测保存的文件更改并提示应用更改，因此无需关闭并重新打开项目。
Important
Power BI桌面项目（PBIP）和Power BI增强型报表格式（PBIR）已正式发布。 在 Power BI Desktop 中检测并重新加载外部 PBIP 更改的功能目前处于预览阶段。
在本文中，你将了解：
- 如何直接从 Power BI Desktop 打开Visual Studio Code作为编辑项目文件的便捷入口点。
- 如何在打开Power BI桌面会话中应用支持的报表和语义模型文件更改。
- Power BI桌面如何处理Power BI桌面中未保存的更改与项目文件中的更改之间的冲突。
外部编辑 PBIP 文件的先决条件
- 在 Windows 计算机上安装 Power BI Desktop 的 2026 年 8 月或更高版本。
- 在Power BI桌面中，选择“文件>选项和设置>选项>预览”功能，启用“检测并重新加载外部 PBIP 更改”，然后重启Power BI桌面。
- 安装Visual Studio Code或其他代码编辑器或外部工具。
- 以 PBIP 格式保存Power BI桌面项目。 有关详细信息，请参阅Power BI桌面项目。
- 将 PBIP 根文件夹存放在一个位置，以确保每个项目文件路径都不超过 Windows 260 个字符的路径长度限制。
在 VS Code 中打开 PBIP 文件夹
Power BI Desktop 提供项目文件夹的内置入口点。 在标题栏中选择项目名称，然后选择Visual Studio Code。 VS Code 将打开项目文件夹作为活动工作区，可在其中访问报表和语义模型定义文件。
注释
VS Code 将打开包含用于打开项目的文件的文件夹，该文件可能是一个 .pbip 或 .pbir 文件。
编辑项目文件并应用更改
使用以下工作流将项目文件和打开Power BI桌面会话保持同步：
- 在 Power BI Desktop 中，选择“保存”，然后开始在外部编辑项目文件。 Power BI Desktop 在保存之前不会将其最新更改写入项目文件。
- 在 VS Code 或其他外部工具中编辑支持的报表或语义模型文件。
- 将文件保存在外部工具中。
- 在 Power BI Desktop 中，选择显示的横幅中的“应用外部更改”。
- 在 Power BI Desktop 中查看更新的报表或语义模型，然后在准备好保留 Power BI Desktop 中所做的任何后续更改时保存项目。
Power BI桌面从项目文件重新加载受影响的报表、语义模型或两者。 它不会重新加载单个文件或视觉对象。
解决 Power BI Desktop 中的未保存更改
如果Power BI桌面包含未保存的更改，则选择“应用外部更改”将显示一条警告，指出这些更改将被覆盖。
- 选择“应用外部更改”以放弃 Power BI Desktop 中未保存的更改，并重新加载最新的项目文件。
- 选择“取消”，以在 Power BI Desktop 中保留未保存的更改。 外部文件更改保留在磁盘上，但不应用于打开的会话。
Important
Power BI Desktop 和外部工具可以覆盖彼此所做的更改。 在它们之间切换之前，请保存或应用当前更改，以便这两个工具使用相同的项目定义。
使用 Power BI 桌面桥应用外部更改
还可以使用 Power BI 桌面桥以编程方式应用外部更改。
注意事项和限制
- 检测并重新加载外部 PBIP 更改以及 Power BI 桌面桥当前均处于预览阶段。 在正式发布之前，功能和行为可能会更改。
- 外部编辑和重新加载适用于 PBIP 项目，不适用于
.pbix文件。 - Power BI桌面不会重新加载
cache.abf。 - 重新加载会重置筛选条件和某些用户界面元素。
- 并非所有项目文件都支持外部编辑。 在外部更改重新加载预览期间，您无法在 Power BI Desktop 外部编辑
definition.pbir、report.json、mobileState.json或semanticModelDiagramLayout.json。 - 如果项目包含
unappliedChanges.json，在外部编辑语义模型表达式之前，请应用这些更改。 否则，Power BI Desktop 在应用待定更改时，会丢弃对外部表达式所做的更改。