TM_PROJECT_NAME 在代码片段中不生效，因该变量仅在终端、任务或调试配置中可用；应使用 workspaceFolderBasename 替代，它直接返回当前工作区根目录名，稳定可靠且无需插件。
为什么 TM_PROJECT_NAME 在代码片段里不生效
VSCode 的代码片段（snippets）默认不支持 TM_PROJECT_NAME 这类环境变量——它只在终端、任务或调试配置中可用，代码片段上下文里根本读不到。直接写 "body": ["// Project: ${TM_PROJECT_NAME}"] 会原样输出字符串，不会替换。
用 workspaceFolderBasename 替代项目名最可靠
VSCode 提供了 workspaceFolderBasename 变量，它返回当前工作区根目录的文件夹名（即你打开的那个文件夹的名字），绝大多数场景下就等同于“项目名称”。它在代码片段中可直接使用，无需插件或额外配置。
- 适用于单根工作区（最常见情况），比如你用
code my-app打开项目，my-app就是值 - 多根工作区下，它取的是当前编辑文件所属工作区的根文件夹名，行为稳定
- 比
TM_DIRECTORY或TM_FILEPATH更简洁，避免路径解析错误
示例片段（放入 javascript.json 或全局 snippets）：
{
"Insert Project Header": {
"prefix": "projhdr",
"body": [
"// Project: ${workspaceFolderBasename}",
"// Author: ${env:USER}",
""
],
"description": "Insert project name header"
}
}
需要动态读取 package.json 名称？得靠插件 + 自定义命令
如果项目名必须来自 package.json 的 name 字段（比如带 scope 的 @org/my-lib），workspaceFolderBasename 就不够用了。这时无法纯靠内置变量解决，必须引入外部逻辑。
- 推荐插件：
Command Runner或JavaScript Booster，它们支持在 snippet 触发时运行自定义命令 - 更轻量做法：写一个简单脚本（如 Node.js 脚本读取
package.json），再通过 VSCode 的command+editor.action.insertSnippet配合调用 - 注意：这类方案会增加延迟，且依赖项目根目录存在
package.json，否则 fallback 逻辑必须手动写死
别忽略工作区层级和多根场景下的歧义
很多人以为“当前项目”是明确的，但 VSCode 里它取决于你如何打开文件夹。如果你用 code . 进入子目录而非根目录，workspaceFolderBasename 就变成那个子目录名，不是你预期的项目名。
- 检查方式：按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 控制台执行vscode.workspace.workspaceFolders看实际结构 - 稳妥做法：确保工作区根目录就是项目根（含
package.json或tsconfig.json） - 如果必须支持任意打开位置，只能走插件读取 nearest
package.json，没有捷径
真正麻烦的不是怎么插入，而是怎么定义“项目名称”本身——它从来不是 VSCode 的一级概念，只是你约定俗成的理解。
