C# .NetStandard项目中.sln与.csproj文件的相对路径问题

DevOps 小满

2026-5-21

嗨，这个跨Windows和Linux双环境的.NET Standard类库引用问题我之前帮好几个开发者捋顺过，核心就是把坑人的绝对路径替换成相对路径，或者用.NET自带的配置工具统一管理引用，具体可以按下面几个方案来操作：

方案1：直接修改项目文件为相对路径

先确认你的本地目录结构（双系统下保持一致很关键），假设是这样的：

./Project1/
./Project2/
./Project3/
./Project4/

（如果你的结构是Project1文件夹嵌套了另外三个，那路径就是./Project1/Project2/这类，调整相对层级就行）

打开每个项目的.csproj文件，把里面的绝对路径引用改成相对路径：
比如Project1的.csproj里原来的绝对路径可能是：

<ProjectReference Include="C:\Users\YourName\Projects\Project2\Project2.csproj" />

直接换成相对路径：

<!-- 要是同级目录就用这个 -->
<ProjectReference Include="..\Project2\Project2.csproj" />
<!-- 要是Project1嵌套了其他项目，就用这个 -->
<ProjectReference Include=".\Project2\Project2.csproj" />

同理，Project2和3里引用Project4的部分也换成对应的相对路径。.NET SDK会自动处理Windows的\和Linux的/路径分隔符，完全不用你手动转换。

方案2：用Directory.Build.props统一管理引用（适合多项目场景）

如果项目多，一个个改.csproj太麻烦，可以在所有项目的父目录创建一个Directory.Build.props文件，内容如下：

<Project>
  <ItemGroup>
    <!-- 用MSBuild变量自动识别根目录，适配双系统路径 -->
    <ProjectReference Include="$(MSBuildThisFileDirectory)Project2\Project2.csproj" Condition="Exists('$(MSBuildThisFileDirectory)Project2\Project2.csproj')" />
    <ProjectReference Include="$(MSBuildThisFileDirectory)Project3\Project3.csproj" Condition="Exists('$(MSBuildThisFileDirectory)Project3\Project3.csproj')" />
    <ProjectReference Include="$(MSBuildThisFileDirectory)Project4\Project4.csproj" Condition="Exists('$(MSBuildThisFileDirectory)Project4\Project4.csproj')" />
  </ItemGroup>
</Project>

.NET会自动识别根目录的这个props文件，所有项目都会继承里面的配置，这样你不用在每个.csproj里重复写引用路径，而且$(MSBuildThisFileDirectory)会自动指向props所在的目录，完美适配双系统的路径差异。

方案3：用解决方案文件（.sln）统一管理项目

如果还没创建解决方案，强烈建议搞一个，放在所有项目的父目录里，操作起来很简单：
在终端（Windows用PowerShell/CMD，Linux用bash）进入父目录，执行这些命令：

# 创建一个名为MyProjects的解决方案
dotnet new sln -n MyProjects
# 把四个项目都添加到解决方案里
dotnet sln add Project1/Project1.csproj
dotnet sln add Project2/Project2.csproj
dotnet sln add Project3/Project3.csproj
dotnet sln add Project4/Project4.csproj

之后用Visual Studio、Rider或者VS Code打开这个解决方案，添加项目引用的时候直接选解决方案里的项目就行，IDE会自动生成正确的相对路径引用，跨系统打开也不会出问题。

几个额外提醒

每个Git仓库只提交自己的项目文件，别把其他项目的文件塞进去，毕竟它们是独立仓库。
团队协作的话，尽量让所有人的本地目录结构保持一致，这样相对路径才能正常工作；如果有人结构不一样，可以用方案2的props文件让他们自己调整路径。
绝对不要把用户特定的绝对路径提交到Git里，改完.csproj一定要检查Git变更，确保绝对路径都被替换掉了，别坑队友。

内容的提问来源于stack exchange，提问作者Iustinian Olaru

C# .NetStandard项目中*.sln与*.csproj文件的相对路径问题

C# .NetStandard项目中.sln与.csproj文件的相对路径问题