ReSharper 2025.2 Help

配置项目特定属性

主要的 ReSharper 首选项 (在 ReSharper | Options 对话框中配置)可以全局或按解决方案应用。 还有一些首选项可以为每个项目或文件夹单独配置。 这些首选项可在 项目条目属性 弹出窗口中使用,您可以通过在解决方案资源管理器中从项目的上下文菜单中选择 编辑项目项属性 来调用它。

ReSharper:项目项属性

与其他 ReSharper 设置类似,项目特定属性可以保存在两个文件中: [ProjectName].csproj.DotSettings (用于通用首选项,例如 C# 版本)和 [ProjectName].csproj.DotSettings.user (用于个人首选项,例如本地路径映射)。 如果需要,您可以通过将 [ProjectName].csproj.DotSettings 文件置于版本控制下,与您的团队共享通用首选项。

当您从 UI 编辑项目特定设置时,它们会保存在 [ProjectName].csproj.DotSettings 文件中。

命名空间提供程序

仅适用于文件夹。

默认情况下,ReSharper 假定每个类所在的命名空间与其在项目中的位置匹配。 项目的“根”命名空间在项目属性中定义:

ReSharper 代码检查:命名空间与文件位置不匹配

基于上述结果,项目级别的所有代码元素都应出现在 ShareX 命名空间中,否则将发出警告。

通过引入文件夹,命名空间会变得更深。 在下面的示例中,一个名为 启动管理器 的文件夹将要求其包含的所有项出现在 ShareX 启动管理器 命名空间中。 然而,在某些情况下,您可能不需要文件夹附加额外的命名空间元素。 在这种情况下,您可以将 命名空间提供程序 设置为 False

ReSharper:项目文件夹的“命名空间提供程序”属性

不是 Namespace Provider 的文件夹不会影响其包含元素的命名空间,ReSharper 将相应地 分析重构 相关代码。

其他程序集引用

如果您的项目以自定义方式引用了一些程序集,ReSharper 可能无法找到它们,因此无法正确 分析 此项目。

使用此用分号分隔的列表让 ReSharper 知道这些程序集的位置,以便它可以正确解析这些程序集中的符号。

其他编译条目

如果您的项目以自定义方式包含文件,ReSharper 可能无法找到它们,因此无法正确 分析 此项目。

使用此用分号分隔的列表让 ReSharper 知道这些文件的位置,以便它可以正确解析它们。

C#/VB 语言级别

使用此选择器选择语言版本。 默认 值表示 ReSharper 根据项目设置自动检测语言版本。 根据所选的语言版本,ReSharper 的 代码检查 会检测代码问题并提出与所选版本相关的改进建议。 更多信息,请参阅 C# language versioning on Microsoft Docs。

ConfigureAwait 分析模式

使用此选项分析项目中使用异步编程模型(async/await 关键字)的 配置 ConfigureAwait() 调用。

  • 库模式 — ReSharper 将建议为可等待对象添加 配置 ConfigureAwait(false) 调用。

  • UI 模式 — ReSharper 将报告 配置 ConfigureAwait(true) 调用为多余的。

更多信息请参阅 ConfigureAwait 分析

强制调用 MsBuild

使用此选项通过 MsBuild 检索模块引用。 例如,如果存在 COM API 引用且项目在不支持 Roslyn 的旧版 Visual Studio 中打开,这可能会有所帮助。

自定义 pageParseFilterType 处理

此属性仅适用于 Web 项目。

使用此选择器选择 ReSharper 应如何处理 pageParseFilterType 属性的未识别值,该属性属于 页面 元素,位于 Web.config 中。

可本地化

此首选项定义是否执行 本地化检查。 如果选择了 默认 值,则仅在项目中至少有一个资源文件时才执行检查。 值允许显式启用/禁用此检查。

可本地化检查器

可本地化检查器 项目属性 定义了如何处理未被任何标记为 LocalizableAttribute 特性 的成员使用的字符串文本——乐观 算法将忽略此类字符串, 悲观将其标记为可本地化

从项目文件中读取项目模型

对于其大多数功能(包括 导航代码分析重构代码补全 ),ReSharper 会构建并维护当前解决方案的模型。 该模型会被缓存,然后用于即时访问解决方案结构中的任何项目。

默认情况下,ReSharper 独立于 Visual Studio 读取项目和解决方案文件。 这种方法是首选,因为:

  • 它不使用 Visual Studio COM API,因此不会阻塞 UI 线程,

  • 它为面向多个框架的项目提供了更可靠的模型。

然而,它有一些轻微的副作用:

  • ReSharper 需要项目和解决方案文件是最新的。 因此,如果文件已被编辑但未保存,它会自动保存它们。

  • 理论上,极少情况下,您可能会在构建期间遇到 无法访问文件 错误,因为 ReSharper 暂时锁定了一个项目文件。 在这种情况下,您只需再次启动构建即可。

如果上述某些问题存在,您可以将此选项设置为 False ,以使 ReSharper 通过 Visual Studio COM API 读取项目结构,这可能会稍微慢一些。

或者,您可以使用 ReSharper 选项 的 直接从项目/解决方案文件读取解决方案模型 复选框,在 环境 | 常规 页面上为解决方案中的所有项目配置此行为 Alt+R, O

路径映射

此属性仅适用于 Web 项目。

使用此首选项,您可以在应用程序设计期间同步文件的位置与应用程序部署的位置。 更多信息,请参阅 Path mapping

解决方案级检查

此首选项定义是否应在项目中启用 解决方案范围的代码检查开启关闭 值允许显式启用/禁用此检查。 仅内部符号 值部分启用此检查,适用于具有 internal 访问权限的类型和类型成员。

使用 Roslyn 获取项目引用

从 Visual Studio 2015 开始,ReSharper 通过 Roslyn 检索项目引用。 如果某些引用未正确解析,您可以禁用此选项,以便通过 COM API 检索引用。

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