1,078
个编辑
更改
→修复特定问题： 添加关于 .NET 的疑难解答
* 请确保您运行的是在游戏文件夹中的 <code>StardewModdingAPI.exe</code> 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
* 请确保您运行的是在游戏文件夹中的 <code>StardewModdingAPI.exe</code> 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code> ，在Linux/Mac上应该为 <code>internal/Mono</code> 。
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code> ，在Linux/Mac上应该为 <code>internal/Mono</code> 。
===Oops You don't have the required .NET version installed（仅限Windows）===
====如果您是64位Windows 10或以上的系统====
# 确保您已经按照[[模组:在Windows上安装SMAPI#安装SMAPI|在Windows上安装SMAPI]]页面中的步骤安装了'''正确的.NET 5版本'''。
# 尝试修改系统环境变量：
## 同时在键盘上按下Windows+{{key|R}}键，在弹出的运行窗口中输入<code>sysdm.cpl</code>，然后点击“确定”。
## 在弹出的“系统属性”窗口中切换到“高级”一栏，然后点击右下角的“环境变量”按钮。
## 在下半部分的系统变量列表中找到名为“Path”的变量，点击“编辑”按钮。<br />[[File:Modding - Player Guide - Troubleshooting - Environment Variables 01 ZH.png|thumb|none|600px|编辑环境变量 图1]]
## 在新弹出的“编辑环境变量”窗口中查看是否有<code>C:\Program Files\dotnet\</code>这一项。如果有这一项，将其选中，多次重复点击右侧的“上移”按钮，将其移动到列表的最顶部；如果没有这一项，您可以点击右侧的“新建”按钮在文本框中手动输入这一项，并同样将它上移至列表最顶部。<br />[[File:Modding - Player Guide - Troubleshooting - Environment Variables 02 ZH.png|thumb|none|600px|编辑环境变量 图2]]
## 依次点击每个窗口的“确定”，直到你关闭前面几个步骤中打开的所有窗口（即最后点击“系统属性”窗口的“确定”按钮）。
## 重新运行SMAPI安装程序，此时应该一切正常了。
# 如果按照以上步骤依然无法解决问题，请[[#寻求帮助|寻求帮助]]。
====如果您是64位Windows 7系统====
微软已经停止支持Windows 7系统，建议您将系统升级至Windows 10。如果您因为种种原因无法升级，请参考以下步骤解决问题：
# 按照[https://docs.microsoft.com/zh-cn/dotnet/core/install/windows?tabs=net50#windows-7--vista--81--server-2008-r2--server-2012-r2 微软官方的.NET 安装指南]在Windows 7上安装依赖组件后，再安装.NET 5 （即安装[https://aka.ms/vs/16/release/vc_redist.x64.exe Microsoft Visual C++ 2015-2019 Redistributable 64位]和[https://www.microsoft.com/zh-CN/download/details.aspx?id=47442 KB3063858 64位]）。<br />[[File:Modding - Player Guide - Troubleshooting - Windows 7 Guide ZH.png|thumb|none|600px|在Windows 7上安装.NET 5]]
# 如果继续出现该错误，您可能还需要按照上面的方法修改系统环境变量。
====如果您是32位系统====
很抱歉，您无法再使用Mod游玩1.5.5和之后版本的《星露谷物语》，建议您将系统升级至64位Windows 10或以上版本。但您可以通过修改游戏至支持32位游戏的“compability版本”，继续游玩游戏本体：
# 打开Steam，在“库”中右键点击“Stardew Valley”，点击属性。
# 在弹出的属性窗口中，切换到“测试版”一栏，然后在下拉框中选择“compability - For 32-bit systems”版本。
# 等待游戏更新完成后，您便可以开始游戏了！<br />[[File:Modding - Player Guide - Troubleshooting - Compatibility Branch ZH.png|700px]]
# 如果游戏无法打开，您可能需要安装（或是重新安装）4.5.2或以上版本的 [https://dotnet.microsoft.com/download/dotnet-framework-runtime/net452 .NET Framework] 和4.0版本的 [https://www.microsoft.com/en-us/download/details.aspx?id=27598 XNA Framework]。
除此以外，如果您使用的是Steam平台，您也可以考虑使用[https://github.com/Jack-Myth/SteamDepotDownloader-GUI/releases SteamDepotDownloader-GUI]（[https://tieba.baidu.com/p/7634538501 图文使用指南]）或[https://github.com/SteamRE/DepotDownloader DepotDownloader]或将游戏回退至1.5.4甚至更早的版本，并安装旧版SMAPI（游戏1.5.4版本对应的SMAPI版本为[https://www.nexusmods.com/stardewvalley/mods/2400?tab=files&file_id=46226 3.12.8]）和旧版Mod（游戏1.5.4版本需要下载2021年12月之前的旧版Mod）游玩。
===A compatible .NET SDK is not installed（仅限Windows）===
如果您在安装或启动SMAPI时，SMAPI控制台窗口报错"Could not execute because the application was not found or a compatible .NET SDK is not installed."，请参见[[#Oops You don't have the required .NET version installed|Oops You don't have the required .NET version installed问题]]的解决方案。
==="Skipped '...' because it doesn't have a manifest.json"===
==="Skipped '...' because it doesn't have a manifest.json"===