如何在NVIDIA Nsight Systems中查看NVTX标记？（单Windows主机）

针对你遇到的NVTX标记不显示、环境变量警告的问题，可以按以下步骤排查：

1. 确认NVTX注入DLL的路径正确性 #

NVTX_INJECTION64_PATH必须指向Nsight Systems安装目录内的nvtxInject64.dll，而非单独的nvToolsExt库文件。例如2022.3.4版本的默认路径为：

C:\Program Files\NVIDIA Corporation\Nsight Systems 2022.3.4\target-windows-x64\nvtxInject64.dll

确保路径为绝对路径，无拼写错误或特殊字符干扰。

2. 确保环境变量生效 #

• 添加系统环境变量后，必须重启Visual Studio或电脑，否则新变量无法被已启动的VS进程读取。
• 优先级更高的方式：在VS项目属性中配置本地环境变量：
  右键项目 → 属性 → 调试 → 环境，添加：

  NVTX_INJECTION64_PATH=你的nvtxInject64.dll绝对路径
  

3. 更换Nsight启动方式 #

放弃VS扩展的启动方式，直接使用Nsight Systems独立程序追踪：

1. 打开Nsight Systems 2022.3.4
2. 新建Trace任务，选择「Launch Application」
3. 指定你的exe路径，勾选「Collect NVTX trace」
4. 启动追踪，避免VS扩展的环境变量传递异常。

4. 代码与链接检查 #

• 确认nvtxRangePush/Pop代码确实被执行：添加断点或日志验证，排除代码分支未进入的情况。
• 确保项目链接了正确的NVTX库：在项目属性→链接器→输入→附加依赖项中添加nvToolsExt64_1.lib，或在代码中加入：

  #pragma comment(lib, "nvToolsExt64_1.lib")
  

5. 版本兼容性与权限 #

• 你的Nsight Integration（2020.2）与Nsight Systems（2022.3）版本差距过大，存在兼容性风险，建议升级VS扩展到对应版本，或直接使用独立版Nsight Systems。
• 以管理员身份运行Visual Studio和Nsight Systems，避免权限不足导致的注入失败。

内容的提问来源于stack exchange，提问作者Ad N