WebStorm 2025.2 Help

编码

为了正确显示和编辑文件,WebStorm 需要知道使用哪种编码。 源代码文件通常采用 UTF-8 编码。 除非有其他需求,否则推荐使用该编码。

为了确定文件的编码,WebStorm 会执行以下步骤:

  • 如果文件中存在 字节顺序标记 (BOM),WebStorm 会使用对应的 Unicode 编码,无论其他设置如何。 有关更多信息,请参阅 字节顺序标记

  • 如果文件显式声明了编码,WebStorm 将使用指定的编码。 例如,这适用于 XML 或 HTML 文件。 显式声明也会覆盖所有其他设置,但您可以在编辑器中更改它。

  • 如果文件中既没有 BOM,也未显式声明编码,WebStorm 将使用在 文件编码设置 中为该文件或目录配置的编码。 如果文件或目录未配置编码,WebStorm 将使用其父目录的编码。 如果父目录也未配置编码,WebStorm 将回退到 项目编码 ,如果没有项目,则回退到 全局编码

更改包含显式编码信息的文件的编码

  1. 在编辑器中打开所需文件。

  2. 更改显式编码信息。 使用错误高亮识别错误编码并按下 Ctrl+Space ,即可显示可用编码列表:

    显式编码

更改用于查看文件的编码

如果 WebStorm 无法正确显示文件中的字符,可能是无法识别其编码。 在这种情况下,您需要指定用于查看和编辑该文件的正确编码。

  1. 在编辑器中打开该文件。

  2. 点击 文件编码 控件(位于 状态栏)。

    或在主菜单中选择 文件 | 文件属性 | 文件编码

  3. 选择正确的编码。

    状态栏编码

    带有 三角形警告图标圆形错误图标 标记的编码可能会更改文件内容。 在这种情况下,WebStorm 会打开一个对话框,让您选择对该文件执行的操作:

    • 重新加载 :从磁盘加载文件至编辑器,仅将编码更改应用到编辑器中。 您将看到因所选编码而引起的内容变化,但实际文件不会改变。

    • 转换 :使用所选编码覆盖该文件。

这将在 文件编码设置 中为该文件添加关联。 WebStorm 将使用所指定的编码来查看和编辑该文件。

配置 properties 文件的默认编码

WebStorm 对 .properties 文件应用系统默认编码。 如需使用其他编码,请将其以转义序列和 Unicode 的形式提供。 或者,也可以在项目级别定义 .properties 文件的默认编码,并使用可读取您所定义编码的 .properties 文件的不同 API。

  1. 设置 对话框(Ctrl+Alt+S )中,选择 编辑器 | 文件编码

  2. 请执行以下操作之一:

    • 若要在 properties 文件中以转义序列存储符号但以普通字母形式显示时启用特殊模式,请选中选项 自动转换成Ascii 但显示原生的内容。 当 properties 文件采用 ISO 8859-1 编码时,此选项非常有用。 如果没有特殊理由更改编码,建议您采用此方法。

    • 属性文件的默认编码 列表中选择将在项目中用于所有 properties 文件的编码。

配置文件编码设置

  • Ctrl+Alt+S 打开设置,然后选择 编辑器 | 文件编码

WebStorm 使用这些设置查看和编辑无法自动识别编码的文件,并将所选编码用于新文件。 如需了解详情,请参阅 文件编码

选择控制台输出编码

默认情况下,WebStorm 使用系统编码查看控制台输出。

  1. 设置 对话框中(Ctrl+Alt+S ),选择 编辑器 | 常规 | 控制台

  2. 默认编码 列表中选择默认编码。

  3. 点击 确定 应用更改。

如需了解有关控制台输出设置的更多信息,请参阅 控制台

最后修改日期: 2025年 9月 26日