Visual Studio MVC5项目是否应纳入node_modules文件夹及源码控制？

针对你在MVC5项目中使用NPM管理前端依赖（尤其是TypeScript类型定义）遇到的问题，我结合前端最佳实践和NCrunch的特性给你梳理下解决方案：

1. 是否将node_modules纳入源码控制？ #

答案是绝对不要，这是前端开发的通用最佳实践：

• node_modules体积庞大，包含大量依赖的冗余文件（比如源码、测试用例、文档），纳入源码控制会大幅增加仓库体积，拉取代码时速度极慢。
• 你可以通过package.json声明依赖版本，再配合package-lock.json（NPM默认生成）精确锁定每个依赖的具体版本，构建时执行npm install就能在任何环境还原完全一致的依赖包。
• 目前你的构建代理能正常执行NPM还原再编译，说明这个流程是没问题的，继续保持在.gitignore中排除node_modules/即可。

2. 是否将node_modules添加到Web项目（MySolution.Web）中？ #

不建议把整个node_modules文件夹添加到项目中，但你需要解决NCrunch找不到类型定义的问题。原因是NCrunch在扫描项目文件时，默认只会识别项目范围内的文件，而你排除了node_modules，导致它找不到@types/knockout这类类型文件。

推荐通过以下配置解决，而非直接添加整个node_modules：

步骤1：配置TypeScript的tsconfig.json #

确保项目根目录下有tsconfig.json（没有的话新建），通过typeRoots字段告诉TypeScript编译器类型定义的存放位置：

{
  "compilerOptions": {
    // 其他配置...
    "typeRoots": ["./node_modules/@types"] // 指定类型定义的根目录
  }
}

如果只需要特定的类型包，也可以用types字段精准指定：

{
  "compilerOptions": {
    // 其他配置...
    "types": ["knockout"] // 只加载knockout的类型定义
  }
}

步骤2：配置NCrunch包含类型文件 #

在NCrunch的项目设置中，找到Additional files to include选项，添加路径：

node_modules/@types/**/*.d.ts

这个配置会让NCrunch扫描所有@types下的类型定义文件，不需要把node_modules纳入项目就能识别到这些文件。

3. 临时 workaround（不推荐但可用） #

如果上述配置遇到障碍，你可以仅将node_modules/@types文件夹添加到Web项目中，而非整个node_modules。这样既能让NCrunch找到类型定义，又避免引入大量无关文件。但这只是权宜之计，优先推荐用tsconfig+NCrunch配置的方案。

总结 #

• 源码控制：坚持排除node_modules，用package-lock.json锁定依赖版本，符合行业最佳实践。
• 项目纳入：无需添加整个node_modules，通过配置TypeScript和NCrunch即可解决类型查找问题，同时保持项目结构简洁。

内容的提问来源于stack exchange，提问作者Laurence Frost