fcdev 6502 开发

6502 兼容机（NES、小霸王学习机等）开发的 VS Code 扩展，配合 fcdev 命令行使用。目前提供 ca65 汇编的语法高亮与智能感知。

功能

.s、.asm、.inc 文件按 ca65 语法着色：6502 指令、汇编指令、标签、常量、数字、字符串与注释。C 文件用 VS Code 内置的 C 语法。

打开 .s、.asm、.inc 文件时：

.include 的文件先按当前文件所在目录查找，再按 fcdev info 给出的汇编引入目录查找，所以目标自带的符号（如 SB2000 的 sb2000.inc）可以直接看到。

扩展自动运行 fcdev sync，生成 .vscode/c_cpp_properties.json 与 compile_flags.txt，让 C/C++ 扩展或 clangd 找到 cc65 的头文件与预定义宏，头文件里的文档注释会在悬停时显示。

安装本扩展时会一并安装 C/C++ 扩展（ms-vscode.cpptools），提供 C 的补全、悬停与转到定义；改用 clangd 时可卸载它。

触发时机：打开含 fcdev.json 的工作区、fcdev.json 变化。也可以手动运行命令“fcdev：同步 C/C++ 智能感知配置”。

C/C++ 扩展用哪个配置要在状态栏里选。.vscode/c_cpp_properties.json 里除 fcdev 外还有其他配置时，同步后会提示你选择 fcdev，点“选择配置”即可打开选择列表。

项目里已安装 fcdev（npm install），扩展经项目里的 node_modules/fcdev 运行命令，不依赖全局安装。没有安装时，汇编智能感知只用当前文件与工作区里的源码，原因写在“输出”面板的 fcdev 通道。

设置	默认值	说明
`fcdev.intelliSense.autoSync`	`true`	打开项目、修改 `fcdev.json` 时自动运行 `fcdev sync`
`fcdev.intelliSense.promptConfigurationSelection`	`true`	同步后，配置文件里还有其他配置时提示选择 `fcdev` 配置

npm install
npm run check      # 类型检查、oxlint、测试、构建
npm run package    # 生成 .vsix

按 F5 可以在扩展开发宿主里调试。设计与目录说明见仓库根目录 docs/12-VS Code扩展.md。

Apache-2.0