26 lines
1.5 KiB
Markdown
26 lines
1.5 KiB
Markdown
|
# 本人目录文件规范（防 IDE「Unable to open / Assertion Failed」）
|
|||
|
|
|
|||
|
|
> 编辑 `个人/1、卡若：本人/` 下任何文件时须遵守，避免 Cursor/VS Code 出现「Unable to open 'xxx.md'」「Assertion Failed: Argument is undefined or null」。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、必须遵守
|
|||
|
|
|
|||
|
|
1. **路径**：本目录内互相引用一律用**相对路径**（如 `记忆.md`、`01_自我与性格.md`），不在正文写绝对路径（如 `/Users/karuo/...`），避免多工作区下解析为 null。
|
|||
|
|
2. **编码与换行**：文件保存为 **UTF-8 无 BOM**，换行符 **LF**；**文件末尾保留一个换行符**。
|
|||
|
|
3. **链接**：避免使用 `[[文件名]]` 等 wikilink，改用普通文本或 `文件名.md`；不写可能指向已删除文件的链接。
|
|||
|
|
4. **重命名/删除后**：若在本目录做了重命名或删除（如 05 合并进 00），提示用户 **Reload Window**（命令面板 `Developer: Reload Window`）或关闭后重新从左侧资源管理器打开文件，以刷新 IDE 状态。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、出现报错时的处理
|
|||
|
|
|
|||
|
|
- 单文件报错：检查该文件是否末尾无换行、是否含绝对路径或 `[[...]]`，修正后保存；让用户关闭该标签页后重新从树状图打开。
|
|||
|
|
- 多文件或整目录报错：按上一条规范检查并修正所有 md；提醒用户执行 Reload Window。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、与记忆路径的关系
|
|||
|
|
|
|||
|
|
- 记忆**读取/写入**仍以规则中约定的唯一路径为准；本规范约束的是**写在文件内容里的路径表述**，避免 IDE 解析时拿到 undefined/null。
|