wps-jsa-macro

WPS 宏生成器

生成 WPS Office JSA（JavaScript for Applications） 宏脚本。

核心原则：WPS 宏 ≠ VBA。WPS 使用 JavaScript 语法，API 虽与 VBA 相似但有重要差异。 绝对不要输出 VBA 代码。

When to Use

• 用户需要在WPS中自动化重复操作
• 用户说"帮我写一个WPS宏"
• 用户需要批量处理WPS文档/表格/演示
• 用户需要在WPS表格中自动填充、计算、格式化
• 用户提到JSA、WPS脚本

When NOT to Use

• 用户明确说 Excel VBA → 提醒用户WPS不支持VBA，询问是否需要JSA版本
• 用户需要生成独立文档 → 使用 docx-writer
• 用户需要公文排版 → 使用 wps-gongwen
• 需要的是 WPS 加载项（Add-in）开发 → 这是另一个话题

JSA vs VBA 关键差异

必须牢记这些差异，避免生成错误代码：

特性	VBA	WPS JSA
语言	Visual Basic	JavaScript
变量声明	Dim x As Integer	var x = 0 或 let x = 0
函数定义	Sub / Function	function name()
字符串连接	&	+
注释	' 单引号	// 或 /* */
数组索引	从1开始	从0开始（但集合类从1开始）
无返回值过程	Sub	function（无区分）
For Each	For Each x In col	for (var i = 1; i <= col.Count; i++)
错误处理	On Error	try...catch
对象判空	If obj Is Nothing	if (obj == null || obj == undefined)
类型转换	CInt(), CStr()	parseInt(), String()
布尔值	True / False	true / false
结束语句	End Sub / End If	}
Set关键字	Set obj = ...	不需要，直接 var obj = ...

JSA 核心 API 速查

全局对象

// 应用对象
Application              // WPS应用实例
Application.ActiveDocument  // 当前活动文档（文字）
Application.ActiveWorkbook  // 当前活动工作簿（表格）
Application.ActivePresentation // 当前活动演示

// 控制台输出（调试用）
Console.log("message")   // WPS宏编辑器控制台

// 对话框
Application.alert("消息")  // 类似 MsgBox

WPS 文字（Writer）

// 文档操作
var doc = Application.ActiveDocument
var docs = Application.Documents
docs.Open("/path/to/file.docx")
docs.Add()  // 新建文档

// 内容操作
var range = doc.Content           // 全文范围
var paras = doc.Paragraphs        // 段落集合
var para = doc.Paragraphs.Item(1) // 第1段（从1开始）
para.Range.Text                   // 段落文本
para.Range.Font.Name = "宋体"
para.Range.Font.Size = 12
para.Range.Font.Bold = true

// 查找替换
var find = doc.Content.Find
find.Text = "旧文本"
find.Replacement.Text = "新文本"
find.Execute(undefined, undefined, undefined, undefined, undefined,
             undefined, undefined, undefined, undefined, undefined, 2)
// 最后参数 2 = wdReplaceAll

// 表格
var table = doc.Tables.Item(1)
table.Cell(1, 1).Range.Text     // 第1行第1列
table.Rows.Count                // 行数
table.Columns.Count             // 列数

// 书签
var bm = doc.Bookmarks.Item("书签名")
bm.Range.Text = "填入内容"

// 保存
doc.Save()
doc.SaveAs("/path/to/new.docx")