AdvancedNewFile 原版在 Sublime Text 4 上失效因作者停更且 API 变动，需手动安装社区分支 AdvancedNewFile_ST4；安装后路径须用正斜杠、区分绝对/相对、引号包裹空格中文，且依赖项目根目录加载。
AdvancedNewFile 在 Sublime Text 4 上不能直接用 Package Control 装原版，必须手动安装社区维护分支 AdvancedNewFile_ST4，否则会报 TypeError: expected string or bytes-like object 或快捷键无响应。
为什么 Package Control 安装的 AdvancedNewFile 在 ST4 上失效
原作者已停止维护，Sublime Text 4 的 API 变动（尤其是 view.window() 返回值、路径解析逻辑和命令执行机制）导致老版本崩溃。常见现象包括：
- 按下
Ctrl+Alt+N（Windows/Linux）或Cmd+Alt+N（macOS）后无反应 - 控制台报错
TypeError: expected string or bytes-like object - 输入路径后提示 “Path does not exist”，但目录实际存在
Package Control 搜索 “AdvancedNewFile” 默认返回的是已下架的老版本（作者 skuroda），不是 ST4 兼容版。
正确安装 AdvancedNewFile_ST4 的步骤
必须跳过 Package Control，手动安装社区维护分支 rbharrin/AdvancedNewFile_ST4：
- 关闭 Sublime Text
- 进入插件目录：
• macOS：~/Library/Application Support/Sublime Text/Packages/
• Windows：%APPDATA%\Sublime Text\Packages\
• Linux：~/.config/sublime-text/Packages/ - 克隆仓库：
git clone --depth 1 https://github.com/rbharrin/AdvancedNewFile_ST4.git AdvancedNewFile（注意目录名必须是AdvancedNewFile） - 重启 Sublime Text
- 按
Ctrl+Shift+P输入AdvancedNewFile: Create File，确认命令可触发
路径输入必须遵守的三条铁律
插件对路径格式极其敏感，错一个字符就建错位置甚至失败：
- 一律用正斜杠
/分隔路径，Windows 下也别用\—— 输入src\utils\index.js会被当作文本文件名，真实创建一个叫src\utils\index.js的怪文件 - 不加
/开头 = 相对于当前打开的文件所在目录；加/开头 = 相对于项目根目录（前提是已通过File → Open Folder…加载项目，且该目录出现在侧边栏） - 路径中含空格或中文时，必须用英文双引号包裹，如
"my plugin/index.js"；不推荐用单引号或中文引号
默认自动建目录，但有个致命前提
AdvancedNewFile_ST4 默认开启 create_intermediate_directories，输入 src/api/v1/users.js 会逐级创建 src/ → src/api/ → src/api/v1/ 再写入文件。但这只在以下条件下生效：
- Sublime 必须已加载一个项目文件夹（即侧边栏顶部显示的是你项目的根目录）
- 如果只是用
subl some-file.js打开单个文件，插件无法推断根路径，会静默失败或 fallback 到$HOME - 中间目录若因权限不足（如 NFS、Docker volume、杀毒软件拦截）无法创建，插件不会提示具体哪一级失败，只会卡住或报 “Permission denied”
最常被忽略的一点：插件不检查 .gitignore，node_modules/foo.js 照样能建，不会警告——你得自己负责别手滑输错路径。
