# 记事本

**Repository Path**: hhh917/Notes

## Basic Information

- **Project Name**: 记事本
- **Description**: 通过nodejs与vue3实现PC端记事本功能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-28
- **Last Updated**: 2026-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 协作记事本

## 环境要求

- 建议使用 Node.js `16.18.x`
- npm 建议使用 Node `16.18.x` 自带版本，或与之兼容的 npm 8

## 这次兼容性收尾包含的内容

- `web` 构建链已回退到更适合 Node `16.18` 的稳定组合：`vite 4`、`@vitejs/plugin-vue 4`、`typescript 5.4`、`vue-tsc 1.8`
- `server` 已从 `better-sqlite3` 切换到纯 JS / WASM 的 SQLite 方案，不再依赖 Windows 本地 C++ 编译工具
- 后端依然保留 SQLite 本地文件落盘能力，默认数据库文件位于 `server/data/notebook.sqlite`

## 安装

首次安装：

```bash
npm run install:all
```

说明：

- 根目录安装脚本会先安装根依赖，再分别进入 `server` 与 `web` 目录执行安装。
- 之所以不再使用 `npm install --prefix server`，是因为当前这套 Windows + Node `16.18.0` + npm `8.19.2` 组合下，`server` 目录存在被错误写回 `file:..` 依赖声明的现象；改成进入子目录直接安装后，该问题已消失。
- 如果只需要安装后端，优先使用根目录命令 `npm run install:server`，或者直接进入 `server` 目录执行 `npm install`。

如果仓库之前已经在其他 Node 主版本下安装过依赖，建议先清理旧依赖后再重装：

```bash
Remove-Item -Recurse -Force .\node_modules, .\web\node_modules, .\server\node_modules
npm run install:all
```

## 常用命令

开发联调：

```bash
npm run dev
```

Windows 一键拉起前后端（分别打开两个日志窗口）：

```bash
npm run dev:quick
```

如果想先确认脚本会执行什么命令，而不真正启动服务，可以使用：

```bash
npm run dev:quick:dry-run
```

前端默认开发地址：

```text
http://127.0.0.1:7000/
```

后端默认开发地址：

```text
http://127.0.0.1:8000/
```

仅启动前端：

```bash
npm run dev:web
```

仅启动后端：

```bash
npm run dev:server
```

仅安装后端依赖：

```bash
npm run install:server
```

前端构建：

```bash
npm run build
```