Title: Troubleshooting
Author: Marius L. J.
Published: <strong>2024 年 9 月 21 日</strong>
Last modified: 2026 年 8 月 16 日

---

搜尋外掛

![](https://s.w.org/plugins/geopattern-icon/troubleshooting.svg)

# Troubleshooting

 由 [Marius L. J.](https://profiles.wordpress.org/clorith/) 開發

[下載](https://downloads.wordpress.org/plugin/troubleshooting.1.0.2.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/troubleshooting/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/troubleshooting/#reviews)
 * [開發資訊](https://tw.wordpress.org/plugins/troubleshooting/#developers)

 [技術支援](https://wordpress.org/support/plugin/troubleshooting/)

## 外掛說明

Troubleshooting Mode was initially a feature introduced via the Health Check plugin,
and is now available as a standalone plugin.

The most common, and reliable, means of troubleshooting a website using WordPress,
is by first disabling all plugins, and using one of the default themes that come
with the software.
 The best way to do this, is by the use of a staging website,
but not all website hosting providers have this feature, or it may not be part of
the plan you are currently on.

Troubleshooting Mode will do its best to allow a site maintainer to disable plugins,
and switch themes, without affecting regular visitors to your website.

## 常見問題集

### How can I disable Troubleshooting Mode?

Troubleshooting Mode has various ways to be disabled, depending on your situation.
Normally you would either click the “Disable Troubleshooting Mode” button within
your admin dashboard, or from the “Troubleshooting Mode” menu item in the admin 
bar.

If you are unable to access your admin dashboard, or your admin bar for any reason,
either signing out from your website, clearing all cookies for your website, or 
closing all your browser windows will also remove the cookies used to declare your
current account as being in Troubleshooting Mode.

### My website looks broken after using Troubleshooting Mode!

Unfortunately, despite our best efforts, some caching solutions are either so complex,
or so aggressive, that they do not respect Troubleshooting Mode’s directives to 
not cache any content.

It is recommended to clear your caches after completing your troubleshooting, this
can usually be done from your caching plugin’s settings, or by disabling and re-
enabling the caching plugin. Note that your hosting provider may also have a dedicated
button to clear its caching from their own control panel, if this is offered to 
you.

### Can I contribute to this plugin?

Yes, the plugin is open source and available on the [WordPress/site-health-troubleshooting GitHub repository](https://github.com/wordpress/site-health-troubleshooting),
and we welcome all types of contributions!

## 使用者評論

![](https://secure.gravatar.com/avatar/958ebdcd0665f758264d3e216f96df0618ca64cae677a21a876ceb40b7e4eb2d?
s=60&d=retro&r=g)

### 󠀁[Stay away from this plugin](https://wordpress.org/support/topic/stay-away-from-this-plugin-21/)󠁿

 [PikaxoGraph](https://profiles.wordpress.org/pikaxograph/) 2026 年 7 月 27 日

I installed this plugin after it was recommended as a safe way to diagnose problems
on my WordPress site. In theory, Troubleshooting Mode should temporarily disable
all plugins only for the administrator, allowing tests to be performed without affecting
the live website. In practice, it caused a serious mess. Troubleshooting Mode suddenly
stopped working properly, I could no longer reactivate any plugins, and when I disabled
the mode, the plugin deactivated every plugin on the actual website. Instead of 
providing a safe diagnostic environment, it created an additional and potentially
damaging problem on a live site. Based on my experience, I strongly recommend staying
away from this plugin.

 [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/troubleshooting/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈Troubleshooting〉的開發相關工作。

參與者

 *   [ Marius L. J. ](https://profiles.wordpress.org/clorith/)

〈Troubleshooting〉外掛目前已有 2 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/troubleshooting/contributors)
為這個外掛做出的貢獻。

[將〈Troubleshooting〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/troubleshooting)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/troubleshooting/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/troubleshooting/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/troubleshooting/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/troubleshooting/)。

## 變更記錄

#### 1.0.2 (2025-12-30)

 * Fixed: Translation warnings when using WordPress 6.7 or later.
 * Troubleshooting Mode: Add Twenty Twenty Five to the list of default themes.

#### 1.0.1 (2024-10-02)

 * Fixed: Remove some strict typecasting on filters where plugins may return values
   WordPress core does not expect, to avoid causing fatal errors.
 * Fixed: Removed some more strict typecasting causing issues when switching between
   a block and non-block theme in troubleshooting mode.
 * Improvement: Made the plugin attempt to use symlinks instead of copying files
   when setting up the mu-plugin.

= 1.0.0 (2024-09-21)
 * Initial release

## 社群版外掛

這個外掛由社群人員開發及提供技術支援。 [參與這個外掛專案](https://github.com/wordpress/site-health-troubleshooting)

## 中繼資料

 *  版本 **1.0.2**
 *  最後更新 **1 個月前**
 *  啟用安裝數 **500+**
 *  WordPress 版本需求 ** 5.8 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.1.2**
 *  PHP 版本需求 ** 7.1 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/troubleshooting/)、[Japanese](https://ja.wordpress.org/plugins/troubleshooting/)、
   及 [Russian](https://ru.wordpress.org/plugins/troubleshooting/).
 *  [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/troubleshooting)
 * 標籤:
 * [health check](https://tw.wordpress.org/plugins/tags/health-check/)[site health](https://tw.wordpress.org/plugins/tags/site-health/)
 *  [進階檢視](https://tw.wordpress.org/plugins/troubleshooting/advanced/)

## 評分

 1 星，滿分為 5 星

 *  [  0 個 5 星使用者評論     ](https://wordpress.org/support/plugin/troubleshooting/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/troubleshooting/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/troubleshooting/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/troubleshooting/reviews/?filter=2)
 *  [  1 個 1 星使用者評論     ](https://wordpress.org/support/plugin/troubleshooting/reviews/?filter=1)

[撰寫評分](https://wordpress.org/support/plugin/troubleshooting/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/troubleshooting/reviews/)

## 參與者

 *   [ Marius L. J. ](https://profiles.wordpress.org/clorith/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/troubleshooting/)